(API) Salesforce Marketing Cloud 接続
概要 overview
(API) Salesforce Marketing Cloud (旧称: ExactTarget)は、訪問者および顧客がエクスペリエンスをパーソナライズするためのジャーニーを構築し、カスタマイズできるデジタルマーケティングスイートです。
比較対象: 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 Email Data 内のオーディエンスステータスに対応する属性を持つ属性グループ Email Demographics データ拡張を次に示します。
この (API) Salesforce Marketing Cloud 宛先はを使用 Salesforce Marketing Cloud Search Attribute-Set Definitions REST API 内で定義されたデータ拡張機能とそのリンク属性を動的に取得するには、次の手順を実行します Salesforce Marketing Cloud.
これらはに表示されます ターゲットフィールド を設定したときの選択ウィンドウ マッピング ワークフローで次へ 宛先に対してオーディエンスをアクティブ化.
salesforce_mc_segment_1
. この宛先に対してオーディエンスをアクティブ化する場合、次を追加します salesforce_mc_segment_1
as マッピング ID オーディエンスオーディエンスをExperience Platformからこの属性に入力します。での属性作成例 Salesforce Marketing Cloudを以下に示します。
- 属性を作成する際は、フィールド名に空白文字を含めないでください。 代わりに、アンダースコアを使用してください
(_)
区切り文字として使用する文字。 - 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. ユーザーに割り当てられた役割の例を次に示します。
役割に応じて、 Salesforce Marketing Cloud がユーザーに割り当てられている。次のユーザーに権限も割り当てる必要があります Salesforce Marketing Cloud 更新しようとしているフィールドにリンクされているデータ拡張機能。
この宛先は、へのアクセスが必要なため data extension
を許可する必要があります。 例えば、 Email
data extension 次に示すように、を許可する必要があります。
アクセスレベルを制限するために、詳細な権限を使用して個々のアクセスを上書きすることもできます。
を参照してください。 Marketing Cloud Roles および Marketing Cloud Roles and Permissions 詳細なガイダンスのページ。
Salesforce Marketing Cloud 資格情報の収集 gather-credentials
に対して認証を行う前に、以下の項目をメモしておきます (API) Salesforce Marketing Cloud の宛先。
mcq4jrssqdlyc4lph19nnqgzzs84
.login.exacttarget.com,次を指定する必要があります
mcq4jrssqdlyc4lph19nnqgzzs84
値として。ガードレール 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 についての詳細情報。
サポートされるオーディエンス supported-audiences
この節では、この宛先に書き出すことができるオーディエンスのタイプについて説明します。
書き出しのタイプと頻度 export-type-frequency
宛先の書き出しのタイプと頻度について詳しくは、以下の表を参照してください。
- セグメントのすべてのメンバーを、フィールドマッピングに従って、必要なスキーマフィールドと共に書き出します (例:メールアドレス、電話番号、姓)。
- での各セグメントのステータス Salesforce Marketing Cloud は、に基づいて、Platform から対応するオーディエンスステータスでを更新します。 マッピング ID 次の期間に提供された値 オーディエンスのスケジュール ステップ。
宛先への接続 connect
この宛先に接続するには、宛先設定のチュートリアルの手順に従ってください。宛先の設定ワークフローで、以下の 2 つのセクションにリストされているフィールドに入力します。
内 宛先 > カタログ、検索: (API) Salesforce Marketing Cloud. または、の下に配置することもできます。 メールマーケティング カテゴリ。
宛先に対する認証 authenticate
宛先に対して認証するには、以下の必須フィールドに入力し、を選択します。 宛先への接続. を参照してください。 収集 Salesforce Marketing Cloud 資格情報 ガイダンスのセクション。
例えば、ドメインがの場合
mcq4jrssqdlyc4lph19nnqgzzs84
.login.exacttarget.com,次を指定する必要があります
mcq4jrssqdlyc4lph19nnqgzzs84
値として。Client ID
.Client Secret
.
指定した詳細が有効な場合、UI にが表示されます 接続 緑色のチェックマークが付いているステータスは、次の手順に進むことができます。
宛先の詳細を入力 destination-details
宛先の詳細を設定するには、以下の必須フィールドとオプションフィールドに入力します。UI のフィールドの横にアスタリスクが表示される場合は、そのフィールドが必須であることを示します。
- 名前:今後この宛先を認識するための名前。
- 説明:今後この宛先を識別するのに役立つ説明。
アラートの有効化 enable-alerts
アラートを有効にすると、宛先へのデータフローのステータスに関する通知を受け取ることができます。リストからアラートを選択して、データフローのステータスに関する通知を受け取るよう登録します。アラートについて詳しくは、UI を使用した宛先アラートの購読についてのガイドを参照してください。
宛先接続の詳細の入力を終えたら「次へ」を選択します。
この宛先に対してオーディエンスをアクティブ化 activate
この宛先にオーディエンスをアクティベートする手順は、ストリーミングオーディエンスの書き出し宛先へのプロファイルとオーディエンスのアクティベートを参照してください。
マッピングの考慮事項と例 mapping-considerations-example
Adobe Experience Platform から (API) Salesforce Marketing Cloud 宛先にオーディエンスデータを正しく送信するには、フィールドマッピングの手順を実行する必要があります。マッピングは、Platform アカウント内の Experience Data Model (XDM)スキーマフィールドと、ターゲット宛先から対応する同等のスキーマフィールドとの間にリンクを作成して構成されます。
XDM フィールドをに正しくマッピングするには (API) Salesforce Marketing Cloud 宛先フィールドは、次の手順に従います。
-
ただし、属性名は 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
Attribute: Email Address
から Salesforce Marketing Cloud Email Addresses データ拡張。Mandatory
新しい連絡先を追加する場合。xdm: person.name.firstName
Attribute: First Name
必要に応じて Salesforce Marketing Cloud データ拡張。- -
これらのマッピングの使用例を次に示します。
-
宛先接続のマッピングの指定が完了したら、以下を選択します。 次.
オーディエンスの書き出しのスケジュールと例 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 次に示します。
の場所を示す例 (API) Salesforce Marketing Cloud マッピング ID 次に示します。
に示すように (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
宛先が正しく設定されていることを検証するには、次の手順に従います。
-
宛先/参照 を選択して、宛先のリストに移動します。
-
宛先を選択し、ステータスが「 有効」であることを確認します。
-
に切り替え Activation data タブをクリックしてから、オーディエンス名を選択します。
-
オーディエンスの概要を監視し、プロファイルの数がセグメント内で作成された数と一致していることを確認します。
-
にログインします Salesforce Marketing Cloud web サイト。 次に、に移動します Audience Builder > Contact Builder > All contacts > Email ページに移動して、オーディエンスのプロファイルが追加されたかどうかを確認します。
-
プロファイルが更新されているかどうかを確認するには、に移動します。 電子メール オーディエンスのプロファイルの属性値が更新されているかどうかをページで確認します。 成功した場合は、各オーディエンスステータスがに表示されます。 Salesforce Marketing Cloud は、に基づいて、Platform の対応するオーディエンスステータスで更新されました マッピング ID で指定された値 オーディエンスのスケジュール ステップ。
データの使用とガバナンス 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 範囲。 を参照してください。 Salesforce Marketing Cloud Marketing Cloudの許可リストに含める IP アドレス 追加のガイダンスが必要な場合はドキュメントを参照してください。
その他のリソース additional-resources
変更ログ 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月 | ドキュメントの更新 |
|
2023年4月 | ドキュメントの更新 |
|
2023年2月 | ドキュメントの更新 | を更新しました (API) SalesforceMarketing Cloudの前提条件 を示す参照リンクを含むセクション Salesforce Marketing Cloud Engagement は、この宛先を使用するための必須のサブスクリプションです。 |
2023年2月 | 機能の更新 | 宛先の設定が間違っていると、不正な形式の JSON が Salesforce に送信される問題を修正しました。 これにより、一部のユーザーには、アクティベーションで多数の ID が失敗していました。 (PLATIR-26299) |
2023年1月 | ドキュメントの更新 |
|
2022年10月 | 初回リリース | 宛先の初回リリースとドキュメントの公開。 |