外部オーディエンスの読み込みと使用
Adobe Experience Platformは、外部オーディエンスをインポートする機能をサポートしています。これは、その後、新しいオーディエンスのコンポーネントとして使用できます。 このドキュメントでは、外部オーディエンスをインポートして使用するExperience Platformを設定するためのチュートリアルを提供します。
はじめに
このチュートリアルでは、 Adobe Experience Platform オーディエンスの作成に関係するサービス。 このチュートリアルを開始する前に、次のサービスのドキュメントを確認してください。
- セグメント化サービス:リアルタイム顧客プロファイルデータからオーディエンスを構築できます。
- リアルタイム顧客プロファイル:複数のソースから集計したデータに基づいて、統合されたリアルタイムの顧客プロファイルを提供します。
- エクスペリエンスデータモデル (XDM):Platform が顧客体験データを整理する際に使用する標準化されたフレームワーク。 セグメント化を最大限に活用するには、データモデリングのベストプラクティスに従って、データがプロファイルとイベントとして取り込まれていることを確認してください。
- データセット:Experience Platform のデータ永続化のためのストレージと管理の構成。
- ストリーミング取得:Experience Platformがクライアントサイドおよびサーバーサイドのデバイスからデータをリアルタイムで取得し、保存する方法。
オーディエンスとセグメント定義
外部オーディエンスのインポートと使用を開始する前に、オーディエンスとセグメント定義の違いを理解しておくことが重要です。
オーディエンスとは、フィルタリング対象のプロファイルのグループを指します。 セグメント定義を使用する場合、セグメント認定条件を満たすサブセットにプロファイルをフィルタリングするセグメント定義を作成して、オーディエンスを作成できます。
セグメント定義には、名前、説明、式(該当する場合)、作成日、最終変更日、ID などの情報が含まれます。 ID は、セグメントメタデータを、セグメントの認定を満たし、結果として得られるオーディエンスの一部となる個々のプロファイルにリンクします。
外部オーディエンス用の ID 名前空間の作成
外部オーディエンスを使用する最初の手順は、ID 名前空間を作成することです。 ID 名前空間を使用すると、Platform はオーディエンスの元となる場所を関連付けることができます。
ID 名前空間を作成するには、 id 名前空間ガイド. ID 名前空間を作成する際に、ソースの詳細を ID 名前空間に追加し、その ID 名前空間をマークします タイプ as a 人以外の識別子.
セグメントメタデータのスキーマの作成
ID 名前空間を作成したら、作成するセグメント用に新しいスキーマを作成する必要があります。
スキーマの構成を開始するには、まず「 」を選択します。 スキーマ 左側のナビゲーションバーで、 スキーマを作成 を使用して、スキーマワークスペースの右上隅に表示します。 ここからを選択します。 参照 をクリックして、使用可能なスキーマタイプの完全な選択を確認します。
事前に定義されたクラスであるセグメント定義を作成するので、「 」を選択します。 既存のクラスを使用. 次に、 セグメント定義 クラス、その後に クラスを割り当て.
スキーマが作成されたので、セグメント ID を含むフィールドを指定する必要があります。 このフィールドをプライマリ ID としてマークし、以前に作成した名前空間に割り当てる必要があります。
をマークした後 _id
「 」フィールドをプライマリ id として、スキーマのタイトルを選択し、「 」というラベルの付いた切り替えを選択します。 プロファイル. 選択 有効にする スキーマを有効にするには Real-Time Customer Profile.
これで、このスキーマがプロファイルに対して有効になり、作成した個人以外の ID 名前空間にプライマリ ID が割り当てられます。 その結果、このスキーマを使用して Platform に読み込まれたセグメントメタデータは、他の人関連のプロファイルデータと結合されずに、プロファイルに取り込まれます。
スキーマのデータセットの作成
スキーマを設定した後、セグメントメタデータのデータセットを作成する必要があります。
データセットを作成するには、 データセットユーザーガイド. 次の手順に従う必要があります。 スキーマからデータセットを作成 」オプションに値を指定します。
データセットの作成後、 データセットユーザーガイド をクリックして、リアルタイム顧客プロファイルに対してこのデータセットを有効にします。
オーディエンスデータの設定とインポート
データセットを有効にした場合、UI を使用して、またはExperience PlatformAPI を使用して、データを Platform に送信できるようになりました。 このデータは、バッチ接続またはストリーミング接続を使用して取り込むことができます。
バッチ接続を使用したデータの取得
バッチ接続を作成するには、汎用の ローカルファイルアップロード UI ガイド. データの取り込みに使用できる利用可能なソースの完全なリストについては、 ソースの概要.
ストリーミング接続を使用したデータの取り込み
ストリーミング接続を作成するには、次のいずれかの手順に従います: API チュートリアル または UI チュートリアル.
ストリーミング接続を作成したら、固有のストリーミングエンドポイントにアクセスし、データの送信先にすることができます。 これらのエンドポイントにデータを送信する方法については、 レコードデータのストリーミングに関するチュートリアル.
オーディエンスのメタデータ構造
接続を作成した後、データを Platform に取り込めるようになりました。
外部オーディエンスペイロードのメタデータの例を以下に示します。
{
"header": {
"schemaRef": {
"id": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
"contentType": "application/vnd.adobe.xed-full+json;version=1"
},
"imsOrgId": "{ORG_ID}",
"datasetId": "{DATASET_ID}",
"source": {
"name": "Sample External Audience"
}
},
"body": {
"xdmMeta": {
"schemaRef": {
"id": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
"contentType": "application/vnd.adobe.xed-full+json;version=1"
}
},
"xdmEntity": {
"_id": "{SEGMENT_ID}",
"description": "Sample description",
"identityMap": {
"{IDENTITY_NAMESPACE}": [{
"id": "{}"
}]
},
"segmentName" : "{SEGMENT_NAME}",
"segmentStatus": "ACTIVE",
"version": "1.0"
}
}
}
schemaRef
datasetId
xdmEntity._id
xdmEntity.identityMap
{IDENTITY_NAMESPACE}
segmentName
インポートしたオーディエンスを使用したセグメントの作成
インポートしたオーディエンスを設定したら、セグメント化プロセスの一部として使用できます。 外部オーディエンスを検索するには、セグメントビルダーに移動して、 オーディエンス 」タブをクリックします。 フィールド 」セクションに入力します。
次の手順
これで、セグメントで外部オーディエンスを使用できるようになったので、セグメントビルダーを使用してセグメントを作成できます。 セグメントの作成方法については、 セグメントの作成に関するチュートリアル.
付録
読み込まれた外部オーディエンスメタデータを使用し、それらを使用してセグメントを作成する以外に、外部セグメントメンバーシップを Platform に読み込むこともできます。
外部セグメントメンバーシップの宛先スキーマの設定
スキーマの構成を開始するには、まず「 」を選択します。 スキーマ 左側のナビゲーションバーで、 スキーマを作成 を使用して、スキーマワークスペースの右上隅に表示します。 ここからを選択します。 XDM 個人プロファイル.
スキーマが作成されたので、セグメントメンバーシップフィールドグループをスキーマの一部として追加する必要があります。 それには、「 」を選択します。 セグメントメンバーシップの詳細に続いて フィールドグループを追加.
さらに、スキーマが プロファイル. これをおこなうには、フィールドをプライマリ ID としてマークする必要があります。
データセットの設定
スキーマを作成したら、データセットを作成する必要があります。
データセットを作成するには、 データセットユーザーガイド. 次の手順に従う必要があります。 スキーマからデータセットを作成 」オプションに値を指定します。
データセットの作成後、 データセットユーザーガイド をクリックして、リアルタイム顧客プロファイルに対してこのデータセットを有効にします。
外部オーディエンスメンバーシップデータの設定とインポート
データセットを有効にした場合、UI を使用して、またはExperience PlatformAPI を使用して、データを Platform に送信できるようになりました。 このデータは、バッチ接続またはストリーミング接続を使用して取り込むことができます。
バッチ接続を使用したデータの取得
バッチ接続を作成するには、汎用の ローカルファイルアップロード UI ガイド. データの取り込みに使用できる利用可能なソースの完全なリストについては、 ソースの概要.
ストリーミング接続を使用したデータの取り込み
ストリーミング接続を作成するには、次のいずれかの手順に従います: API チュートリアル または UI チュートリアル.
ストリーミング接続を作成したら、固有のストリーミングエンドポイントにアクセスし、データの送信先にすることができます。 これらのエンドポイントにデータを送信する方法については、 レコードデータのストリーミングに関するチュートリアル.
セグメントメンバーシップの構造
接続を作成した後、データを Platform に取り込めるようになりました。
外部オーディエンスメンバーシップペイロードの例を以下に示します。
{
"header": {
"schemaRef": {
"id": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
"contentType": "application/vnd.adobe.xed-full+json;version=1"
},
"imsOrgId": "{ORG_ID}",
"datasetId": "{DATASET_ID}",
"source": {
"name": "Sample External Audience Membership"
}
},
"body": {
"xdmMeta": {
"schemaRef": {
"id": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
"contentType": "application/vnd.adobe.xed-full+json;version=1"
}
},
"xdmEntity": {
"_id": "{UNIQUE_ID}",
"description": "Sample description",
"{TENANT_NAME}": {
"identities": {
"{SCHEMA_IDENTITY}": "sample-id"
}
},
"personId" : "sample-name",
"segmentMembership": {
"{IDENTITY_NAMESPACE}": {
"{EXTERNAL_IDENTITY}": {
"status": "realized",
"lastQualificationTime": "2022-03-14T:00:00:00Z"
}
}
}
}
}
}
schemaRef
datasetId
xdmEntity._id
{TENANT_NAME}.identities
segmentMembership.{IDENTITY_NAMESPACE}
validUntil
フィールドに値を入力する必要があります。 このフィールドの詳細については、 セグメントメンバーシップの詳細スキーマフィールドグループ.