(API) Salesforce Marketing Cloud 接続

Last update: Wed Jul 31 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：
宛先

作成対象：

管理者
ユーザー

概要 overview

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

IMPORTANT

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

B2B マーケティングに重点を置いた Salesforce Marketing Cloud Account Engagement ースに比べて、(API) Salesforce Marketing Cloud の宛先は、トランザクションの意思決定サイクルが短い B2C のユースケースに最適です。連絡先を優先順位付けおよびセグメント化してマーケティングキャンペーンを調整および改善するために、ターゲットオーディエンスの行動を表すより大きなデータセットを統合できます（特に、Salesforce 外のデータセットから）。 注意：Experience Platformには Salesforce Marketing Cloud Account Engagement への接続もあります。

この Adobe Experience Platform 宛先は、Salesforce Marketing Cloud 連絡先の更新API を使用しています。この API では、新しい Salesforce Marketing Cloud セグメント内でアクティブ化した後に、ビジネスニーズに合わせて連絡先を 追加して、連絡先データを更新 することができます。

Salesforce Marketing Cloud は、Salesforce Marketing Cloud API と通信するための認証メカニズムとして、クライアント資格情報を含む OAuth 2 を使用します。 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

Marketing Cloud Engagement 製品のサブスクリプションを持つ Salesforce Marketing Cloud アカウントは続行する必要があります。

Salesforce Marketing Cloud アカウントをお持ちでない場合や、アカウントに Marketing Cloud Engagement 製品のサブスクリプションがない場合は、Salesforce サポートにお問い合わせください。

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

(API) Salesforce Marketing Cloud の宛先に対してオーディエンスをアクティブ化する場合、オーディエンススケジュール 手順で、アクティブ化された各オーディエンスの マッピング ID フィールドに値を入力する必要があります。

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

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

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

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

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

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

これらは、宛先に対してオーディエンスをアクティブ化 するためにワークフローでマッピングを設定した場合、ターゲットフィールド選択ウィンドウに表示されます。

IMPORTANT

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

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

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

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

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

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

許可された権限を持つメールデータ拡張機能を示す SalesforceMarketing CloudUI。

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

詳しいガイダンスについては、Marketing Cloud Roles ページと Marketing Cloud Roles and Permissions ページを参照してください。

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

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

資格情報

説明

例

サブドメイン

Salesforce Marketing Cloud インターフェイスからこの値を取得する方法については、Salesforce Marketing Cloud domain prefix を参照してください。

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 エンゲージメントの価格ページを参照して フルエディションの比較表をダウンロード してください。
- API の概要ページでは、追加の制限について詳しく説明しています。
- これらの詳細を照合するページについては、こちらを参照してください。
オブジェクトごとに許可されたカスタムフィールド の数は、Salesforce のエディションによって異なります。
- 詳しくは、Salesforce ドキュメントを参照してください。
- オブジェクトごとに許可されるカスタムフィールド に定義されている制限に達した場合は、Salesforce Marketing Cloud 内で次の操作を行う必要があります
  - Salesforce Marketing Cloud に新しい属性を追加する前に、古い属性を削除します。
  - オーディエンスのスケジュール設定手順で、マッピング ID の値としてこれらの古い属性名を使用する、Platform の宛先でアクティブ化されたオーディエンスを更新または削除します。

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

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

ターゲット ID

説明

注意点

contactKey

Salesforce Marketing Cloud 連絡先キー。追加のガイダンスが必要な場合は、Salesforce Marketing Cloud ドキュメントを参照してください。

必須

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

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

オーディエンスオリジン

サポートあり

説明

Segmentation Service

✓

Experience Platform セグメント化サービスを通じて生成されたオーディエンス。

カスタムアップロード

CSV ファイルから Experience Platform に読み込まれたオーディエンス。

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

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

項目

タイプ

メモ

書き出しタイプ

プロファイルベース

セグメントのすべてのメンバーを、フィールドマッピングに従って、必要なスキーマフィールドと共に書き出します （例：メールアドレス、電話番号、姓）。
Salesforce Marketing Cloud の各セグメントのステータスは、オーディエンススケジュール手順で提供された マッピング ID 値に基づいて、Platform の対応するオーディエンスステータスとともに更新されます。

書き出し頻度

ストリーミング

ストリーミングの宛先は常に、API ベースの接続です。オーディエンス評価に基づいて Experience Platform 内でプロファイルが更新されるとすぐに、コネクタは更新を宛先プラットフォームに送信します。詳しくは、ストリーミングの宛先を参照してください。

宛先への接続 connect

IMPORTANT

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

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

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

宛先に対する認証 authenticate

宛先に対して認証するには、以下の必須フィールドに入力し、「宛先に接続」を選択します。詳しくは、Gather Salesforce Marketing Cloud credentials の節を参照してください。

(API) Salesforce Marketing Cloud の宛先

Salesforce Marketing Cloud

サブドメイン

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 グラフの表示 アクセス制御権限が必要です。

{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 個の属性を表示できます。

マッピング 手順で、「新しいマッピングを追加」を選択します。画面に新しいマッピング行が表示されます。
ソースフィールドを選択 ウィンドウで、属性を選択 カテゴリを選択して XDM 属性を選択するか、ID 名前空間を選択 を選択して ID を選択します。

ターゲットフィールドを選択 ウィンドウで、「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`	Salesforce Marketing Cloud Email Addresses データ拡張機能から `Attribute: Email Address` きます。	`Mandatory` （新しい連絡先を追加する場合）
`xdm: person.name.firstName`	目的の Salesforce Marketing Cloud データ拡張機能から `Attribute: First Name` きます。	-

これらのマッピングの使用例を次に示します。

宛先接続のマッピングの指定が完了したら、「次へ」を選択します。

オーディエンスの書き出しのスケジュールと例 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 の属性例を以下に示します。
属性を示す SalesforceMarketing CloudUI のスクリーンショット。

(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 オーディエンス 2

salesforce_mc_segment_2

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

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

宛先／参照を選択して、宛先のリストに移動します。
宛先を選択し、ステータスが「有効」であることを確認します。
「Activation data」タブに切り替えて、オーディエンス名を選択します。
オーディエンスの概要を監視し、プロファイルの数がセグメント内で作成された数と一致していることを確認します。
Salesforce Marketing Cloud web サイトにログインします。次に、Audience Builder / Contact Builder / All contacts / Email ページに移動し、オーディエンスのプロファイルが追加されたかどうかを確認します。
プロファイルが更新されたかどうかを確認するには、メール ページに移動し、オーディエンスのプロファイルの属性値が更新されているかどうかを確認します。成功すると、Salesforce Marketing Cloud の各オーディエンスステータスが、オーディエンスのスケジュール設定手順で提供された マッピング ID 値に基づいて、Platform の対応するオーディエンスステータスで更新されたことがわかります。

データの使用とガバナンス 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.
- このエラーを修正するには、アクティベーションワークフローで指定した マッピング 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...
- このエラーを修正するには、Salesforce Marketing Cloud アカウント管理者に問い合わせて、Experience Platformの IP アドレスを Salesforce Marketing Cloud アカウントの信頼できる IP 範囲に追加してください。追加のガイダンスが必要な場合は、Marketing Cloudの許可リストに含める Salesforce Marketing Cloud IP アドレスドキュメントを参照してください。

その他のリソース 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の前提条件の節を更新し、通常、ドキュメント全体で属性グループへの不要な参照を削除しました。オーディエンスステータスの属性を Email Demographics データ拡張機能内の Salesforce Marketing Cloud 内にのみ作成する必要があることを示すために、ドキュメントを更新しました。マッピングの考慮事項と例セクション内のマッピングテーブルを更新しました。`Email Addresses` データ拡張機能内の `Email Address` 属性のマッピングは必須とマークされています。この要件は、重要とマークされたコールアウトで言及されていましたが、テーブルからは省略されました。
2023年4月	ドキュメントの更新	（API） Salesforce 宛先の前提条件の節のステートメントと参照リンクを修正して、このMarketing 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