外部オーディエンスの読み込みと使用

IMPORTANT
このドキュメントには、以前のバージョンの Audiences ドキュメントからの情報が含まれているので、最新ではありません。

Adobe Experience Platformは、外部オーディエンスをインポートする機能をサポートしています。これは、その後、新しいオーディエンスのコンポーネントとして使用できます。 このドキュメントでは、外部オーディエンスをインポートして使用するExperience Platformを設定するためのチュートリアルを提供します。

はじめに

このチュートリアルでは、 Adobe Experience Platform オーディエンスの作成に関係するサービス。 このチュートリアルを開始する前に、次のサービスのドキュメントを確認してください。

オーディエンスとセグメント定義

外部オーディエンスのインポートと使用を開始する前に、オーディエンスとセグメント定義の違いを理解しておくことが重要です。

オーディエンスとは、フィルタリング対象のプロファイルのグループを指します。 セグメント定義を使用する場合、セグメント認定条件を満たすサブセットにプロファイルをフィルタリングするセグメント定義を作成して、オーディエンスを作成できます。

セグメント定義には、名前、説明、式(該当する場合)、作成日、最終変更日、ID などの情報が含まれます。 ID は、セグメントメタデータを、セグメントの認定を満たし、結果として得られるオーディエンスの一部となる個々のプロファイルにリンクします。

オーディエンス
セグメント定義
検索しようとしているプロファイルのグループ。 セグメント定義を使用する場合、これは、セグメント認定を満たすプロファイルのグループになることを意味します。
探しているオーディエンスのセグメント化に使用されるルールのグループ。

外部オーディエンス用の ID 名前空間の作成

外部オーディエンスを使用する最初の手順は、ID 名前空間を作成することです。 ID 名前空間を使用すると、Platform はオーディエンスの元となる場所を関連付けることができます。

ID 名前空間を作成するには、 id 名前空間ガイド. ID 名前空間を作成する際に、ソースの詳細を ID 名前空間に追加し、その ID 名前空間をマークします タイプ as a 人以外の識別子.

非個人識別子は、「 ID 名前空間を作成」モーダルでハイライト表示されます。

セグメントメタデータのスキーマの作成

ID 名前空間を作成したら、作成するセグメント用に新しいスキーマを作成する必要があります。

スキーマの構成を開始するには、まず「 」を選択します。 スキーマ 左側のナビゲーションバーで、 スキーマを作成 を使用して、スキーマワークスペースの右上隅に表示します。 ここからを選択します。 参照 をクリックして、使用可能なスキーマタイプの完全な選択を確認します。

「スキーマを作成」と「参照」の両方がハイライト表示されます。

事前に定義されたクラスであるセグメント定義を作成するので、「 」を選択します。 既存のクラスを使用. 次に、 セグメント定義 クラス、その後に クラスを割り当て.

セグメント定義クラスがハイライト表示されます。

スキーマが作成されたので、セグメント 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
データセット ID 必須 先ほど作成したスキーマ用に前に作成したデータセットを参照します。
xdmEntity._id
ID 必須 外部オーディエンスと同じセグメント ID を参照します。
xdmEntity.identityMap
この節 必須 には、以前に作成した名前空間の作成時に使用する id ラベルが含まれます。
{IDENTITY_NAMESPACE}
これは、以前に作成した ID 名前空間のラベルです。 例えば、ID 名前空間を「externalAudience」と呼ぶ場合は、それを配列のキーとして使用します。
segmentName
外部オーディエンスをセグメント化するセグメントの名前。

インポートしたオーディエンスを使用したセグメントの作成

インポートしたオーディエンスを設定したら、セグメント化プロセスの一部として使用できます。 外部オーディエンスを検索するには、セグメントビルダーに移動して、 オーディエンス 」タブをクリックします。 フィールド 」セクションに入力します。

セグメントビルダー内の外部オーディエンスセレクターが強調表示されます。

次の手順

これで、セグメントで外部オーディエンスを使用できるようになったので、セグメントビルダーを使用してセグメントを作成できます。 セグメントの作成方法については、 セグメントの作成に関するチュートリアル.

付録

読み込まれた外部オーディエンスメタデータを使用し、それらを使用してセグメントを作成する以外に、外部セグメントメンバーシップを Platform に読み込むこともできます。

外部セグメントメンバーシップの宛先スキーマの設定

スキーマの構成を開始するには、まず「 」を選択します。 スキーマ 左側のナビゲーションバーで、 スキーマを作成 を使用して、スキーマワークスペースの右上隅に表示します。 ここからを選択します。 XDM 個人プロファイル.

「 XDM Individual Profile 」領域がハイライト表示されます。

スキーマが作成されたので、セグメントメンバーシップフィールドグループをスキーマの一部として追加する必要があります。 それには、「 」を選択します。 セグメントメンバーシップの詳細に続いて フィールドグループを追加.

「セグメントメンバーシップの詳細」フィールドグループがハイライト表示されます。

さらに、スキーマが プロファイル. これをおこなうには、フィールドをプライマリ 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
データセット ID 必須 先ほど作成したメンバーシップスキーマの、前に作成したデータセットを参照します。
xdmEntity._id
データセット内のレコードを一意に識別するために使用される適切な ID です。
{TENANT_NAME}.identities
このセクションは、カスタム ID のフィールドグループを、以前読み込んだユーザーと接続するために使用します。
segmentMembership.{IDENTITY_NAMESPACE}
これは、以前に作成したカスタム ID 名前空間のラベルです。 例えば、ID 名前空間を「externalAudience」と呼ぶ場合は、それを配列のキーとして使用します。
NOTE
デフォルトでは、外部オーディエンスのメンバーシップは 30 日後に削除されます。 削除を防ぎ、30 日以上保持する場合は、 validUntil フィールドに値を入力する必要があります。 このフィールドの詳細については、 セグメントメンバーシップの詳細スキーマフィールドグループ.
recommendation-more-help
770bc05d-534a-48a7-9f07-017ec1e14871