Salesforce Email Studio OAuth2 (ExactTarget) コネクタ構成ガイド

前提条件

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

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

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

1. ExactTargetアカウントにログインし、右上のメニューから構成を選択します。
2. プラットフォームツール > アプリ > インストール済みパッケージに移動します。
3. インストール済みパッケージパネルの右上で、新規をクリックして新しいパッケージを作成します。
4. 開いたダイアログボックスでパッケージに名前を付け、保存をクリックします。
5. 新しく作成したパッケージで、コンポーネントを追加をクリックします。
6. コンポーネントタイプとしてAPIインテグレーション、インテグレーションタイプとしてサーバー間を選択します。
7. 適切なサーバー間のプロパティを構成します。
   適切な権限が提供されていない場合、インテグレーションが失敗する可能性があります。パッケージが作成された後に権限を変更すると、権限が適用されるまでの待ち時間が必要になる場合があります。
8. コンポーネントを保存します。
   パッケージウィンドウでは、APIインテグレーションという名前のコンポーネントが認証情報を表示します。
9. 以下の値をコネクタ構成で後で使用するためにコピーします：

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

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

コネクタアクション

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

構成を構成する

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタの追加方法については、コネクタ概要の記事を参照してください。

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

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

• マーケットクラウドアプリクライアントID

  • 必須。
  • アプリクライアントIDを提供します。
  • 参照：OAuthクライアント資格情報の取得

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

  • 必須。
  • アプリクライアントシークレットを提供します。

• アカウントID

  • 必須。
  • ターゲットビジネスユニットのアカウント識別子（MID）を提供します。

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

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

• ExactTargetアカウントID (MID)

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

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

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

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

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

パラメータ

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

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

パラメータ

パラメータ	説明
ビジネスユニット	推奨。 適切なビジネスユニットを選択します。 指定されていない場合は、デフォルトのオプションが使用されます。これは、構成されたマーケティングクラウドユーザーのデフォルトのビジネスユニットに対応します。
メールリスト	必須。 メールリストを選択します。
キーによる購読者の検索	必須。 既存の購読者を見つけるための購読者キーを提供します。
非同期処理の有効化	オプション。 非同期処理を有効にするオプションをチェックします。 API呼び出しは、API呼び出しが受信された時点ではなく、処理される前にキューに入れられます。 非同期API呼び出しは一般的に完了までの時間が短く、常に成功したレスポンスを返します。これは、後の段階で基礎となるキュー操作が失敗した場合でもです。 詳細については、こちらを参照してください：非同期処理。

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

パラメータ

パラメータ	説明
ビジネスユニット	推奨。 適切なビジネスユニットを選択します。 指定されていない場合は、デフォルトのオプションが使用されます。これは、構成されたマーケティングクラウドユーザーのデフォルトのビジネスユニットに対応します。
メールリスト	必須。 メールリストを選択します。
キーによる加入者検索	必須。 既存の加入者を見つけるための加入者キーを提供してください。
非同期処理の有効化	オプション。 非同期処理を有効にするためのオプションをチェックしてください。 API呼び出しは、受信時ではなく、処理される前にキューに入れられます。 非同期API呼び出しは一般的に完了までの時間が短く、常に成功したレスポンスを返します。たとえ後でキューに入れられた操作が失敗したとしても。 詳細については、非同期処理を参照してください。

アクション - 加入者のアップサートとメールリストへの追加

パラメータ

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

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

バッチ制限

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

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

パラメータ

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

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

バッチ制限

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

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

パラメータ

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

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

バッチ制限

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

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

パラメータ

パラメータ	説明
ビジネスユニット	推奨。 適切なビジネスユニットを選択します。 指定されていない場合は、デフォルトのオプションが使用されます。これは、構成されたマーケティングクラウドユーザーのデフォルトのビジネスユニットに対応します。
データ拡張	必須。 データ拡張を選択します。
レコード検索	必須。 既存のレコードを削除するためのレコードファイルに値をマップします。
非同期処理の有効化	オプション。 非同期処理を有効にするためのオプションをチェックします。 API呼び出しは、受信時ではなく、処理される前にキューに入れられます。 非同期API呼び出しは一般的に完了までの時間が短く、基礎となるキュー操作が後で失敗したとしても常に成功したレスポンスを返します。 詳細については、次を参照してください：非同期処理。

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

バッチ制限

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

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

パラメータ

パラメータ	説明
ビジネスユニット	推奨。 適切なビジネスユニットを選択します。 指定されていない場合は、デフォルトのオプションが使用されます。これは、構成されたマーケティングクラウドユーザーのデフォルトのビジネスユニットに対応します。
データ拡張	必須。 データ拡張を選択します。
レコード検索	必須。 既存のレコードを更新するためのレコードフィールドに値をマップします。
非同期処理の有効化	オプション。 非同期処理を有効にするためのオプションをチェックします。 API呼び出しは、受信時ではなく、処理される前にキューに入れられます。 非同期API呼び出しは一般的に完了までの時間が短く、基礎となるキュー操作が後で失敗したとしても常に成功したレスポンスを返します。 詳細については、次を参照してください：非同期処理。

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

バッチ制限

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

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

パラメータ

パラメータ	説明
ビジネスユニット	推奨。 適切なビジネスユニットを選択します。 指定されていない場合は、デフォルトのオプションが使用されます。これは、構成されたマーケティングクラウドユーザーのデフォルトのビジネスユニットに対応します。
データ拡張	必須。 データ拡張を選択します。
レコード検索	必須。 既存のレコードを更新するためのレコードフィールドに値をマップします。
非同期処理を有効にする	オプションです。 非同期処理を有効にするためのオプションをチェックします。 API呼び出しは、受信時ではなく、キューに入れられてから処理されます。 非同期API呼び出しは一般的に完了までの時間が短く、基礎となるキュー操作が後で失敗したとしても常に成功したレスポンスを返します。 詳細については、次を参照してください：非同期処理。

ベンダーのドキュメンテーション

• Salesforce Marketing Cloud：Enhanced PackagesでOAuth 2.0 API統合を作成する
• Salesforce Marketing Cloud：API統合
• Salesforce Marketing Cloud：SOAP API呼び出しを認証する