(API) Salesforce Marketing Cloud 接続

概要 overview

(API) Salesforce Marketing Cloud (旧称: ExactTarget)は、訪問者および顧客がエクスペリエンスをパーソナライズするためのジャーニーを構築し、カスタマイズできるデジタルマーケティングスイートです。

IMPORTANT
この接続とその他の接続の違いに注意してください Salesforce Marketing Cloud 接続 これは、メールマーケティングカタログセクション内に存在します。 もう 1 つの SalesforceMarketing Cloud接続では、指定のストレージの場所にファイルを書き出すことができます。これは API ベースのストリーミング接続です。

比較対象: Salesforce Marketing Cloud Account Engagement その方が指向が強い B2B マーケティング、 (API) Salesforce Marketing Cloud 宛先は次に最適です: B2C トランザクションの意思決定サイクルが短いユースケース。 特に外部のデータセットから連絡先を優先順位付けしてセグメント化することで、ターゲットオーディエンスの行動を表すより大きなデータセットを統合し、マーケティングキャンペーンを調整および改善できます Salesforce. なお、Experience Platformには以下への接続もあります Salesforce Marketing Cloud Account Engagement.

この Adobe Experience Platform 宛先 はを使用します Salesforce Marketing Cloud 連絡先を更新 API。次のことが可能です。 連絡先の追加と連絡先データの更新 新規内でアクティブ化した後のビジネスニーズに対応 Salesforce Marketing Cloud セグメント。

Salesforce Marketing Cloud は、と通信するための認証メカニズムとして、クライアント資格情報を含む OAuth 2 を使用します。 Salesforce Marketing Cloud API です。 Salesforce Marketing Cloud インスタンスを認証する手順は、さらに下の宛先に対する認証の節にあります。

ユースケース use-cases

(API) Salesforce Marketing Cloud 宛先を使用する方法とタイミングを理解しやすくするために、Adobe Experience Platform のお客様がこの宛先を使用して解決できるユースケースのサンプルを以下に示します。

マーケティングキャンペーンの連絡先へのメールの送信 use-case-send-emails

ホームレンタルプラットフォームの販売部門は、ターゲットとなる顧客オーディエンスにマーケティングメールをブロードキャストしたいと考えています。 プラットフォームのマーケティングチームは、新しい連絡先を追加/既存の連絡先を更新できます (およびメールアドレス) Adobe Experience Platformを通じて、独自のオフラインデータからオーディエンスを作成し、それらのオーディエンスをに送信します。 Salesforce Marketing Cloudを使用して、マーケティングキャンペーンメールを送信できます。

前提条件 prerequisites

Experience Platformの前提条件 prerequisites-in-experience-platform

(API) Salesforce Marketing Cloud 宛先へのデータをアクティブ化する前に、スキーマデータセットおよびセグメントを Experience Platform で作成する必要があります。

の前提条件 (API) Salesforce Marketing Cloud prerequisites-destination

Platform からにデータを書き出すには、次の前提条件に注意してください Salesforce Marketing Cloud アカウント :

Salesforce Marketing Cloud アカウントが必要です prerequisites-account

A Salesforce Marketing Cloud のサブスクリプションを持つアカウント Marketing Cloud Engagement 続行するには製品が必須です。

~に手を伸ばす Salesforce サポート を持っていない場合: Salesforce Marketing Cloud アカウントまたはアカウントにがありません Marketing Cloud Engagement 製品サブスクリプション。

内での属性の作成 Salesforce Marketing Cloud prerequisites-attribute

に対してオーディエンスをアクティブ化する場合 (API) Salesforce Marketing Cloud 宛先。に値を入力してください マッピング ID アクティブ化された各オーディエンスのフィールド( オーディエンススケジュール ステップ。

Salesforce Experience Platformから受信するオーディエンスを正しく読み取って解釈し、内でオーディエンスステータスを更新するには、この値が必要です Salesforce Marketing Cloud. のExperience Platformドキュメントを参照してください。 オーディエンスメンバーシップの詳細スキーマフィールドグループ オーディエンスのステータスのガイダンスが必要な場合。

Platform からに対してアクティブ化する各オーディエンスの場合 Salesforce、タイプの属性が必要です Text にリンクされています Email Demographics 内のデータ拡張 Salesforce Marketing Cloud. の使用 Salesforce Marketing Cloud Contact Builder をクリックして属性を作成します。 を参照してください。 Salesforce Marketing Cloud のドキュメント化 属性を作成 属性の作成に関するガイダンスが必要な場合。

属性フィールド名は、 (API) Salesforce Marketing Cloud 次の期間のターゲットフィールド マッピング ステップ。 ビジネス要件に応じて、最大 4,000 文字のフィールド文字を定義できます。 を参照してください。 Salesforce Marketing Cloud データ拡張機能のデータタイプ 属性タイプについて詳しくは、ドキュメントページを参照してください。

のデータデザイナー画面の例 Salesforce Marketing Cloudを追加する属性を次に示します。
Salesforce Marketing Cloud UI データデザイナー。

のビュー Salesforce Marketing Cloud Email Data 内のオーディエンスステータスに対応する属性を持つ属性グループ Email Demographics データ拡張を次に示します。
Salesforce Marketing Cloud UI メールデータ属性グループ。

この (API) Salesforce Marketing Cloud 宛先はを使用 Salesforce Marketing Cloud Search Attribute-Set Definitions REST API 内で定義されたデータ拡張機能とそのリンク属性を動的に取得するには、次の手順を実行します Salesforce Marketing Cloud.

これらはに表示されます ターゲットフィールド を設定したときの選択ウィンドウ マッピング ワークフローで次へ 宛先に対してオーディエンスをアクティブ化.

IMPORTANT
内 Salesforce Marketing Cloudは、属性を作成する必要があります フィールド名 内で指定された値と完全に一致する マッピング ID アクティブ化された各 Platform セグメント用。 例えば、以下のスクリーンショットは、という名前の属性を示しています。 salesforce_mc_segment_1. この宛先に対してオーディエンスをアクティブ化する場合、次を追加します salesforce_mc_segment_1 as マッピング ID オーディエンスオーディエンスをExperience Platformからこの属性に入力します。

での属性作成例 Salesforce Marketing Cloudを以下に示します。
属性を示す Salesforce Marketing Cloud UI のスクリーンショット。

TIP
  • 属性を作成する際は、フィールド名に空白文字を含めないでください。 代わりに、アンダースコアを使用してください (_) 区切り文字として使用する文字。
  • Platform オーディエンスに使用される属性と内の他の属性を区別するには Salesforce Marketing Cloudを使用すると、Adobeセグメントに使用される属性の認識可能なプレフィックスまたはサフィックスを含めることができます。 例えば、の代わりに test_segment、を使用 Adobe_test_segment または test_segment_Adobe.
  • で他の属性を既に作成している場合 Salesforce Marketing Cloudを使用すると、Platform セグメントと同じ名前を使用して、でオーディエンスを簡単に識別できます Salesforce Marketing Cloud.

内でのユーザーの役割と権限の割り当て Salesforce Marketing Cloud prerequisites-roles-permissions

As Salesforce Marketing Cloud はユースケースに応じてカスタムの役割をサポートし、内の属性を更新するには、関連する役割をユーザーに割り当てる必要があります Salesforce Marketing Cloud. ユーザーに割り当てられた役割の例を次に示します。
選択したユーザーの SalesforceMarketing CloudUI。割り当てられたロールが表示されます。

役割に応じて、 Salesforce Marketing Cloud がユーザーに割り当てられている。次のユーザーに権限も割り当てる必要があります Salesforce Marketing Cloud 更新しようとしているフィールドにリンクされているデータ拡張機能。

この宛先は、へのアクセスが必要なため data extensionを許可する必要があります。 例えば、 Email data extension 次に示すように、を許可する必要があります。

許可された権限を持つメールデータ拡張機能を示す Salesforce Marketing Cloud UI。

アクセスレベルを制限するために、詳細な権限を使用して個々のアクセスを上書きすることもできます。
詳細な権限を持つメールデータ拡張機能を示す Salesforce Marketing Cloud UI。

を参照してください。 Marketing Cloud Roles および Marketing Cloud Roles and Permissions 詳細なガイダンスのページ。

Salesforce Marketing Cloud 資格情報の収集 gather-credentials

に対して認証を行う前に、以下の項目をメモしておきます (API) Salesforce Marketing Cloud の宛先。

資格情報
説明
サブドメイン
参照: Salesforce Marketing Cloud domain prefix から、この値を取得する方法を説明します Salesforce Marketing Cloud インターフェイス。
次の場合 Salesforce Marketing Cloud ドメイン:
mcq4jrssqdlyc4lph19nnqgzzs84.login.exacttarget.com,
次を指定する必要があります mcq4jrssqdlyc4lph19nnqgzzs84 値として。
クライアント ID
を参照してください。 Salesforce Marketing Cloud 詳細を見る から、この値を取得する方法を説明します Salesforce Marketing Cloud インターフェイス。
r23kxxxxxxxx0z05xxxxxx
クライアント秘密鍵
を参照してください。 Salesforce Marketing Cloud 詳細を見る から、この値を取得する方法を説明します Salesforce Marketing Cloud インターフェイス。
ipxxxxxxxxxT4xxxxxxxxxxx

ガードレール guardrails

  • Salesforce による特定 レート制限.

    • を参照してください。 Salesforce Marketing Cloud 詳細を見る 発生する可能性のある制限に対処し、実行中のエラーを減らします。
    • を参照してください。 Salesforce Marketing Cloud エンゲージメント価格 ページ先 完全版の比較表をダウンロード as a pdf:プランによって課せられる制限の詳細。
    • この API の概要 ページの詳細には、追加の制限があります。
    • 参照 こちら これらの詳細を照合するページの。
  • の数 オブジェクトごとに許可されるカスタムフィールド salesforce のエディションによって異なります。

    • を参照してください。 Salesforce 詳細を見る 追加のガイダンス用。

    • に定義された上限に達した場合 オブジェクトごとに許可されるカスタムフィールド 内 Salesforce Marketing Cloud 以下が必要になります

      • に新しい属性を追加する前に、古い属性を削除する Salesforce Marketing Cloud.
      • Platform の宛先で、これらの古い属性名を値として使用しているアクティブ化されたオーディエンスを更新または削除します。 マッピング ID 期間中に オーディエンスのスケジュール ステップ。

サポートされている ID supported-identities

(API) Salesforce Marketing Cloud では、以下の表で説明する ID のアクティブ化をサポートしています。 ID についての詳細情報。

ターゲット ID
説明
注意点
contactKey
Salesforce Marketing Cloud 連絡先キー。 を参照してください。 Salesforce Marketing Cloud 詳細を見る 追加のガイダンスが必要な場合。
必須

サポートされるオーディエンス supported-audiences

この節では、この宛先に書き出すことができるオーディエンスのタイプについて説明します。

オーディエンスオリジン
サポートあり
説明
Segmentation Service
Experience Platformを通じて生成されたオーディエンス セグメント化サービス.
カスタムアップロード
X
CSV ファイルから Experience Platform に読み込まれたオーディエンス。

書き出しのタイプと頻度 export-type-frequency

宛先の書き出しのタイプと頻度について詳しくは、以下の表を参照してください。

項目
タイプ
メモ
書き出しタイプ
プロファイルベース
  • セグメントのすべてのメンバーを、フィールドマッピングに従って、必要なスキーマフィールドと共に書き出します​ (例:メールアドレス、電話番号、姓)
  • での各セグメントのステータス Salesforce Marketing Cloud は、に基づいて、Platform から対応するオーディエンスステータスでを更新します。 マッピング ID 次の期間に提供された値 オーディエンスのスケジュール ステップ。
書き出し頻度
ストリーミング
ストリーミングの宛先は常に、API ベースの接続です。オーディエンス評価に基づいて Experience Platform 内でプロファイルが更新されるとすぐに、コネクタは更新を宛先プラットフォームに送信します。詳しくは、ストリーミングの宛先を参照してください。

宛先への接続 connect

IMPORTANT
宛先に接続するには、宛先の管理 アクセス制御権限が必要です。詳しくは、アクセス制御の概要または製品管理者に問い合わせて、必要な権限を取得してください。

この宛先に接続するには、宛先設定のチュートリアルの手順に従ってください。宛先の設定ワークフローで、以下の 2 つのセクションにリストされているフィールドに入力します。

宛先 > カタログ、検索: (API) Salesforce Marketing Cloud. または、の下に配置することもできます。 メールマーケティング カテゴリ。

宛先に対する認証 authenticate

宛先に対して認証するには、以下の必須フィールドに入力し、を選択します。 宛先への接続. を参照してください。 収集 Salesforce Marketing Cloud 資格情報 ガイダンスのセクション。

(API) Salesforce Marketing Cloud 宛先
Salesforce Marketing Cloud
Subdomain
あなたの Salesforce Marketing Cloud ドメインのプレフィックス。
例えば、ドメインがの場合
mcq4jrssqdlyc4lph19nnqgzzs84.login.exacttarget.com,
次を指定する必要があります mcq4jrssqdlyc4lph19nnqgzzs84 値として。
クライアント ID
あなたの Salesforce Marketing Cloud Client ID.
クライアント秘密鍵
あなたの Salesforce Marketing Cloud Client Secret.

Salesforce Marketing Cloudへの認証方法を示す Platform UI のスクリーンショット。

指定した詳細が有効な場合、UI にが表示されます 接続 緑色のチェックマークが付いているステータスは、次の手順に進むことができます。

宛先の詳細を入力 destination-details

宛先の詳細を設定するには、以下の必須フィールドとオプションフィールドに入力します。UI のフィールドの横にアスタリスクが表示される場合は、そのフィールドが必須であることを示します。
宛先の詳細を示す Platform UI のスクリーンショット。

  • 名前:今後この宛先を認識するための名前。
  • 説明:今後この宛先を識別するのに役立つ説明。

アラートの有効化 enable-alerts

アラートを有効にすると、宛先へのデータフローのステータスに関する通知を受け取ることができます。リストからアラートを選択して、データフローのステータスに関する通知を受け取るよう登録します。アラートについて詳しくは、UI を使用した宛先アラートの購読についてのガイドを参照してください。

宛先接続の詳細の入力を終えたら「次へ」を選択します。

この宛先に対してオーディエンスをアクティブ化 activate

IMPORTANT
  • データをアクティブ化するには、 宛先の表示, 宛先のアクティブ化, プロファイルの表示、および セグメントの表示 アクセス制御権限. アクセス制御の概要を参照するか、製品管理者に問い合わせて必要な権限を取得してください。
  • エクスポートする id、が必要です ID グラフの表示 アクセス制御権限.
    宛先に対してオーディエンスをアクティブ化するために、ワークフローで強調表示されている ID 名前空間を選択します。 {width="100" modal="regular"}

この宛先にオーディエンスをアクティベートする手順は、ストリーミングオーディエンスの書き出し宛先へのプロファイルとオーディエンスのアクティベートを参照してください。

マッピングの考慮事項と例 mapping-considerations-example

Adobe Experience Platform から (API) Salesforce Marketing Cloud 宛先にオーディエンスデータを正しく送信するには、フィールドマッピングの手順を実行する必要があります。マッピングは、Platform アカウント内の Experience Data Model (XDM)スキーマフィールドと、ターゲット宛先から対応する同等のスキーマフィールドとの間にリンクを作成して構成されます。

XDM フィールドをに正しくマッピングするには (API) Salesforce Marketing Cloud 宛先フィールドは、次の手順に従います。

IMPORTANT
  • ただし、属性名は Salesforce Marketing Cloud アカウント、両方のマッピング contactKey および personalEmail.address は必須です。

  • との統合 Salesforce Marketing Cloud API には、Experience Platformが Salesforce から取得できる属性数のページネーション制限が適用されます。 これは、 マッピング ターゲットフィールドスキーマには、Salesforce アカウントから最大 2,000 個の属性を表示できます。

  1. マッピング ​手順で、「新しいマッピングを追加」を選択します。画面に新しいマッピング行が表示されます。
    「新しいマッピングを追加」の Platform UI のスクリーンショットの例。

  2. が含まれる ソースフィールドを選択 ウィンドウで、 属性を選択 カテゴリを選択して XDM 属性を選択するか、 ID 名前空間を選択 ID を選択します。

  3. が含まれる ターゲットフィールドを選択 ウィンドウで、 ID 名前空間を選択 ID を選択するか、 属性を選択 カテゴリを選択し、必要に応じて表示されるデータ拡張機能から属性を選択します。 この (API) Salesforce Marketing Cloud 宛先はを使用 Salesforce Marketing Cloud Search Attribute-Set Definitions REST API 内で定義されたデータ拡張機能とそのリンク属性を動的に取得するには、次の手順を実行します Salesforce Marketing Cloud. これらはに表示されます ターゲットフィールド を設定するとポップアップされます。 マッピング が含まれる オーディエンスをアクティベートワークフロー.

    • これらの手順を繰り返して、XDM プロファイルスキーマとの間に次のマッピングを追加します (API) Salesforce Marketing Cloud:

      table 0-row-3 1-row-3 2-row-3 3-row-3
      ソースフィールド ターゲットフィールド 必須
      IdentityMap: contactKey Identity: salesforceContactKey Mandatory
      xdm: personalEmail.address Attribute: Email Address から Salesforce Marketing Cloud Email Addresses データ拡張。 Mandatory新しい連絡先を追加する場合。
      xdm: person.name.firstName Attribute: First Name 必要に応じて Salesforce Marketing Cloud データ拡張。 -
    • これらのマッピングの使用例を次に示します。

      ターゲットマッピングを示した Platform UI のスクリーンショットの例。

宛先接続のマッピングの指定が完了したら、以下を選択します。 .

オーディエンスの書き出しのスケジュールと例 schedule-segment-export-example

を実行する場合 オーディエンスの書き出しをスケジュール 手順では、Platform オーディエンスをに手動でマッピングする必要があります 属性 。対象: Salesforce Marketing Cloud.

これを行うには、各セグメントを選択し、から属性の名前を入力します Salesforce Marketing Cloud が含まれる (API) Salesforce Marketing Cloud マッピング ID フィールド。 を参照してください。 内に属性を作成 Salesforce Marketing Cloud の属性作成のガイダンスとベストプラクティスに関する節 Salesforce Marketing Cloud.

例えば、次のような場合 Salesforce Marketing Cloud 属性は salesforce_mc_segment_1。この値を (API) Salesforce Marketing Cloud マッピング ID オーディエンスオーディエンスをExperience Platformからこの属性に入力します。

の属性例 Salesforce Marketing Cloud 次に示します。
属性を示す Salesforce Marketing Cloud UI のスクリーンショット。

の場所を示す例 (API) Salesforce Marketing Cloud マッピング ID 次に示します。
スケジュールのオーディエンス書き出しを示した Platform UI のスクリーンショットの例。

に示すように (API) Salesforce Marketing Cloud マッピング ID 内で指定された値と完全に一致する必要があります Salesforce Marketing Cloud フィールド名.

アクティブ化された各 Platform セグメントに対して、このセクションを繰り返します。

上記の画像に基づく典型的な例は、です。
| (API) Salesforce Marketing Cloud セグメント名 | Salesforce Marketing Cloud フィールド名 | (API) Salesforce Marketing Cloud マッピング ID | | — | — | — | | salesforce mc オーディエンス 1 | salesforce_mc_segment_1 | salesforce_mc_segment_1 | | salesforce mc オーディエンス 2 | salesforce_mc_segment_2 | salesforce_mc_segment_2 |

データの書き出しを検証する exported-data

宛先が正しく設定されていることを検証するには、次の手順に従います。

  1. 宛先参照 を選択して、宛先のリストに移動します。
    宛先の参照を示す Platform UI のスクリーンショット。

  2. 宛先を選択し、ステータスが「 有効」であることを確認します。
    宛先のデータフロー実行を示した Platform UI のスクリーンショット。

  3. に切り替え Activation data タブをクリックしてから、オーディエンス名を選択します。
    宛先のアクティベーションデータを示した Platform UI のスクリーンショットの例。

  4. オーディエンスの概要を監視し、プロファイルの数がセグメント内で作成された数と一致していることを確認します。
    セグメントを示す Platform UI のスクリーンショットの例。

  5. にログインします Salesforce Marketing Cloud web サイト。 次に、に移動します Audience Builder > Contact Builder > All contacts > Email ページに移動して、オーディエンスのプロファイルが追加されたかどうかを確認します。
    セグメントで使用されているプロファイルを含む連絡先ページを示す Salesforce Marketing Cloud UI のスクリーンショット。

  6. プロファイルが更新されているかどうかを確認するには、に移動します。 電子メール オーディエンスのプロファイルの属性値が更新されているかどうかをページで確認します。 成功した場合は、各オーディエンスステータスがに表示されます。 Salesforce Marketing Cloud は、に基づいて、Platform の対応するオーディエンスステータスで更新されました マッピング ID で指定された値 オーディエンスのスケジュール ステップ。
    選択した連絡先メールページと更新されたオーディエンスのステータスを示す Salesforce Marketing Cloud UI のスクリーンショット。

データの使用とガバナンス data-usage-governance

Adobe Experience Platform のすべての宛先は、データを処理する際のデータ使用ポリシーに準拠しています。Adobe Experience Platform がどのようにデータガバナンスを実施するかについて詳しくは、データガバナンスの概要を参照してください。

エラーとトラブルシューティング errors-and-troubleshooting

イベントを Salesforce Marketing Cloudにプッシュ中に不明なエラーが発生しました unknown-errors

  • データフローの実行を確認すると、次のエラーメッセージが表示される場合があります。 Unknown errors encountered while pushing events to the destination. Please contact the administrator and try again.
    エラーを示す Platform UI のスクリーンショット。

    • このエラーを修正するには、 マッピング ID アクティベーションワークフローでに指定したもの (API) Salesforce Marketing Cloud 宛先が、で作成した属性の名前と完全に一致する Salesforce Marketing Cloud. を参照してください。 内に属性を作成 Salesforce Marketing Cloud 説明のためのセクション。
  • セグメントをアクティブ化すると、次のエラーメッセージが表示される場合があります。 The client's IP address is unauthorized for this account. Allowlist the client's IP address...

その他のリソース additional-resources

  • Salesforce Marketing Cloud API
  • Salesforce Marketing Cloud 詳細を見る 指定した情報を使用した連絡先の更新方法の説明。

変更ログ changelog

この節では、この宛先コネクタに対する機能の概要と重要なドキュメントの更新について説明します。

変更ログを表示
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 layout-auto
リリース月 更新タイプ 説明
2023年10月 ドキュメントの更新
  • を更新しました (API) SalesforceMarketing Cloudの前提条件 セクションおよびは一般に、ドキュメント全体で属性グループへの不要な参照を削除しました。
  • オーディエンスステータスの属性を内で作成する必要があることを示すために、ドキュメントを更新しました Salesforce Marketing Cloud 内 Email Demographics データ拡張機能のみ。
  • 内のマッピングテーブルを更新しました。 マッピングの考慮事項と例 セクション、のマッピング Email Address 内の属性 Email Addresses データ拡張は必須とマークされています。この要件は、コールアウトで重要とマークされていましたが、テーブルからは省略されました。
2023年4月 ドキュメントの更新
  • のステートメントと参照リンクを修正しました (API) SalesforceMarketing Cloudの前提条件 を呼び出す節 Salesforce Marketing Cloud Engagement は、この宛先を使用するための必須のサブスクリプションです。 この節は、以前は、ユーザーがMarketing Cloudの購読を必要とする誤った呼び出しがありました アカウント 続行する契約。
  • の下にセクションを追加しました 前提条件 (用) 役割と権限 に割り当てられる Salesforce この宛先が機能するためのユーザー。 (PLATIR-26299)
2023年2月 ドキュメントの更新 を更新しました (API) SalesforceMarketing Cloudの前提条件 を示す参照リンクを含むセクション Salesforce Marketing Cloud Engagement は、この宛先を使用するための必須のサブスクリプションです。
2023年2月 機能の更新 宛先の設定が間違っていると、不正な形式の JSON が Salesforce に送信される問題を修正しました。 これにより、一部のユーザーには、アクティベーションで多数の ID が失敗していました。 (PLATIR-26299)
2023年1月 ドキュメントの更新
  • を更新しました の前提条件 Salesforce で属性を作成する必要があることを呼び出すためのセクション Salesforce 辺。 この節では、その方法と、での属性の命名に関するベストプラクティスについて詳しく説明します Salesforce. (PLATIR-25602)
  • でアクティブ化された各オーディエンスのマッピング ID を使用する方法について、明確な手順を追加しました。 オーディエンスのスケジュール ステップ。 (PLATIR-25602)
2022年10月 初回リリース 宛先の初回リリースとドキュメントの公開。
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6