Salesforce Email Studio OAuth2（ExactTarget）コネクタの構成ガイド

前提条件

• Salesforce Marketing Cloudアカウント
• Salesforce Marketing Cloudアプリのクライアント資格情報
• Salesforce Marketing Cloudアプリに適切な権限が構成されていること

OAuth2認証スキームを使用して接続する

次の手順を使用して、OAuth2認証スキームを使用してTealiumをExactTargetに接続します。

1. ExactTargetアカウントにログインし、右上のメニューからセットアップを選択します。
2. Platform Tools > Apps > Installed Packagesに移動します。
3. Installed Packagesパネルの右上にあるNewをクリックして新しいパッケージを作成します。
4. 開いたダイアログボックスでパッケージの名前を入力し、Saveをクリックします。
5. 新しく作成したパッケージでAdd Componentをクリックします。
6. コンポーネントタイプとしてAPI Integrationを選択し、統合タイプとしてServer-to-Serverを選択します。
7. 適切なServer-to-Serverプロパティを構成します。
   正しい権限が提供されていない場合、統合が失敗する可能性があります。パッケージが作成された後に権限を変更する場合は、権限が適用されるまで待つ必要がある場合があります。
8. コンポーネントを保存します。
   パッケージウィンドウでは、API Integrationという名前のコンポーネントに認証情報が表示されます。
9. コネクタの構成で後で使用するために、以下の値をコピーします：

• クライアントID
• クライアントシークレット
• SOAPベースURI

1. また、トップメニューバーにあるアカウントのMID値もコピーします。

コネクタのアクション

アクション名	AudienceStream	EventStream
ユーザーにメールを送信	✓	✓
メールリストに追加	✓	✓
メールリストから削除	✓	✓
サブスクライバーを更新し、メールリストに追加	✓	✓
データ拡張 - レコードの追加	✓	✓
データ拡張 - 複数のレコードを追加	✓	✓
データ拡張 - レコードの削除	✓	✓
データ拡張 - レコードの更新	✓	✓
データ拡張 - レコードの追加または更新	✓	✓

構成の構成

コネクタマーケットプレイスに移動して、新しいコネクタを追加します。コネクタの追加方法の一般的な手順については、コネクタの概要の記事を読んでください。

コネクタを追加した後、次の構成を構成します：

このコネクタは、ExactTargetのSOAPプロトコルに接続するために次の情報が必要です。OAuth2認証スキームでアップグレードされています。

• Market CloudアプリのクライアントID

  • 必須です。
  • アプリのクライアントIDを指定してください。
  • 参照：OAuthクライアント資格情報の取得

• クライアントシークレット：

  • 必須です。
  • アプリのクライアントシークレットを指定してください。

• アカウントID

  • 必須です。
  • ターゲットビジネスユニットのアカウント識別子（MID）を指定してください。

• テナント固有のサブドメイン

  • 必須です：
  • アプリケーションのテナント固有のサブドメインを指定してください。
  • SOAPベースURLが次のようになっている場合： https://mctg-xxxxxx.soap.marketingcloudapis.com/、このURLの2つのスラッシュと最初のピリオドの間の部分を指定します。この例では、mctg-xxxxxxです。
  • コネクタは、このサブドメイン名に正しい接尾辞を自動的に追加します。

• ExactTargetアカウントID（MID）

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

次へをクリックするか、アクションタブに移動します。ここでは、コネクタのアクションを構成します。

詳細なアクションの構成については、Salesforce Marketing Cloud Email Studioを参照してください。

このセクションでは、各アクションのパラメータとオプションの構成方法について説明します。

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

パラメータ

パラメータ	説明
ビジネスユニット	推奨されます。 適切なビジネスユニットを選択します。 指定されていない場合、デフォルトのオプションが使用され、構成されたMarketing Cloudユーザーのデフォルトビジネスユニットに対応します。
トリガーされた送信メールインタラクション	必須です。 トリガーされた送信メールインタラクションを選択します。
キーによるサブスクライバーの検索	必須です。 メールを送信するために既存のサブスクライバーをキーで検索します。
サブスクライバーの検索を無効にする	検索を無効にするには、サブスクライバーの検索を無効にするをチェックし、“ubscriber Emailセクションを構成します。
サブスクライバーのメール	メッセージを送信するためのメールを指定します（サブスクライバーの検索が無効になっている場合は必須）。 メールを空白のままにすると、検索されたサブスクライバーのメールが使用されます。
追加または上書きする属性	キーに値をマップして、メール内に動的なコンテンツを含めるためのサンプル入力を参照してください：送信時にトリガーされた送信メッセージにコンテンツを渡す。 プロファイル属性を管理するには、プロファイルと構成属性を参照してください。
次のステータスを持つサブスクライバーにメールを送信しない	検索されたサブスクライバーが次のステータスのいずれかを持っている場合、メールを送信しないでください。
非同期処理を有効にする	非同期処理を有効にするオプションをチェックします。API呼び出しは、API呼び出しが受信された時点で直接処理されるのではなく、処理される前にキューに入れられます。 非同期API呼び出しは通常、完了までの時間が短く、後でキューに入れられた操作が失敗した場合でも常に成功した応答を返します。 詳細については、非同期処理を参照してください。

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

パラメータ

パラメータ	説明
ビジネスユニット	推奨されます。 適切なビジネスユニットを選択します。 指定されていない場合、デフォルトのオプションが使用され、構成されたMarketing Cloudユーザーのデフォルトビジネスユニットに対応します。
メールリスト	必須です。 メールリストを選択します。
キーによるサブスクライバーの検索	必須です。 既存のサブスクライバーを検索するためのサブスクライバーキーを指定します。
非同期処理を有効にする	オプションです。 非同期処理を有効にするオプションをチェックします。 API呼び出しは、API呼び出しが受信された時点で直接処理されるのではなく、処理される前にキューに入れられます。 非同期API呼び出しは通常、完了までの時間が短く、後でキューに入れられた操作が失敗した場合でも常に成功した応答を返します。 詳細については、非同期処理を参照してください。

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

パラメータ

パラメータ	説明
ビジネスユニット	推奨されます。 適切なビジネスユニットを選択します。 指定されていない場合、デフォルトのオプションが使用され、構成されたMarketing Cloudユーザーのデフォルトビジネスユニットに対応します。
メールリスト	必須です。 メールリストを選択します。
キーによるサブスクライバーの検索	必須です。 既存のサブスクライバーを検索するためのサブスクライバーキーを指定します。
非同期処理を有効にする	オプションです。 非同期処理を有効にするオプションをチェックします。 API呼び出しは、API呼び出しが受信された時点で直接処理されるのではなく、処理される前にキューに入れられます。 非同期API呼び出しは通常、完了までの時間が短く、後でキューに入れられた操作が失敗した場合でも常に成功した応答を返します。 詳細については、非同期処理を参照してください。

アクション - サブスクライバーを更新し、メールリストに追加

パラメータ

パラメータ	説明
ビジネスユニット	推奨されます。 適切なビジネスユニットを選択します。 指定されていない場合、デフォルトのオプションが使用され、構成されたMarketing Cloudユーザーのデフォルトビジネスユニットに対応します。
サブスクライバーキー	必須です。
サブスクライバーのメールアドレス	必須です。
メールリストにサブスクライバーを追加する	オプションです。 1つ以上のメールリストを選択して、サブスクライバーを追加します。
ユーザーステータス	オプションです。 ユーザーのステータスを更新する値を選択します。
非同期処理を有効にする	オプションです。 非同期処理を有効にするオプションをチェックします。 API呼び出しは、API呼び出しが受信された時点で直接処理されるのではなく、処理される前にキューに入れられます。 非同期API呼び出しは通常、完了までの時間が短く、後でキューに入れられた操作が失敗した場合でも常に成功した応答を返します。 詳細については、非同期処理を参照してください。

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

バッチ制限

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

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

パラメータ

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

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

バッチ制限

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

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

パラメータ

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

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

バッチ制限

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

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

パラメータ

パラメータ	説明
ビジネスユニット	推奨されます。 適切なビジネスユニットを選択します。 指定されていない場合、デフォルトのオプションが使用され、構成されたMarketing Cloudユーザーのデフォルトビジネスユニットに対応します。
データ拡張	必須です。 データ拡張を選択します。