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

パラメータ

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

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

バッチ制限

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

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

パラメータ

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

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

バッチ制限

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

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

パラメータ

パラメータ	説明
ビジネスユニット	推奨。 適切なビジネスユニットを選択します。 指定されていない場合は、デフォルトのオプションが使用されます。これは、構成されたマーケティングクラウドユーザーのデフォルトのビジネスユニットに対応します。
データエクステンション	必須。 データエクステンションを選択します。 データエクステンションのドロップダウンリストは、新しいものから古いものへと表示され、最大2000エントリを表示します。 データエクステンションがドロップダウンリストに表示されていない場合は、Salesforceのデータエクステンション詳細ページからデータエクステンションの外部キーを貼り付け、Enterキーを押してそのデータエクステンションを使用します。
レコードルックアップ	必須。 既存のレコードを削除するために、レコードファイルに値をマップします。
非同期処理の有効化	オプション。 非同期処理を有効にするためのオプションをチェックします。 API呼び出しは処理される前にキューに入れられ、API呼び出しが受け取られた時点では直接処理されません。 非同期API呼び出しは一般的に完了までの時間が短く、常に成功したレスポンスを返します。たとえ、後の段階でキューに入れられた操作が失敗したとしても。 詳細については、次を参照してください：非同期処理。

アクション - データエクステンション - レコード更新

バッチ制限

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

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

パラメータ

パラメータ	説明
ビジネスユニット	推奨。 適切なビジネスユニットを選択します。 指定されていない場合は、デフォルトのオプションが使用されます。これは、構成されたマーケティングクラウドユーザーのデフォルトのビジネスユニットに対応します。
データエクステンション	必須。 データエクステンションを選択します。 データエクステンションのドロップダウンリストは、新しいものから古いものへと表示され、最大2000エントリを表示します。 データエクステンションがドロップダウンリストに表示されていない場合は、Salesforceのデータエクステンション詳細ページからデータエクステンションの外部キーを貼り付け、Enterキーを押してそのデータエクステンションを使用します。
レコードルックアップ	必須。 既存のレコードを更新するために、レコードフィールドに値をマップします。
非同期処理の有効化	オプション。 非同期処理を有効にするためのオプションをチェックします。 API呼び出しは処理される前にキューに入れられ、API呼び出しが受け取られた時点では直接処理されません。 非同期API呼び出しは一般的に完了までの時間が短く、常に成功したレスポンスを返します。たとえ、後の段階でキューに入れられた操作が失敗したとしても。 詳細については、次を参照してください：非同期処理。

アクション - データエクステンション - レコードアップサート

バッチ制限

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

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

パラメータ

パラメータ	説明
ビジネスユニット	推奨。 適切なビジネスユニットを選択してください。 指定されていない場合、DEFAULTオプションが使用されます。これは、構成されたマーケティングクラウドユーザーのデフォルトのビジネスユニットに対応します。
データエクステンション	必須。 データエクステンションを選択してください。 データエクステンションのドロップダウンリストは新しいものから古いものへと表示され、最大2000エントリを表示します。 データエクステンションがドロップダウンリストに表示されていない場合は、Salesforceのデータエクステンション詳細ページからデータエクステンションの外部キーを貼り付け、Enterキーを押してそのデータエクステンションを使用します。
レコードルックアップ	必須。 既存のレコードを更新するために、レコードフィールドに値をマッピングします。
非同期処理の有効化	オプション。 非同期処理を有効にするためのオプションをチェックします。 API呼び出しは、API呼び出しが受信された時点で直接処理されるのではなく、キューに入れられてから処理されます。 非同期API呼び出しは一般的に完了までの時間が短く、基本的には成功したレスポンスを返します。ただし、後の段階でキューに入れられた操作が失敗することもあります。 詳細については、次を参照してください：非同期処理.

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

• Salesforce Marketing Cloud: Enhanced PackagesでのOAuth 2.0 API統合の作成
• Salesforce Marketing Cloud: API統合
• Salesforce Marketing Cloud: SOAP APIコールの認証