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

前提条件

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

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

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

1. ExactTargetアカウントにログインし、右上のメニューから構成を選択します。

2. プラットフォームツール > アプリ > インストール済みパッケージに移動します。

3. インストール済みパッケージパネルの右上にある新規をクリックして新しいパッケージを作成します。

4. 開いたダイアログボックスでパッケージに名前を付けて保存をクリックします。

5. 新しく作成されたパッケージでコンポーネントを追加をクリックします。

6. コンポーネントタイプとしてAPIインテグレーションを選択し、インテグレーションタイプとしてサーバー間を選択します。

7. 適切なサーバー間プロパティを構成します。 インストール済みパッケージを作成すると、それは作成されたビジネスユニットでのみ有効になります。パッケージを追加のビジネスユニットで利用可能にするには：

   1. インストール済みパッケージの構成ページに移動します。
   2. アクセスの下でビジネスユニットを追加を選択します。
   3. パッケージにアクセスが必要な各MID（ビジネスユニット）の横にあるチェックボックスを選択します。

      適切な権限が提供されていない場合、インテグレーションは失敗する可能性があります。パッケージが作成された後に権限を変更すると、権限が適用されるまでに時間がかかることがあります。

8. コンポーネントを保存します。 パッケージウィンドウでは、APIインテグレーションという名前のコンポーネントが認証情報を表示します。

9. コネクタ構成で後で使用するために以下の値をコピーします：

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

10. また、上部メニューバーで見つかるアカウントのMID値もコピーします。

コネクタアクション

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

構成の構成

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

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

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

• Market Cloud App Client 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を参照してください。

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

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

パラメータ

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

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

パラメータ

パラメータ	説明
ビジネスユニット	(推奨) 適切なビジネスユニットを選択します。 指定されていない場合は、構成されたMarketing Cloudユーザーのデフォルトビジネスユニットに対応するデフォルトオプションが使用されます。
メールリスト	(必須) メールリストを選択します。
キーによる購読者検索	(必須) 購読者キーを提供して既存の購読者を見つけます。
非同期処理を有効にする	(オプション) 非同期処理を有効にするオプションをチェックします。 API呼び出しは処理される前にキューに入れられ、API呼び出しが受信された時点ではなく、キューに入れられた操作が後で失敗する可能性があっても、一般的に完了が早く、常に成功した応答が返されます。 詳細については、非同期処理を参照してください。

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

パラメータ

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

アクション - サブスクライバーのアップサートとメールリストへの追加

パラメータ

パラメータ	説明
ビジネスユニット	（推奨）適切なビジネスユニットを選択してください。 指定されていない場合は、デフォルトオプションが使用され、構成されたマーケティングクラウドユーザーのデフォルトビジネスユニットに対応します。
サブスクライバーキー	必須。
サブスクライバーのメールアドレス	必須。
メールリストへのサブスクライバー追加	（オプション）追加するメールリストを一つ以上選択してください。
ユーザーステータス	（オプション）ユーザーのステータスを更新する値を選択してください。
非同期処理の有効化	（オプション）非同期処理を有効にするオプションをチェックしてください。 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呼び出しは通常、完了が早く、後でキューに入れられた操作が失敗しても常に成功した応答を返します。 詳細については、非同期処理を参照してください。

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

バッチ制限

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

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

パラメータ

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

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

バッチ制限

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

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

パラメータ

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

ベンダー文書

• Salesforce Marketing Cloud: Enhanced PackagesでOAuth 2.0 APIインテグレーションを作成する
• Salesforce Marketing Cloud: APIインテグレーション
• Salesforce Marketing Cloud: SOAP APIコールを認証する