Salesforce Email Studio（旧称：ExactTarget）オーディエンスストリーム（レガシー）のコネクタ構成ガイド

これはこのコネクタの旧バージョンです。新しいバージョンはSalesforce Email Studio OAuth2で見つけることができます。

前提条件

Salesforce Email Studio（ExactTarget）コネクタを構成するには、次の項目が必要です。

• ユーザー名

  • ExactTarget Marketing Cloudのユーザー名を入力します。
  • 追加情報については、次のExactTarget Developerドキュメントを参照してください：SOAP WebサービスAPIの使用を開始する。

• パスワード

  • ExactTarget Marketing Cloudのパスワードを入力します。

• サーバーホスト名

  • 必須です。
  • ExactTarget Marketing Cloudのサーバーホスト名を入力します。
  • サーバーホスト名がわからない場合は、ExactTarget Marketing Cloudの担当者に連絡してください。
  • サーバーホストを入力する際には、プロトコルとパスを含めないでください。たとえば、webservice.exacttarget.comのように入力してください。

• IPホワイトリスト

  • オプションです。
  • ExactTarget Marketing Cloudでホワイトリストが有効になっている場合は、システムを構成してIPアドレスをホワイトリストに登録します。
  • これは通常、デフォルトの構成です。

コネクタの構成要件

ExactTarget Marketing Cloud APIには、2つのWebサービス通信プロトコル、Simple Object Access Protocol（SOAP）とRepresentational State Transfer（REST）があります。Tealium Salesforce Email Studio（ExactTarget）コネクタはSOAPを使用します。SOAP呼び出しはアクセストークンまたはユーザー名とパスワードで認証できます。Tealiumコネクタはユーザー名とパスワードの認証方法を使用します。

詳細については、SOAP WebサービスAPIの使用方法を参照してください。

コネクタを構成するためには、次の認証情報が必要です。

• ExactTarget Marketing Cloudアカウントにアクセスするために使用するユーザー名とパスワード
• http://webservice.s10.exacttarget.com/などのサーバーホスト名

サポートされるアクション

アクション名	アクション	オーディエンスでトリガー	イベントでトリガー
ユーザーにメールを送信	購読者にメールを送信する	✓	✗
メールリストに追加	購読者をメールリストに追加	✓	✗
メールリストから削除	メールリストから購読解除者を削除	✓	✗
購読者を追加し、メールリストに追加する	購読者をメールリストに追加し、既存のプロファイル属性にデータを送信する	✓	✗
データ拡張 - レコードの追加	データ拡張に新しいレコードを挿入	✓	✗
データ拡張 - 複数のレコードを追加	データ拡張に複数のレコードを挿入	✓	✗
データ拡張 - レコードの削除	データ拡張から既存のレコードを削除	✓	✗
データ拡張 - レコードの更新	データ拡張の既存のレコードを更新	✓	✗
データ拡張 - レコードの追加または更新	既存のレコードを更新し、新しいレコードをデータ拡張に挿入	✓	✗

構成の構成

コネクタマーケットプレイスに移動し、新しいSalesforce Email Studio（ExactTarget）コネクタを追加します。コネクタを追加する方法の一般的な手順については、コネクタの概要を参照してください。

ベンダーを構成するには、次の手順を実行します。

1. 構成タブで、説明的なタイトルを入力します。
2. ExactTarget Marketing Cloudアカウントのユーザー名、パスワード、およびホスト名を入力します。

ホスト名にはhttpまたはhttpsプロトコルを含めないでください。

1. (オプション) Salesforce Email Studio（ExactTarget）コネクタの構成に関する説明的なメモを提供します。

アクションの構成: パラメータとオプション

次へをクリックするか、アクションタブに移動します。ここから、各アクションを構成し、各アクションをトリガーします。

アクション: ユーザーにメールを送信

このセクションでは、ユーザーにメールを送信するアクションの特定のパラメータと利用可能なオプションについて説明します。

パラメータ	説明
ビジネスユニット	推奨されます。 このアクションインスタンスで使用するビジネスユニットを選択します。 わからない場合は、デフォルトのオプションを選択してください。 指定しない場合は、構成されたMarketing Cloudユーザーのデフォルトビジネスユニットに対応するDEFAULTオプションが使用されます。
トリガーされた送信メールインタラクション	必須です。 ユーザー（または購読者）に送信するトリガーされたメールメッセージを選択します。 探しているメールメッセージが見つからない場合は、上記で選択したビジネスユニットにメッセージが存在するかどうかを確認してください。
キーによる購読者の検索	必須です。 購読者を一意に識別する値（例：メールの受信者）を選択します。 キーで既存の購読者を検索してメールを送信します。 詳細については、購読者キーとは何ですか？を参照してください。Salesforceは、購読者キーとしてメールアドレスを使用しないことを推奨しています。
購読者の検索を無効にする	デフォルトでは、AudienceStreamは購読者キーを検索するための呼び出しを実行します。 購読リストに含まれていないユーザーにリアルタイムのメールを送信する場合は、検索を無効にする必要があります。 このボックスをチェックすると、購読者の検索呼び出しがオフになります。 検索を無効にするには、購読者の検索を無効にするチェックボックスをオンにし、購読者のメールセクションを構成します。
購読者のメール	必須です。 購読者のメールアドレスを格納する属性を選択します。 メッセージを送信するためのメールを指定します。 購読者の検索が無効になっている場合は必須です。 メールを空白のままにしておくと、検索された購読者のメールが使用されます。
追加または上書きする属性	AudienceStreamの属性をExactTargetプロファイル属性にマッピングします。 追加のマッピングを追加するには、プラス記号（+）をクリックします。 キーに値をマッピングして、メール内に動的なコンテンツを含めることができます。サンプル入力については、送信時にトリガー送信メッセージにコンテンツを渡すを参照してください。 プロファイル属性を管理するには、プロファイルと構成属性を参照してください。
ステータスが指定された購読者にメールを送信しない	メールリストから除外する1つ以上の購読者ステータスを選択します。次のリストに示すように、メールリストから除外するステータスを選択します。 アクティブ 購読者ステータスは、bounced、held、unsubscribed、またはdeletedのいずれでもありません。 バウンス 購読者のメールは少なくとも1回はバウンスしました 保留 メールを配信できませんでした 購読解除 ユーザーはもはや購読者ではありません 削除 購読者が特定の購読者リストまたはマスターのすべての購読者リストから削除されました
非同期処理	デフォルトでは非同期処理は無効です。 このオプションを有効にして高容量のデータ処理を管理するために使用します。 非同期処理を有効にするには、オプションをチェックします。 API呼び出しは、API呼び出しが受信された時点ではなく、処理される前にキューに入れられます。 非同期API呼び出しは通常、完了までの時間が短く、後でキューに入れた操作が失敗した場合でも常に成功した応答を返します。 詳細については、非同期処理を参照してください。

アクション: メールリストに追加

このセクションでは、メールリストに購読者を追加するアクションの特定のパラメータと利用可能なオプションについて説明します。

パラメータ	説明
ビジネスユニット	推奨されます。 このアクションインスタンスで使用するビジネスユニットを選択します。 わからない場合は、デフォルトのオプションを選択してください。 指定しない場合は、構成されたMarketing Cloudユーザーのデフォルトビジネスユニットに対応するDEFAULTオプションが使用されます。
メールリスト	必須 購読者を追加するメールリストを選択します。 特定のリストまたはマスターのすべての購読者リストを選択できます。
キーによる購読者の検索	必須です。 購読者を一意に識別する値（例：メールの受信者）を選択します。 キーで既存の購読者を検索してメールを送信します。 詳細については、購読者キーとは何ですか？を参照してください。 ExactTargetは、購読者キーとしてメールアドレスを使用しないことを推奨しています。
非同期処理	デフォルトでは非同期処理は無効です。 このオプションを有効にして高容量のデータ処理を管理するために使用します。 非同期処理を有効にするには、オプションをチェックします。 API呼び出しは、API呼び出しが受信された時点ではなく、処理される前にキューに入れられます。 非同期API呼び出しは通常、完了までの時間が短く、後でキューに入れた操作が失敗した場合でも常に成功した応答を返します。 詳細については、非同期処理を参照してください。

アクション: メールリストから削除

このセクションでは、メールリストから購読解除者を削除するアクションの特定のパラメータと利用可能なオプションについて説明します。

パラメータ	説明
ビジネスユニット	推奨されます。 このアクションインスタンスで使用するビジネスユニットを選択します。 わからない場合は、デフォルトのオプションを選択してください。 指定しない場合は、構成されたMarketing Cloudユーザーのデフォルトビジネスユニットに対応するDEFAULTオプションが使用されます。
メールリスト	必須 購読解除者を削除するメールリストを選択します。 特定のリストまたはマスターのすべての購読者リストを選択できます。
キーによる購読者の検索	必須です。 購読者を一意に識別する値（例：メールの受信者）を選択します。 キーで既存の購読者を検索してメールを送信します。 詳細については、購読者キーとは何ですか？ ExactTargetは、購読者キーとしてメールアドレスを使用しないことを推奨しています。
非同期処理	デフォルトでは非同期処理は無効です。 このオプションを有効にして高容量のデータ処理を管理するために使用します。 非同期処理を有効にするには、オプションをチェックします。 API呼び出しは、API呼び出しが受信された時点ではなく、処理される前にキューに入れられます。 非同期API呼び出しは通常、完了までの時間が短く、後でキューに入れた操作が失敗した場合でも常に成功した応答を返します。 詳細については、非同期処理を参照してください。

アクション: 購読者を追加し、メールリストに追加する

このセクションでは、購読者を追加し、メールリストに追加するアクションの特定のパラメータと利用可能なオプションについて説明します。

パラメータ	説明
ビジネスユニット	推奨されます。 このアクションインスタンスで使用するビジネスユニットを選択します。 わからない場合は、デフォルトのオプションを選択してください。 指定しない場合は、構成されたMarketing Cloudユーザーのデフォルトビジネスユニットに対応するDEFAULTオプションが使用されます。
購読者の検索	必須です。 購読者を一意に識別する値（例：メールの受信者）を選択します。 キーで既存の購読者を検索してメールを送信します。 詳細については、購読者キーとは何ですか？ ExactTargetは、購読者キーとしてメールアドレスを使用しないことを推奨しています。
購読者属性データ	このパラメータはオプションまたは必須です。アカウントの属性によって異なります。 プロファイル属性には、購読者プロファイルを特徴付ける情報が含まれます。 詳細については、プロファイルと構成属性を参照してください。 日付属性はISO 8601形式に変換されます。 例：YYYY-MM-DDThh:mm:ss
メールリストに購読者を追加	必須 購読者を追加するメールリストを選択します。 特定のリストまたはマスターのすべての購読者リストを選択できます。 追加のリストを含めるには、プラス記号（+）をクリックします。
ユーザーステータス	ユーザーのステータスを更新する値を選択します。 利用可能なオプションは次のとおりです: アクティブ 購読者ステータスは、bounced、held、unsubscribed、またはdeletedのいずれでもありません。 保留 メールを配信できませんでした 購読解除 ユーザーはもはや購読者ではありません
非同期処理	デフォルトでは非同期処理は無効です。 このオプションを有効にして高容量のデータ処理を管理するために使用します。 非同期処理を有効にするには、オプションをチェックします。 API呼び出しは、API呼び出しが受信された時点ではなく、処理される前にキューに入れられます。 非同期API呼び出しは通常、完了までの時間が短く、後でキューに入れた操作が失敗した場合でも常に成功した応答を返します。 詳細については、非同期処理を参照してください。

アクション: データ拡張 - レコードの追加

このセクションでは、データ拡張にレコードを追加するアクションの特定のパラメータと利用可能なオプションについて説明します。

バッチ制限

このアクションでは、ベンダーへの高容量データ転送をサポートするためにバッチリクエストが使用されます。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかのしきい値が満たされるか、プロファイルが公開されるまでキューに入れられます。

• 最大リクエスト数：1000
• 最も古いリクエストからの経過時間の最大値：10分
• リクエストの最大サイズ：1MB

パラメータ	説明
ビジネスユニット	推奨されます。 このアクションインスタンスで使用するビジネスユニットを選択します。 わからない場合は、デフォルトのオプションを選択してください。 指定しない場合は、構成されたMarketing Cloudユーザーのデフォルトビジネスユニットに対応するDEFAULTオプションが使用されます。
データ拡張	必須です。 レコードを追加するデータ拡張を選択します。
レコードフィールド	必須です。 データ拡張に新しいレコードを追加するために、フィールドに値をマッピングします。
非同期処理	デフォルトでは非同期処理は無効です。 このオプションを有効にして高容量のデータ処理を管理するために使用します。 非同期処理を有効にするには、オプションをチェックします。 API呼び出しは、API呼び出しが受信された時点ではなく、処理される前にキューに入れられます。 非同期API呼び出しは通常、完了までの時間が短く、後でキューに入れた操作が失敗した場合でも常に成功した応答を返します。 詳細については、非同期処理を参照してください。

アクション: データ拡張 - 複数のレコードを追加

このセクションでは、データ拡張に複数のレコードを追加するアクションの特定のパラメータと利用可能なオプションについて説明します。

バッチ制限

このアクションでは、ベンダーへの高容量データ転送をサポートするためにバッチリクエストが使用されます。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかのしきい値が満たされるか、プロファイルが公開されるまでキューに入れられます。

• 最大リクエスト数：1000
• 最も古いリクエストからの経過時間の最大値：10分
• リクエストの最大サイズ：1MB

パラメータ	説明