(API) Salesforce Marketing Cloud 接続
概要 overview
(API) Salesforce Marketing Cloud (旧称ExactTarget)は、訪問者や顧客が体験をパーソナライズするジャーニーを構築およびカスタマイズするために使用できるデジタルマーケティングスイートです。
Salesforce Marketing Cloud Account EngagementB2B マーケティングに重点を置いていると比較して、(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は、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
Experience PlatformからSalesforce Marketing Cloud アカウントにデータをエクスポートするには、次の前提条件に注意してください。
Salesforce Marketing Cloud アカウントが必要です prerequisites-account
続行するには、Salesforce Marketing CloudMarketing Cloud Engagement製品のサブスクリプションを持つ アカウントが必要です。
Salesforce アカウントをお持ちでない場合、またはアカウントに製品サブスクリプションがない場合は、Salesforce Marketing Cloud サポート Marketing Cloud Engagementにお問い合わせください。
Salesforce Marketing Cloud内で属性を作成 prerequisites-attribute
(API) Salesforce Marketing Cloud宛先に対してオーディエンスをアクティブ化する場合、Mapping ID オーディエンススケジュール 手順で、アクティブ化された各オーディエンスの フィールドに値を入力する必要があります。
Salesforceでは、この値を使用して、Experience Platformから受信したオーディエンスを正しく読み取り、解釈し、Salesforce Marketing Cloud以内にオーディエンスステータスを更新する必要があります。 オーディエンスのステータスに関するガイダンスが必要な場合は、 オーディエンスメンバーシップの詳細スキーマフィールドグループ のExperience Platform ドキュメントを参照してください。
Experience PlatformからSalesforceにアクティベートする各オーディエンスについて、Text内のEmail Demographics データ拡張機能にリンクされたタイプ Salesforce Marketing Cloudの属性が必要です。 Salesforce Marketing Cloud Contact Builderを使用して属性を作成します。 属性の作成に関するガイダンスが必要な場合は、Salesforce Marketing Cloud属性の作成に関する ドキュメントを参照してください。
属性フィールド名は、(API) Salesforce Marketing Cloud ステップのMapping ターゲットフィールドに使用されます。 ビジネス要件に応じて、最大4000文字のフィールド文字を定義できます。 属性タイプについて詳しくは、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内で定義されたデータ拡張機能とそのリンク属性を動的に取得します。
ワークフローのTarget field マッピング をセットアップして宛先に対するオーディエンスをアクティブ化する場合、これらは選択ウィンドウに表示されます。
salesforce_mc_segment_1という名前の属性を示しています。 この宛先にオーディエンスをアクティブ化する場合は、salesforce_mc_segment_1を Mapping ID として追加して、Experience Platformからオーディエンスオーディエンスをこの属性に入力します。Salesforce Marketing Cloudでの属性作成の例を次に示します。
- 属性を作成する場合は、フィールド名に空白文字を含めないでください。 代わりに、アンダースコア
(_)文字を区切り文字として使用してください。 - Experience Platform オーディエンスに使用される属性とSalesforce Marketing Cloud内のその他の属性を区別するには、Adobe セグメントに使用される属性に認識可能な接頭辞または接尾辞を含めることができます。 例えば、
test_segmentの代わりに、Adobe_test_segmentまたはtest_segment_Adobeを使用します。 - Salesforce Marketing Cloudで既に他の属性が作成されている場合は、Experience Platform セグメントと同じ名前を使用して、Salesforce Marketing Cloudのオーディエンスを簡単に識別できます。
Salesforce Marketing Cloud内でユーザーの役割と権限を割り当てます prerequisites-roles-permissions
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 エンゲージメント価格 ページから 完全版の比較チャート をPDFとしてダウンロードしてください。
- APIの概要 ページには、追加の制限が記載されています。
- これらの詳細を照合するページについては、こちらを参照してください。
-
オブジェクト ごとに許可される カスタムフィールドの数は、Salesforce エディションによって異なります。
-
追加のガイダンスについては、Salesforce ドキュメント を参照してください。
-
内のオブジェクトごとに許可されるSalesforce Marketing Cloud カスタムフィールドに対して定義された制限に達した場合は、次のことが必要になります
- Salesforce Marketing Cloudで新しい属性を追加する前に、古い属性を削除します。
- これらの古い属性名を Mapping ID に指定された値として、 オーディエンススケジュール 手順で使用するExperience Platformの宛先でアクティブ化されたオーディエンスを更新または削除します。
-
サポートされている ID supported-identities
(API) Salesforce Marketing Cloudは、次の表に示すIDのアクティブ化をサポートしています。 ID についての詳細情報。
サポートされるオーディエンス supported-audiences
この節では、この宛先に書き出すことができるオーディエンスのタイプについて説明します。
このカテゴリには、Segmentation Serviceを通じて生成されたオーディエンス以外のすべてのオーディエンスのオリジンが含まれます。 様々なオーディエンスの起源について読みます。 次に例を示します。
- カスタムアップロードオーディエンス がCSV ファイルからExperience Platformにをインポートしました。
- 類似オーディエンス,
- 連合オーディエンス,
- Adobe Journey Optimizerなどの他のExperience Platform アプリで生成されたオーディエンス
- その他。
オーディエンスのデータタイプ別にサポートされるオーディエンス:
書き出しのタイプと頻度 export-type-frequency
宛先の書き出しのタイプと頻度について詳しくは、以下の表を参照してください。
- セグメントのすべてのメンバーを、フィールドマッピングに従って、必要なスキーマフィールドと共に書き出します(例:メールアドレス、電話番号、姓)。
- Salesforce Marketing Cloudの各セグメントステータスは、Mapping ID オーディエンススケジュール 手順で指定した値に基づいて、Experience Platformからの対応するオーディエンスステータスで更新されます。
宛先への接続 connect
この宛先に接続するには、宛先設定のチュートリアルの手順に従ってください。宛先の設定ワークフローで、以下の 2 つのセクションにリストされているフィールドに入力します。
Destinations > Catalog内で、(API) Salesforce Marketing Cloudを検索します。 または、Email marketing カテゴリの下に配置することもできます。
宛先に対する認証 authenticate
宛先に対して認証を行うには、以下の必須フィールドに入力し、Connect to destinationを選択します。 ガイダンスについては、収集 Salesforce Marketing Cloud 資格情報 セクションを参照してください。
例えば、ドメインが
の場合
mcq4jrssqdlyc4lph19nnqgzzs84.login.exacttarget.com、を値として
mcq4jrssqdlyc4lph19nnqgzzs84を指定する必要があります。Client ID。Client Secret。Salesforce Marketing Cloudへの認証方法を示す
指定された詳細が有効な場合、UIに緑色のチェックマークが付いたConnected ステータスが表示され、次の手順に進むことができます。
宛先の詳細を入力 destination-details
宛先の詳細を設定するには、以下の必須フィールドとオプションフィールドに入力します。UI のフィールドの横にアスタリスクが表示される場合は、そのフィールドが必須であることを示します。
宛先の詳細を示す
- Name:今後この宛先を認識する際に使用する名前。
- Description:今後この宛先を特定するのに役立つ説明です。
アラートの有効化 enable-alerts
アラートを有効にすると、宛先へのデータフローのステータスに関する通知を受け取ることができます。リストからアラートを選択して、データフローのステータスに関する通知を受け取るよう登録します。アラートについて詳しくは、UI を使用した宛先アラートの購読についてのガイドを参照してください。
宛先接続の詳細の提供が完了したら、Nextを選択します。
この宛先に対してオーディエンスをアクティブ化 activate
- データをアクティブ化するには、View Destinations、Activate Destinations、View ProfilesおよびView Segments アクセス制御権限が必要です。 アクセス制御の概要を参照するか、製品管理者に問い合わせて必要な権限を取得してください。
- IDをエクスポートするには、View Identity Graph アクセス制御権限が必要です。
{width="100" modal="regular"}
この宛先にオーディエンスをアクティベートする手順は、ストリーミングオーディエンスの書き出し宛先へのプロファイルとオーディエンスのアクティベートを参照してください。
マッピングの考慮事項と例 mapping-considerations-example
オーディエンスデータをAdobe Experience Platformから(API) Salesforce Marketing Cloud宛先に正しく送信するには、フィールドマッピング手順を実行する必要があります。 マッピングでは、Experience Platform アカウントのExperience Data Model (XDM)スキーマフィールドと、ターゲット先の対応するスキーマフィールドとの間にリンクを作成します。
XDM フィールドを(API) Salesforce Marketing Cloud宛先フィールドに正しくマッピングするには、次の手順に従います。
-
属性名はSalesforce Marketing Cloud アカウントに従いますが、
contactKeyとpersonalEmail.addressの両方のマッピングは必須です。 -
Salesforce Marketing Cloud APIとの統合では、Experience PlatformがSalesforceから取得できる属性の数のページネーション制限が適用されます。 つまり、Mapping ステップ中に、ターゲットフィールドスキーマは、Salesforce アカウントから最大2,000個の属性を表示できます。
-
Mapping ステップで、Add new mappingを選択します。 画面に新しいマッピング行が表示されます。
-
Select source field ウィンドウで、Select attributes カテゴリを選択してXDM属性を選択するか、Select identity namespaceを選択してIDを選択します。
-
Select target field ウィンドウで、Select identity namespaceを選択してIDを選択するか、Select attributes カテゴリを選択し、必要に応じて表示されるデータ拡張機能から属性を選択します。 (API) Salesforce Marketing Cloud宛先は、Salesforce Marketing Cloud Search Attribute-Set Definitions REST APIを使用して、Salesforce Marketing Cloud内で定義されたデータ拡張機能とそのリンク属性を動的に取得します。 これらは、Target field オーディエンスのアクティブ化ワークフローで マッピング を設定すると、 ポップアップに表示されます。
-
これらの手順を繰り返して、XDM プロファイルスキーマと(API) Salesforce Marketing Cloudの間に次のマッピングを追加します。
table 0-row-3 1-row-3 2-row-3 3-row-3 ソースフィールド ターゲットフィールド 必須 IdentityMap: contactKeyIdentity: salesforceContactKeyMandatoryxdm: personalEmail.addressAttribute: Email AddressSalesforce Marketing Cloud データ拡張機能のEmail Addresses。Mandatory、新しい連絡先を追加する場合。xdm: person.name.firstNameAttribute: First Nameを目的のSalesforce Marketing Cloud データ拡張機能から取得します。- -
これらのマッピングの使用例を次に示します。
-
宛先接続のマッピングの提供が完了したら、Nextを選択します。
オーディエンスの書き出しのスケジュールと例 schedule-segment-export-example
オーディエンスの書き出しをスケジュール する手順を実行する場合、の属性Salesforce Marketing CloudにExperience Platform オーディエンスを手動でマッピングする必要があります。
これを行うには、各セグメントを選択し、Salesforce Marketing Cloud (API) Salesforce Marketing Cloud フィールドに Mapping ID の属性の名前を入力します。 での属性の作成に関するガイダンスとベストプラクティスについては、 Salesforce Marketing Cloud内のSalesforce Marketing Cloud属性の作成の節を参照してください。
例えば、Salesforce Marketing Cloud属性がsalesforce_mc_segment_1の場合は、(API) Salesforce Marketing Cloud Mapping IDにこの値を指定して、Experience Platformのオーディエンスオーディエンスをこの属性に入力します。
Salesforce Marketing Cloudの属性の例を次に示します。
(API) Salesforce Marketing Cloud Mapping IDの場所を示す例を次に示します。
図に示すように、(API) Salesforce Marketing Cloud Mapping IDはSalesforce Marketing Cloud FIELD NAME内で指定された値と完全に一致する必要があります。
アクティブ化されたExperience Platform セグメントごとに、このセクションを繰り返します。
上記の画像に基づく典型的な例を以下に示す。
salesforce_mc_segment_1salesforce_mc_segment_1salesforce_mc_segment_2salesforce_mc_segment_2データの書き出しを検証する exported-data
宛先が正しく設定されていることを検証するには、次の手順に従います。
-
宛先のリストに移動するには、Destinations > Browseを選択します。
-
宛先を選択し、ステータスが enabled であることを検証します。
宛先データフロー実行を示す
-
「Activation data」タブに切り替えて、オーディエンス名を選択します。
宛先アクティベーションデータを示す
-
オーディエンスの概要を監視し、プロファイルの数がセグメント内で作成された数に対応していることを確認します。
セグメントを示す
-
Salesforce Marketing Cloud Web サイトに移動します。 次に、Audience Builder > Contact Builder > All contacts > Email ページに移動し、オーディエンスのプロファイルが追加されているかどうかを確認します。
-
プロファイルが更新されたかどうかを確認するには、Email ページに移動し、オーディエンスのプロファイルの属性値が更新されたかどうかを確認します。 成功した場合、Salesforce Marketing Cloud オーディエンススケジュール Mapping ID手順で指定した値に基づいて、の各オーディエンスステータスが、Experience 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.
エラーを示す
- このエラーを修正するには、アクティベーションワークフローで Mapping 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 CloudSalesforce 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月 | ドキュメントの更新 |
|
| 2023年4月 | ドキュメントの更新 |
|
| 2023年2月 | ドキュメントの更新 | 「(API)Salesforce Marketing Cloud」セクションの前提条件を更新し、Salesforce Marketing Cloud Engagementがこの宛先を使用するための必須サブスクリプションであることを示す参照リンクを含めました。 |
| 2023年2月 | 機能アップデート | 宛先内の誤った設定により、形式が正しくないJSONがSalesforceに送信される問題を修正しました。 そのため、一部のユーザーでは、アクティベーションで失敗したIDの数が多くなりました。 (PLATIR-26299) |
| 2023年1月 | ドキュメントの更新 |
|
| 2022年10月 | 初回リリース | 最初の宛先リリースとドキュメントの公開。 |