B2B 名前空間とスキーマ
NOTE
Adobe Experience Platform UI でテンプレートを使用すると、B2B および B2C データのアセット作成を迅速におこなうことができます。 詳しくは、 Platform UI でのテンプレートの使用.
このドキュメントでは、B2B ソースで使用する名前空間とスキーマの基になる設定に関する情報を提供します。 このドキュメントでは、B2B 名前空間とスキーマの生成に必要なPostman自動化ユーティリティの設定に関する詳細も説明します。
IMPORTANT
次へのアクセス権が必要です： Adobe Real-time Customer Data Platform B2B エディション B2B スキーマがに参加するために リアルタイム顧客プロファイル.
B2B 名前空間とスキーマ自動生成ユーティリティの設定
B2B 名前空間とスキーマ自動生成ユーティリティを使用する最初の手順は、Platform デベロッパーコンソールを設定し、 Postman 環境。
- このから、名前空間とスキーマの自動生成ユーティリティのコレクションと環境をダウンロードできます。 GitHub リポジトリ.
- 必要なヘッダーの値の収集方法の詳細や API 呼び出し例の読み取りなど、Platform API の使用に関する詳細については、 Platform API の概要.
- Platform API の資格情報を生成する方法について詳しくは、 Experience PlatformAPI の認証とアクセス.
- の設定方法について詳しくは、 Postman Platform API については、 開発者コンソールの設定および Postman.
Platform デベロッパーコンソールと Postman を設定すると、適切な環境値を Postman 環境。
次の表に、値の例と、 Postman 環境：
変数
説明
例
CLIENT_SECRETの生成に使用される一意の ID
{ACCESS_TOKEN}. に関するチュートリアルを参照してください。 Experience PlatformAPI の認証とアクセス 」を参照してください。 {CLIENT_SECRET}.{CLIENT_SECRET}JWT_TOKENJSON Web トークン (JWT) は、 {ACCESS_TOKEN}. に関するチュートリアルを参照してください。 Experience PlatformAPI の認証とアクセス 」を参照してください。
{JWT_TOKEN}.{JWT_TOKEN}API_KEYExperience PlatformAPI の呼び出しを認証するために使用される一意の識別子。 に関するチュートリアルを参照してください。 Experience PlatformAPI の認証とアクセス 」を参照してください。
{API_KEY}.c8d9a2f5c1e03789bd22e8efdd1bdc1bACCESS_TOKENExperience PlatformAPI の呼び出しを完了するために必要な認証トークン。 に関するチュートリアルを参照してください。 Experience PlatformAPI の認証とアクセス 」を参照してください。
{ACCESS_TOKEN}.Bearer {ACCESS_TOKEN}META_SCOPE次に関して： Marketoの場合、この値は固定で、常に次の値に設定されます。
ent_dataservices_sdk.ent_dataservices_sdkCONTAINER_IDThe
global コンテナには、すべての標準AdobeおよびExperience Platformパートナーが提供するクラス、スキーマフィールドグループ、データ型、スキーマが格納されます。 次に関して： Marketoの場合、この値は固定値で、常に global.globalPRIVATE_KEY認証に使用する資格情報 Postman インスタンスからExperience PlatformAPI へ 開発者コンソールの設定に関するチュートリアルと、 開発者コンソールの設定および Postman を参照してください。 {PRIVATE_KEY}.
{PRIVATE_KEY}TECHNICAL_ACCOUNT_IDAdobe I/Oへの統合に使用する秘密鍵証明書。
D42AEVJZTTJC6LZADUBVPA15@techacct.adobe.comIMSIdentity Management System(IMS) は、Adobe サービスに対する認証のフレームワークを提供します。 次に関して： Marketoの場合、この値は固定で、常に次の値に設定されます。
ims-na1.adobelogin.com.ims-na1.adobelogin.comIMS_ORG製品やサービスを所有またはライセンスし、そのメンバーへのアクセスを許可できる企業エンティティ。 に関するチュートリアルを参照してください。 開発者コンソールの設定および Postman を参照してください。
{ORG_ID} 情報。ABCEH0D9KX6A7WA7ATQE0TE@adobeOrgSANDBOX_NAME使用している仮想サンドボックスパーティションの名前です。
prodTENANT_ID作成したリソースの名前空間が適切に付けられ、組織内に含まれるようにするために使用される ID。
b2bcdpproductiontestPLATFORM_URLAPI 呼び出しをおこなう URL エンドポイント。 この値は固定で、常に次の値に設定されます。
http://platform.adobe.io/.http://platform.adobe.io/スクリプトの実行
を使用 Postman コレクションと環境の設定時に、スクリプトを Postman インターフェイス。
Adobe Analytics の Postman インタフェースで、auto-generator ユーティリティのルートフォルダを選択し、 Run を上部のヘッダーから削除します。
The Runner インターフェイスが表示されます。 ここから、すべてのチェックボックスが選択されていることを確認してから、「 」を選択します。 Run Namespaces and Schemas Autogeneration Utility.
リクエストが成功すると、B2B に必要な名前空間とスキーマが作成されます。
B2B 名前空間
ID 名前空間は、 Identity Service id のコンテキストを区別するのに役立つ 完全修飾 ID には、ID 値と名前空間が含まれます。 詳しくは、 名前空間の概要 を参照してください。
B2B 名前空間は、エンティティのプライマリ ID で使用されます。
次の表に、B2B 名前空間の基になる設定に関する情報を示します。
NOTE
テーブルのコンテンツをすべて表示するには、左右にスクロールしてください。
表示名
ID シンボル
ID タイプ
B2B 担当者
b2b_personCROSS_DEVICEB2B アカウント
b2b_accountB2B_ACCOUNTB2B 商談
b2b_opportunityB2B_OPPORTUNITYB2B 商談人物関係
b2b_opportunity_person_relationB2B_OPPORTUNITY_PERSONB2B キャンペーン
b2b_campaignB2B_CAMPAIGNB2B キャンペーンメンバー
b2b_campaign_memberB2B_CAMPAIGN_MEMBERB2B マーケティングリスト
b2b_marketing_listB2B_MARKETING_LISTB2B マーケティングリストメンバー
b2b_marketing_list_memberB2B_MARKETING_LIST_MEMBERB2B アカウント人物関係
b2b_account_person_relationB2B_ACCOUNT_PERSONB2B スキーマ
Experience Platform では、スキーマを使用して、一貫性のある再利用可能な方法でデータの構造を記述します。システムをまたいで一貫したデータを定義することで、意味を保有しやすくなり、データから価値を得ることができます。
データを Platform に取り込む前に、スキーマを構成して、データの構造を記述し、各フィールドに含めることができるデータの種類を制限する必要があります。スキーマは、基本クラスと 0 個以上のスキーマフィールドグループで構成されます。
デザインの原則やベストプラクティスなど、スキーマ構成モデルについて詳しくは、スキーマ構成の基本を参照してください。
次の表に、B2B スキーマの基礎となる設定に関する情報を示します。
NOTE
テーブルのコンテンツをすべて表示するには、左右にスクロールしてください。
スキーマ名
基本クラス
フィールドグループ
Profile スキーマ内
プライマリ ID
プライマリID 名前空間
セカンダリ
セカンダリid 名前空間
関係
メモ
B2B アカウント
XDM ビジネスアカウントの詳細
有効
accountKey.sourceKey 基本クラスでB2B アカウント
extSourceSystemAudit.externalKey.sourceKey 基本クラスでB2B アカウント
accountParentKey.sourceKey「 XDM Business Account Details 」フィールドグループ- 宛先プロパティ：
/accountKey/sourceKey - タイプ：1 対 1
- 参照スキーマ：B2B アカウント
- 名前空間：B2B アカウント
B2B 担当者
- XDM ビジネスパーソンの詳細
- XDM ビジネスパーソンのコンポーネント
- identityMap
- 同意および環境設定の詳細
有効
b2b.personKey.sourceKey （XDM ビジネス人物詳細フィールドグループ）B2B 担当者
extSourceSystemAudit.externalKey.sourceKey（XDM ビジネス人物詳細フィールドグループ）workEmail.address（XDM ビジネス人物詳細フィールドグループ）
- B2B 担当者
- メール
personComponents.sourceAccountKey.sourceKey（XDM ビジネス人物コンポーネントフィールドグループ）- タイプ：多対 1
- 参照スキーマ： B2B アカウント
- 名前空間：B2B アカウント
- 宛先プロパティ： accountKey.sourceKey
- 現在のスキーマからの関係名：アカウント
- 参照スキーマからの関係名： People
B2B 商談
XDM ビジネスオポチュニティの詳細
有効
opportunityKey.sourceKey 基本クラスでB2B 商談
extSourceSystemAudit.externalKey.sourceKey 基本クラスでB2B 商談
accountKey.sourceKey基本クラスで- タイプ：多対 1
- 参照スキーマ： B2B アカウント
- 名前空間：B2B アカウント
- 宛先プロパティ：
accountKey.sourceKey - 現在のスキーマからの関係名：アカウント
- 参照スキーマからの関係名：商談
B2B 商談人物関係
なし
有効
opportunityPersonKey.sourceKey 基本クラスでB2B 商談人物関係
extSourceSystemAudit.externalKey.sourceKey 基本クラスでB2B 商談人物関係
第 1 の関係
personKey.sourceKey基本クラスで- タイプ：多対 1
- 参照スキーマ： B2B 担当者
- 名前空間：B2B 担当者
- 宛先プロパティ：b2b.personKey.sourceKey
- 現在のスキーマからの関係名：人物
- 参照スキーマからの関係名：商談
2 番目の関係
opportunityKey.sourceKey基本クラスで- タイプ：多対 1
- 参照スキーマ： B2B 商談
- 名前空間：B2B 商談
- 宛先プロパティ：
opportunityKey.sourceKey - 現在のスキーマからの関係名：商談
- 参照スキーマからの関係名： People
B2B キャンペーン
XDM ビジネスキャンペーンの詳細
有効
campaignKey.sourceKey 基本クラスでB2B キャンペーン
extSourceSystemAudit.externalKey.sourceKey 基本クラスでB2B キャンペーン
B2B キャンペーンメンバー
XDM ビジネスキャンペーンメンバーの詳細
有効
ccampaignMemberKey.sourceKey 基本クラスでB2B キャンペーンメンバー
extSourceSystemAudit.externalKey.sourceKey 基本クラスでB2B キャンペーンメンバー
第 1 の関係
personKey.sourceKey基本クラスで- タイプ：多対 1
- 参照スキーマ： B2B 担当者
- 名前空間：B2B 担当者
- 宛先プロパティ：
b2b.personKey.sourceKey - 現在のスキーマからの関係名：人物
- 参照スキーマからの関係名：キャンペーン
2 番目の関係
campaignKey.sourceKey基本クラスで- タイプ：多対 1
- 参照スキーマ：B2B キャンペーン
- 名前空間：B2B キャンペーン
- 宛先プロパティ：
campaignKey.sourceKey - 現在のスキーマからの関係名： Campaign
- 参照スキーマからの関係名： People
B2B マーケティングリスト
なし
有効
marketingListKey.sourceKey 基本クラスでB2B マーケティングリスト
なし
なし
なし
静的リストはから同期されていません Salesforce したがって、セカンダリ ID を持ちません。
B2B マーケティングリストメンバー
なし
有効
marketingListMemberKey.sourceKey 基本クラスでB2B マーケティングリストメンバー
なし
なし
第 1 の関係
PersonKey.sourceKey基本クラスで- タイプ：多対 1
- 参照スキーマ： B2B 担当者
- 名前空間：B2B 担当者
- 宛先プロパティ：
b2b.personKey.sourceKey - 現在のスキーマからの関係名：人物
- 参照スキーマからの関係名：マーケティングリスト
2 番目の関係
marketingListKey.sourceKey基本クラスで- タイプ：多対 1
- 参照スキーマ：B2B マーケティングリスト
- 名前空間：B2B マーケティングリスト
- 宛先プロパティ：
marketingListKey.sourceKey - 現在のスキーマからの関係名：マーケティングリスト
- 参照スキーマからの関係名： People
静的リストメンバーはから同期されていません Salesforce したがって、セカンダリ ID を持ちません。
B2B アクティビティ
- Web ページにアクセス
- 新規リード
- リードの変換
- リストに追加
- リストから削除
- 商談に追加
- 商談から削除
- フォーム入力済み
- リンククリック数
- メール配信済み
- メール開封済み
- 電子メールのクリック
- バウンスメール
- ソフトバウンスメール
- メール配信停止済み
- 変更されたスコア
- 更新された商談
- キャンペーン進行のステータス変更済み
- 人物識別子
- Marketo Web URL
- 注目のアクション
- ウェブフックを呼び出す
- キャンペーンケイデンスの変更
- 収益ステージ変更済み
- リードのマージ
- 送信済み電子メール
- キャンペーンストリームの変更
- キャンペーンに追加
有効
personKey.sourceKey 担当者 ID フィールドグループのB2B 担当者
なし
なし
第 1 の関係
listOperations.listKey.sourceKeyフィールド- タイプ：1 対 1
- 参照スキーマ：B2B マーケティングリスト
- 名前空間：B2B マーケティングリスト
2 番目の関係
opportunityEvent.opportunityKey.sourceKeyフィールド- タイプ：1 対 1
- 参照スキーマ： B2B 商談
- 名前空間：B2B 商談
第 3 の関係
leadOperation.campaignProgression.campaignKey.sourceKeyフィールド- タイプ：1 対 1
- 参照スキーマ：B2B キャンペーン
- 名前空間：B2B キャンペーン
ExperienceEvent はエンティティとは異なります。 エクスペリエンスイベントの ID は、アクティビティを実行した人です。B2B アカウント人物関係
ID マップ
有効
accountPersonKey.sourceKey 基本クラスでB2B アカウント人物関係
なし
なし
第 1 の関係
personKey.sourceKey基本クラスで- タイプ：多対 1
- 参照スキーマ： B2B 担当者
- 名前空間：B2B 担当者
- 宛先プロパティ：
b2b.personKey.SourceKey - 現在のスキーマからの関係名：人
- 参照スキーマからの関係名：アカウント
2 番目の関係
accountKey.sourceKey基本クラスで- タイプ：多対 1
- 参照スキーマ： B2B アカウント
- 名前空間：B2B アカウント
- 宛先プロパティ：
accountKey.sourceKey - 現在のスキーマからの関係名：アカウント
- 参照スキーマからの関係名： People
337b99bb-92fb-42ae-b6b7-c7042161d089