B2B 名前空間とスキーマ
-
B2B スキーマを リアルタイム顧客プロファイル で選定するには、Adobe Real-Time Customer Data Platform B2B editionへのアクセス権が必要です。
-
2026年1月以降、Real-Time CDP B2B editionでは、B2B エンティティ間の 非標準 関係がサポートされなくなります。 したがって、B2B名前空間およびスキーマガイド に記載されている標準の関係を使用するように、B2B エンティティを更新することをお勧めします。
このドキュメントでは、B2B ソースで使用するネームスペースとスキーマの基礎となる設定について説明します。 このドキュメントでは、B2B ネームスペースとスキーマの生成に必要なPostman オートメーション ユーティリティの設定に関する詳細も説明します。
B2B名前空間とスキーマ自動生成ユーティリティを設定する
B2B名前空間およびスキーマ自動生成ユーティリティをサポートするようにPostman環境を設定する方法の前提条件については、次のドキュメントを参照してください。
- 名前空間とスキーマ自動生成ユーティリティのコレクションと環境は、このGitHub リポジトリ からダウンロードできます。
- 必要なヘッダーの値を収集し、サンプル API呼び出しを読み取る方法など、Experience Platform APIの使用方法について詳しくは、Experience Platform APIの概要に関するガイドを参照してください。
- Experience Platform APIの資格情報を生成する方法について詳しくは、Experience Platform APIの認証とアクセス に関するチュートリアルを参照してください。
- Experience Platform API用のPostmanの設定方法について詳しくは、開発者向けコンソールの設定および Postmanに関するチュートリアルを参照してください。
Experience Platform開発者コンソールとPostmanの設定が完了したら、Postman環境に適切な環境値を適用できるようになりました。
次の表は、値の例と、Postman環境の入力に関する追加情報を示しています。
CLIENT_SECRET{ACCESS_TOKEN}の生成に使用される一意のID。 の取得方法について詳しくは、Experience Platform APIの認証とアクセス {CLIENT_SECRET}に関するチュートリアルを参照してください。{CLIENT_SECRET}API_KEY{API_KEY}に関するチュートリアルを参照してください。c8d9a2f5c1e03789bd22e8efdd1bdc1bACCESS_TOKEN{ACCESS_TOKEN}に関するチュートリアルを参照してください。Bearer {ACCESS_TOKEN}META_SCOPEent_dataservices_sdkに設定されます。ent_dataservices_sdkCONTAINER_IDglobal コンテナには、標準のAdobeおよびExperience Platform パートナーが提供するすべてのクラス、スキーマフィールドグループ、データタイプ、スキーマが格納されます。 Marketoに関しては、この値は固定され、常にglobalに設定されます。globalTECHNICAL_ACCOUNT_IDAdobe Developer Consoleへの統合に使用される資格情報。 テクニカルアカウント IDを取得するには、次の手順に従います。
- Adobe Developer Consoleに移動し、プロジェクトを開きます。
- サービスアカウント （JWT）を使用する 資格情報 を開きます。 注：古いUIでは「エンタープライズ」と呼ばれることがあります。
- 資格情報の詳細には、クライアント ID、テクニカルアカウント ID、組織ID、その他のJWT メタデータが表示されます。
。
D42AEVJZTTJC6LZADUBVPA15@techacct.adobe.comIMSims-na1.adobelogin.comに設定されます。ims-na1.adobelogin.comIMS_ORG{ORG_ID}に関するチュートリアルを参照してください。ABCEH0D9KX6A7WA7ATQE0TE@adobeOrgSANDBOX_NAMEprodTENANT_IDb2bcdpproductiontestPLATFORM_URLplatform.adobe.io/に設定されます。platform.adobe.io/スクリプトの実行
Postman コレクションと環境を設定したら、Postman インターフェイスを使用してスクリプトを実行できるようになりました。
Postman インターフェイスで、自動生成ユーティリティのルート フォルダーを選択し、上部ヘッダーから Run を選択します。
Runner インターフェイスが表示されます。 ここから、すべてのチェックボックスが選択されていることを確認し、Run Namespaces and Schemas Autogeneration Utilityを選択します。
リクエストが成功すると、B2Bに必要な名前空間とスキーマが作成されます。
B2B名前空間
ID名前空間は、IDのコンテキストを区別するのに役立つIdentity Serviceのコンポーネントです。 完全修飾IDには、ID値と名前空間が含まれます。 詳しくは、名前空間の概要を参照してください。
B2B名前空間は、エンティティのプライマリ IDで使用されます。
次の表に、B2B名前空間の基になる設定に関する情報を示します。
b2b_personCROSS_DEVICEb2b_accountB2B_ACCOUNTb2b_opportunityB2B_OPPORTUNITYb2b_opportunity_person_relationB2B_OPPORTUNITY_PERSONb2b_campaignB2B_CAMPAIGNb2b_campaign_memberB2B_CAMPAIGN_MEMBERb2b_marketing_listB2B_MARKETING_LISTb2b_marketing_list_memberB2B_MARKETING_LIST_MEMBERb2b_account_person_relationB2B_ACCOUNT_PERSONB2B スキーマ
Experience Platform では、スキーマを使用して、一貫性のある再利用可能な方法でデータの構造を記述します。システムをまたいで一貫したデータを定義することで、意味を保有しやすくなり、データから価値を得ることができます。
データをExperience Platformに取り込む前に、データの構造を説明するスキーマを作成し、各フィールドに含めることができるデータタイプに制約を与える必要があります。 スキーマは、基本クラスと 0 個以上のスキーマフィールドグループで構成されます。
デザインの原則やベストプラクティスなど、スキーマ構成モデルについて詳しくは、スキーマ構成の基本を参照してください。
次の表に、B2B スキーマの基礎となる設定に関する情報を示します。
accountKey.sourceKeyextSourceSystemAudit.externalKey.sourceKey- XDM ビジネスアカウント詳細フィールドグループの
accountParentKey.sourceKey - 宛先プロパティ：
/accountKey/sourceKey - タイプ：1対1
- 参照スキーマ：B2B アカウント
- 名前空間：B2B アカウント
- XDM ビジネスパーソンの詳細
- XDM ビジネスパーソンのコンポーネント
- identityMap
- 同意と環境設定の詳細
b2b.personKey.sourceKey- XDM ビジネス担当者詳細フィールド グループの
extSourceSystemAudit.externalKey.sourceKey - XDM ビジネス担当者詳細フィールド グループの
workEmail.address
- B2B人物
- メール
- XDM ビジネス担当者コンポーネント フィールド グループの
personComponents.sourceAccountKey.sourceKey - タイプ：多対一
- 参照スキーマ：B2B アカウント
- 名前空間：B2B アカウント
- 宛先プロパティ：accountKey.sourceKey
- 現在のスキーマからの関係名：アカウント
- 参照スキーマからの関係名：人物
opportunityKey.sourceKeyextSourceSystemAudit.externalKey.sourceKey- 基本クラスの
accountKey.sourceKey - タイプ：多対一
- 参照スキーマ：B2B アカウント
- 名前空間：B2B アカウント
- 宛先プロパティ：
accountKey.sourceKey - 現在のスキーマからの関係名：アカウント
- 参照スキーマからの関係名：商談
opportunityPersonKey.sourceKey最初の関係
- 基本クラスの
personKey.sourceKey - タイプ：多対一
- 参照スキーマ：B2B人物
- 名前空間：B2B Person
- 宛先プロパティ：b2b.personKey.sourceKey
- 現在のスキーマからの関係名：人物
- 参照スキーマからの関係名：商談
2番目の関係
- 基本クラスの
opportunityKey.sourceKey - タイプ：多対一
- リファレンススキーマ：B2B Opportunity
- 名前空間：B2B オポチュニティ
- 宛先プロパティ：
opportunityKey.sourceKey - 現在のスキーマからの関係名：商談
- 参照スキーマからの関係名：人物
ccampaignMemberKey.sourceKey最初の関係
- 基本クラスの
personKey.sourceKey - タイプ：多対一
- 参照スキーマ：B2B人物
- 名前空間：B2B Person
- 宛先プロパティ：
b2b.personKey.sourceKey - 現在のスキーマからの関係名：人物
- 参照スキーマからの関係名：Campaigns
2番目の関係
- 基本クラスの
campaignKey.sourceKey - タイプ：多対一
- リファレンススキーマ：B2B キャンペーン
- 名前空間：B2B キャンペーン
- 宛先プロパティ：
campaignKey.sourceKey - 現在のスキーマからの関係名：Campaign
- 参照スキーマからの関係名：人物
marketingListKey.sourceKeymarketingListMemberKey.sourceKey最初の関係
- 基本クラスの
PersonKey.sourceKey - タイプ：多対一
- 参照スキーマ：B2B人物
- 名前空間：B2B Person
- 宛先プロパティ：
b2b.personKey.sourceKey - 現在のスキーマからの関係名：人物
- 参照スキーマからの関係名：マーケティングリスト
2番目の関係
- 基本クラスの
marketingListKey.sourceKey - タイプ：多対一
- リファレンススキーマ：B2B マーケティングリスト
- 名前空間：B2B マーケティングリスト
- 宛先プロパティ：
marketingListKey.sourceKey - 現在のスキーマからの関係名：マーケティングリスト
- 参照スキーマからの関係名：人物
accountPersonKey.sourceKey最初の関係
- 基本クラスの
personKey.sourceKey - タイプ：多対一
- 参照スキーマ：B2B人物
- 名前空間：B2B Person
- 宛先プロパティ：
b2b.personKey.SourceKey - 現在のスキーマからの関係名：人物
- 参照スキーマからの関係名：アカウント
2番目の関係
- 基本クラスの
accountKey.sourceKey - タイプ：多対一
- 参照スキーマ：B2B アカウント
- 名前空間：B2B アカウント
- 宛先プロパティ：
accountKey.sourceKey - 現在のスキーマからの関係名：アカウント
- 参照スキーマからの関係名：人物
次の手順
Marketo データをExperience Platformに接続する方法については、UIでのMarketo ソースコネクタの作成に関するチュートリアルを参照してください。