ドキュメントExperience Platformソースコネクタガイド

Salesforce

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

  • 開発者

Adobe Experience Platform を使用すると、外部ソースからデータを取り込みながら、Platform サービスを使用して受信データの構造化、ラベル付けおよび拡張を行うことができます。アドビのアプリケーション、クラウドベースのストレージ、データベースなど、様々なソースからデータを取り込むことができます。

Experience Platform は、サードパーティの CRM システムからのデータ取り込みをサポートしています。CRM プロバイダーのサポートは Salesforce を含みます。

IP アドレス許可リスト

ソースコネクタを操作する前に、IP アドレスのリストを許可リストに追加する必要があります。 地域固有の IP アドレスを許可リストに追加しないと、ソースを使用する際にエラーが発生したり、パフォーマンスが低下する場合があります。 詳しくは、IP アドレスの許可リストページを参照してください。

Salesforce から XDM へのフィールドマッピング

Salesforce と Platform の間にソース接続を確立するには、Salesforce のソースデータフィールドを、Platform に取り込む前に、適切なターゲット XDM フィールドにマッピングする必要があります。

Salesforce データセットと Platform 間のフィールドマッピングルールについて詳しくは、次を参照してください。

Salesforce 名前空間とスキーマ自動生成ユーティリティの設定

Salesforce ソースを B2B-CDP の一部として使用するには、まず Postman ユーティリティを設定して、Salesforce 名前空間とスキーマを自動生成する必要があります。 次のドキュメントでは、Postman ユーティリティの設定に関する追加情報を示します。

  • この GitHub リポジトリから、名前空間およびスキーマ自動生成ユーティリティのコレクションと環境をダウンロードできます。
  • 必要なヘッダーの値を収集する方法やサンプル API 呼び出しを読み取る方法など、Platform API の使用について詳しくは、Platform API の概要を参照してください。
  • Platform API の資格情報の生成方法について詳しくは、Experience PlatformAPI の認証とアクセスに関するチュートリアルを参照してください。
  • Platform API の Postman の設定方法について詳しくは、 開発者コンソールとの設定 Postman のチュートリアルを参照してください。

Platform 開発者コンソールをセットアップす Postman と、適切な環境値の Postman 環境への適用を開始できます。

次の表に、値の例と、Postman 環境へのデータ入力に関する追加情報を示します。

変数
説明
例
CLIENT_SECRET
{ACCESS_TOKEN} ータの生成に使用される一意の ID。 サー {CLIENT_SECRET} スの取得方法について詳しくは、Experience Platform API の認証とアクセスに関するチュートリアルを参照してください。
{CLIENT_SECRET}
JWT_TOKEN
JSON web トークン（JWT）は、{ACCESS_TOKEN} ータの生成に使用される認証資格情報です。 サー {JWT_TOKEN} スの生成方法について詳しくは、Experience PlatformAPI の認証とアクセスに関するチュートリアルを参照してください。
{JWT_TOKEN}
API_KEY
Experience PlatformAPI への呼び出しの認証に使用される一意の ID。 サー {API_KEY} スの取得方法について詳しくは、Experience Platform API の認証とアクセスに関するチュートリアルを参照してください。
c8d9a2f5c1e03789bd22e8efdd1bdc1b
ACCESS_TOKEN
Experience PlatformAPI を呼び出すために必要な認証トークン。 サー {ACCESS_TOKEN} スの取得方法について詳しくは、Experience Platform API の認証とアクセスに関するチュートリアルを参照してください。
Bearer {ACCESS_TOKEN}
META_SCOPE
Marketo に関しては、この値は固定で、常に ent_dataservices_sdk に設定されます。
ent_dataservices_sdk
CONTAINER_ID
global コンテナには、標準AdobeおよびExperience Platformパートナー提供のすべてのクラス、スキーマフィールドグループ、データタイプおよびスキーマが格納されます。 Marketo に関しては、この値は固定で、常に global に設定されます。
global
PRIVATE_KEY
API に対する Postman インスタンスのExperience Platformに使用される資格情報。 コンテン {PRIVATE_KEY} の取得方法については、開発者コンソールの設定および 開発者コンソールの設定および Postman に関するチュートリアルを参照してください。
{PRIVATE_KEY}
TECHNICAL_ACCOUNT_ID
Adobe I/Oへの統合に使用する資格情報。
D42AEVJZTTJC6LZADUBVPA15@techacct.adobe.com
IMS
Identity Management System （IMS）は、Adobe サービスに対して認証を行うためのフレームワークを提供します。 Marketo に関しては、この値は固定で、常に ims-na1.adobelogin.com に設定されます。
ims-na1.adobelogin.com
IMS_ORG
製品およびサービスを所有またはライセンスし、そのメンバーへのアクセスを許可できる法人組織。 {ORG_ID} ーザー情報の取得方法については、Developer Console の設定および Postman に関するチュートリアルを参照してください。
ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
SANDBOX_NAME
使用している仮想サンドボックスパーティションの名前。
prod
TENANT_ID
作成するリソースの名前空間が適切に設定され、組織内に含まれていることを確認するために使用される ID。
b2bcdpproductiontest
PLATFORM_URL
API 呼び出しを行う URL エンドポイント。 この値は固定で、常に http://platform.adobe.io/ に設定されます。
http://platform.adobe.io/
munchkinId
Marketo アカウントの一意の ID。 インスタンスの取得方法について詳しくは、 インスタンスの認証に関するチュー munchkinId リアルを参照してください Marketo
123-ABC-456
sfdc_org_id
Salesforce アカウントの組織 ID。 Salesforce 組織 ID の取得について詳しくは、次の Salesforce ガイドを参照してください。
00D4W000000FgYJUA0
has_abm
Marketo Account-Based Marketing を購読しているかどうかを示すブール値。
false
has_msi
Marketo Sales Insight に登録されているかどうかを示すブール値。
false

スクリプトの実行

Postman コレクションと環境を設定すると、Postman インターフェイスを使用してスクリプトを実行できます。

Postman インターフェイスで、自動生成ユーティリティのルートフォルダーを選択し、上部のヘッダーから「Run」を選択します。

root-folder

Runner インターフェイスが表示されます。 ここから、すべてのチェックボックスが選択されていることを確認してから選択し Run Namespaces and Schemas Autogeneration Utility す。

run-generator

リクエストが成功すると、ベータ版の仕様に従って B2B 名前空間とスキーマが作成されます。

API を使用して Salesforce と Platform を接続する

以下のドキュメントでは、API やユーザーインターフェイスを使用して Salesforce と Platform を接続する方法について説明します。

UI を使用した Salesforce の Platform への接続

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089