Salesforce Email Studio（旧ExactTarget）コネクタ構成ガイド（非推奨）AudienceStream用

このコネクタは現在非推奨となっており、コネクタマーケットプレイスではもう利用できません。現行のコネクタについては、Salesforce Email Studio OAuth2をご覧ください。

前提条件

Salesforce Email Studio（ExactTarget）コネクタを構成するために必要な項目は以下の通りです：

ユーザー名
- ExactTargetマーケティングクラウドのユーザー名を入力してください。
- 詳細については、次のExactTarget開発者ドキュメントを参照してください：SOAP Web Services APIでの開始。
パスワード
- ExactTargetマーケティングクラウドのパスワード。
サーバーホスト名
- （必須）ExactTargetマーケティングクラウドのサーバーホスト名を入力してください。
- サーバーホスト名がわからない場合は、ExactTargetマーケティングクラウドの担当者に連絡してください。
- サーバーホストを入力する際、プロトコルとパスは含めないでください。例えば、webservice.exacttarget.comのみを入力してください。
IPホワイトリスティング
- （オプション）ExactTargetマーケティングクラウドでホワイトリスティングが有効になっている場合、システムを構成してIPアドレスをホワイトリストに登録してください。
- これは通常のデフォルト構成です。

コネクタ構成要件

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

詳細については、SOAP Web Services APIでの開始のユーザー名トークンでの認証を参照してください。

コネクタを構成するために必要な認証情報は以下の通りです：

ExactTargetマーケティングクラウドアカウントにアクセスするためのユーザー名とパスワード
サーバーホスト名、例：http://webservice.s10.exacttarget.com/

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

アクション名	アクション	オーディエンスにトリガー	イベントにトリガー
ユーザーへのメール送信	サブスクライバーにメールをトリガーします	✓	✗
メールリストへの追加	サブスクライバーをメールリストに追加します	✓	✗
メールリストからの削除	メールリストからサブスクライバーを削除します	✓	✗
サブスクライバーのアップサートとメールリストへの追加	サブスクライバーをメールリストに追加し、既存のプロファイル属性にデータを送信します	✓	✗
データ拡張機能 - レコード追加	データ拡張機能に新しいレコードを挿入します	✓	✗
データ拡張機能 - 複数レコード追加	データ拡張機能に複数のレコードを挿入します	✓	✗
データ拡張機能 - レコード削除	データ拡張機能から既存のレコードを削除します	✓	✗
データ拡張機能 - レコード更新	データ拡張機能の既存のレコードを更新します	✓	✗
データ拡張機能 - レコードアップサート	既存のレコードを更新し、データ拡張機能に新しいレコードを挿入します	✓	✗

構成の構成

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

ベンダーを構成するには、

構成タブで説明的なタイトルを入力します。
ExactTargetマーケティングクラウドアカウントのユーザー名、パスワード、ホスト名を入力します。

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

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

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

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

アクション：ユーザーへのメール送信

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

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

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

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

パラメータ	説明
ビジネスユニット	推奨。このアクションインスタンスに使用するビジネスユニットを選択します。確信がない場合は、デフォルトオプションを選択します。指定されていない場合は、構成されたマーケティングクラウドユーザーのデフォルトビジネスユニットに対応するDEFAULTオプションが使用されます。
メールリスト	（必須）購読者を追加するメールリストを選択します。特定のリストまたはマスターの`All Subscribers`リストを選択できます。
購読者キーによる検索	（必須）メール受信者など、購読者を一意に識別する属性の値を選択します。キーによって既存の購読者を検索してメールを送信します。詳細については、購読者キーとは何か？を参照してください。 ExactTargetは、購読者キーとしてメールアドレスの使用に反対しています。
非同期処理	非同期処理をサポートしており、デフォルトでは無効です。このオプションを有効にして、大量のデータ処理を管理します。非同期処理を有効にするオプションをチェックします。 API呼び出しは受信時に直接処理されるのではなく、キューに入れられてから処理されます。非同期API呼び出しは通常、完了が速く、後でキューの操作が失敗しても常に成功した応答を返します。詳細については、非同期処理を参照してください。

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

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

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

アクション：購読者をアップサートしてメールリストに追加する

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

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

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

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

バッチ制限

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

リクエストの最大数：1000
最古のリクエストからの最大時間：10分
リクエストの最大サイズ：1 MB

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

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

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

バッチ制限

リクエストの最大数：1000
最古のリクエストからの最大時間：10分
リクエストの最大サイズ：1 MB

パラメータ	説明
ビジネスユニット	推奨。このアクションインスタンスに使用するビジネスユニットを選択します。不明な場合は、デフォルトオプションを選択します。指定されていない場合は、構成されたマーケティングクラウドユーザーのデフォルトビジネスユニットに対応するDEFAULTオプションが使用されます。
データ拡張	（必須）複数のレコードを追加するデータ拡張を選択します。
レコードフィールド	（必須）複数のデータ拡張レコードを追加するために、配列型属性をマッピングします。配列型属性は同じ長さでなければなりません。単一値属性を使用でき、各レコードに適用されます。
非同期処理	非同期処理をサポートし、デフォルトでは無効です。大量のデータ処理を管理するためにこのオプションを有効にします。非同期処理を有効にするオプションをチェックします。 API呼び出しは、受信時に直接処理されるのではなく、処理される前にキューに入れられます。非同期API呼び出しは通常、完了が早く、後の時点でキューに入れられた操作が失敗しても常に成功した応答を返します。詳細については、非同期処理を参照してください。

アクション：データ拡張 - レコード削除

このセクションでは、データ拡張 - レコード削除アクションの具体的なパラメータと利用可能なオプションについて説明します。

バッチ制限

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

パラメータ	説明
ビジネスユニット	推奨。このアクションインスタンスに使用するビジネスユニットを選択します。不明な場合は、デフォルトオプションを選択します。指定されていない場合は、構成されたマーケティングクラウドユーザーのデフォルトビジネスユニットに対応するDEFAULTオプションが使用されます。
データ拡張	（必須）レコードを削除する場所のデータ拡張を選択します。
レコード検索	（必須）既存のレコードを削除するために、レコードフィールドに値をマッピングします。少なくとも1つのプライマリキーをマッピングしてください。そうでないと削除アクションが失敗します。デフォルトでは、To ドロップダウンリストにはプライマリキーと必須キーカラムのみが表示されます。さらにプライマリキーをマッピングするには、プラス記号（+）をクリックしてカラム名を入力します。
非同期処理	非同期処理をサポートしており、デフォルトでは無効です。大量のデータ処理を管理するためにこのオプションを有効にします。非同期処理を有効にするオプションをチェックします。 API呼び出しは処理される前にキューに入れられ、API呼び出しが受信された時点で直接処理されるわけではありません。非同期API呼び出しは通常、完了が早く、後でキュー操作が失敗しても常に成功した応答を返します。詳細については、非同期処理を参照してください。

アクション：データ拡張 - レコード更新

このセクションでは、データ拡張 - レコード更新アクションの具体的なパラメータと利用可能なオプションについて説明します。このアクションは既存のレコードのみを更新し、新しいレコードは挿入しません。

バッチ制限

リクエストの最大数：1000
最古のリクエストからの最大時間：10分
リクエストの最大サイズ：1 MB

パラメータ	説明
ビジネスユニット	推奨。このアクションインスタンスに使用するビジネスユニットを選択します。不明な場合は、デフォルトオプションを選択します。指定されていない場合は、構成されたマーケティングクラウドユーザーのデフォルトビジネスユニットに対応するDEFAULTオプションが使用されます。
データ拡張	(必須) レコードを更新するためのデータ拡張を選択します。
データ拡張	(必須) 既存のレコードを更新するためにレコードフィールドにマッピングする値を構成します。
レコード検索	(必須) 既存のレコードを更新するためにレコードフィールドにマッピングする値を構成します。少なくとも1つのプライマリキーをマッピングしないと、更新アクションが失敗します。デフォルトでは、To ドロップダウンリストにはプライマリキーと必須キーのカラムのみが表示されます。さらにプライマリキーをマッピングするには、プラス記号 (+) をクリックしてカラム名を入力します。
非同期処理	非同期処理をサポートしており、デフォルトでは無効になっています。大量のデータ処理を管理するためにこのオプションを有効にします。非同期処理を有効にするオプションをチェックします。 API呼び出しは処理される前にキューに入れられ、API呼び出しが受信された時点で直接処理されるのではありません。非同期API呼び出しは通常、完了が早く、後の時点でキューに入れられた操作が失敗しても常に成功したレスポンスを返します。詳細については、非同期処理を参照してください。

アクション：データ拡張 - レコードのアップサート

このセクションでは、データ拡張 - レコードのアップサートアクションについての具体的なパラメータと利用可能なオプションについて説明します。このアクションを使用すると、既存のレコードを更新し、新しいレコードを挿入できます。

バッチ制限

リクエストの最大数：1000
最古のリクエストからの最大時間：10分
リクエストの最大サイズ：1 MB

パラメータ	説明
ビジネスユニット	推奨。このアクションインスタンスに使用するビジネスユニットを選択します。不明な場合は、デフォルトオプションを選択します。指定されていない場合は、構成されたマーケティングクラウドユーザーのデフォルトビジネスユニットに対応するDEFAULTオプションが使用されます。
データ拡張	（必須）既存のレコードを更新するためにデータ拡張を選択します。
レコード検索	（必須）既存のレコードを更新するためにレコードフィールドに値をマッピングします。アップサートアクションが失敗しないように、少なくとも1つのプライマリキーをマッピングしてください。デフォルトでは、To ドロップダウンリストにはプライマリキーと必須キーカラムのみが表示されます。さらにプライマリキーをマッピングするには、プラス記号（+）をクリックしてカラム名を入力します。
レコード追加	（オプション）データ拡張に存在しない新しいレコードを追加するためにフィールドに値をマッピングします。
レコード更新	（オプション）データ拡張の既存のレコードを更新するためにフィールドに値をマッピングします。
非同期処理	非同期処理をサポートし、デフォルトでは無効になっています。大量のデータ処理を管理するためにこのオプションを有効にします。非同期処理を有効にするオプションをチェックします。 API呼び出しは処理される前にキューに入れられ、API呼び出しが受信された時点で直接処理されるわけではありません。非同期API呼び出しは通常、完了までの時間が短く、後の時点でキューに入れられた操作が失敗しても常に成功した応答を返します。詳細については、非同期処理を参照してください。

ベンダー文書

追加情報については、以下のベンダー文書を参照してください：