Experience Platform オーディエンスの取り込みと使用
このユースケースでは、Experience Platform オーディエンスをCustomer Journey Analyticsに取り込む暫定的なソリューションを調査します。 これらのオーディエンスは、Experience Platform セグメントビルダー、Adobe Audience Managerまたはその他のツールで作成され、リアルタイム顧客プロファイルに保存されている可能性があります。 オーディエンスは、プロファイル ID のセットと、該当する属性やイベントなどで構成されています。 そのオーディエンスデータをCustomer Journey Analyticsに取り込んで、さらに分析する必要があります。
前提条件
- Experience Platform (特にリアルタイム顧客プロファイル)にアクセスします。
- Experience Platform スキーマ および データセット を作成および管理するためのアクセス権。
- Experience Platform クエリサービス へのアクセス (および SQL の記述機能)。
- データの一部の変換を実行できるツールへのアクセス。
- Customer Journey Analytics にアクセスします。Customer Journey Analytics接続およびデータビューを作成および変更するには 0}Customer Journey Analytics製品管理者である必要があります。
- Experience Platform API (Catalog Service API および Segmentation Service API)の認証とアクセス 組織とサンドボックスの Developer Console でプロジェクトを作成し、API 呼び出しを正常に送信するために必要な情報があることを確認する必要があります。
手順
暫定的な解決策には、次の手順が含まれます。
- オーディエンスを選択(Experience Platform UI) 。
- プロファイル対応データセットの作成(Experience Platform API) 。
- オーディエンスの書き出し(Experience Platform API) 。
- 出力の変換(Experience Platform UI など) 。
- スキーマとデータセットを作成します(Experience Platform UI) 。
- 接続を追加または編集(Customer Journey Analytics UI) 。
- データビューを設定(Customer Journey Analytics UI) 。
- レポートと分析(Customer Journey Analytics UI) 。
オーディエンスを選択
ソリューションは、まず、Customer Journey Analyticsで取り込むオーディエンスを特定します。
Experience Platform UI の場合:
-
Customer/
-
参照 を選択して、Customer Journey Analyticsで取り込んで使用するオーディエンスを検索します。 後で使用するために、各オーディエンスの オーディエンス ID に注意してください。
プロファイル対応データセットの作成
コアベースの XDM 個人プロファイル スキーマに基づいてデータセットを作成する必要があります。 Experience Platform UI でデータセットを作成する場合、そのコアベースの XDM 個人プロファイルをスキーマとして選択することはできません。 代わりに、Catalog Service API を使用して、 スキーマに基づいて _xdm.context.profile__union
データセットを作成します。
リクエスト
code language-shell |
---|
|
次のとおりです。
DATASET_NAME
は、データセットのわかりやすい名前です。 例:Segment Export Job Dataset for CJA
。
応答
code language-json |
---|
|
次のとおりです。
DATASET_ID
は、作成されたデータセットのデータセット識別子です。
オーディエンスを書き出し
選択したオーディエンスを先ほど作成したデータセットに書き出します。 Segmentation Service API を使用して、オーディエンスをデータセットに送信する書き出しジョブ を作成します。
code language-shell |
---|
|
ここで、
COMMA_SEPARATED_LIST_OF_FULLY_QUALIFIED_FIELD_NAMES
のようなもので_demoemea.identification.core.ecid, _demoemea.identification.core.email, _demoemea.identification.core.phoneNumber, person.gender, person.name.firstName, person.name.lastName
ょう。 カスタマージャーニー分析で使用する少なくとも関連するフィールド(ユーザー ID (メール)など)を含めてください。- 書き出すオーディエンスのオーディエンス識別子は
AUDIENCE_ID_x
のとおりです。 DATASET_ID
が作成したデータセットです。
応答
code language-json |
---|
|
ここで、
EXPORT_JOB_ID
は、エクスポートジョブの識別子です。
Segmentation Service API を使用して、書き出しジョブのステータスを確認 します。
リクエスト
code language-shell |
---|
|
応答
code language-json |
---|
|
書き出しジョブが成功したら、データセットに正常に取り込まれたバッチが含まれているかどうかを確認します。
Experience Platform UI の場合:
-
データ管理/
-
作成したデータセットを選択します(例:CJAのセグメント書き出しジョブデータセット。
-
取り込んだバッチを検証します。 データセットに失敗したバッチが含まれている場合は、データ管理/
-
データセットの テーブル名 をコピーします。 例:segment_export_job_dataset_for_cja。 その名前は、次の手順で使用します。
出力の変換
データセットのデータがCustomer Journey Analyticsに対して正しい形式ではありません。 データを変換するには、Experience Platform クエリサービスを使用してデータを取得します。
Experience Platform クエリサービスに接続する PSQL クライアントを使用します。
Experience Platform UI の場合:
- データ管理/
-
資格情報を使用して、Customer Journey Analytics クエリサービスに接続するように PSQL クライアントを設定します。
クエリ
次のクエリを実行して、データセットからオーディエンスデータを取得します。
code language-sql |
---|
|
次のとおりです。
IDENTITY_TO_USE_AS_PERSON_ID
は、書き出しジョブの一部として定義したフィールドの 1 つです。 例:_demoemea.identification.core.email
。DATASET_TABLE_NAME
は、データセットのテーブル名です。- エクスポートジョブの一部として定義したオーディエンスは
AUDIENCE_ID_x
のとおりです。 エクスポートジョブの仕様は行レベルのフィルターなので、これらのオーディエンスをもう一度指定する必要があります。 この行レベルのフィルターは、指定したセグメントのプロファイルと、各プロファイルのすべてのセグメントメンバーシップを返します。
結果
JSON 形式でのクエリ結果は次のようになります。
code language-json |
---|
|
次のとおりです。
- 人物 ID として使用したい識別子の識別子の値を
PERSON_ID_x
します。 例えば、メールを使用する場合はjohn.doe@gmail.com
です。 - オーディエンス識別子は
AUDIENCE_ID_x
のとおりです。
この JSON データを変換して環境のテナント名を追加し、オーディエンスにわかりやすい名前を付ける必要があります。
最終的な JSON は次のようになります。
code language-json |
---|
|
次のとおりです。
TENANT_NAME
はテナントの名前です。 例:_demoemea
。- 人物 ID
PERSON_ID_x
して使用する識別子の識別子の値です。 例えば、メールを使用する場合はjohn.doe@gmail.com
です。 - オーディエンス識別子は
AUDIENCE_ID_x
のとおりです。 - オーディエンス id には、わかりやすいオーディエンス名を
AUDIENCE_FRIENDLY_NAME_x
します。 例:Luma - Blue+ Members
。
お気に入りのツールを使用して、元の JSON をこの形式に変換します。
スキーマとデータセットの作成
変換された JSON を書き出されたオーディエンスデータとしてCustomer Journey Analyticsで使用するには、専用のスキーマを作成する必要があります。
スキーマを作成するには:
Experience Platform UI の場合:
-
データ管理/
-
-
スキーマを作成 ダイアログで 手動 を選択し、選択 を使用して続行します。
-
スキーマを作成 ウィザードの クラスを選択 手順で、次の操作を行います。
- 個人プロファイル を選択します。
- 「次へ」を選択します。
-
スキーマを作成 ウィザードの 名前とレビュー 手順で、次の操作を行います。
- スキーマ表示名 を入力します。 例:
Audience Export for CJA Schema
。 - (オプション)「説明」を入力します。
- 「完了」を選択します。
- スキーマ表示名 を入力します。 例:
-
audienceMembershipId および audienceMembershipName という 2 つのフィールドを含むカスタムフィールドグループ(例えば、Audience Membership)を含むようにスキーマを設定します。
-
personID フィールドが ID、プライマリ ID であり、I dentity 名前空間 として メール を持っていることを確認します。
-
適用 すべての変更。 「保存」を選択してスキーマを保存します。
データセットを作成し、そのデータセットを使用して、変換後の JSON データを取り込みます。
Experience Platform UI の場合:
-
データ管理/
-
-
「スキーマからデータセットを作成」をクリックします。
-
スキーマからデータセットを作成 ウィザードの スキーマを選択 手順で、次の操作を行います。
- 作成したスキーマを選択します。 例:CJA スキーマのオーディエンスの書き出し。
- 「次へ」を選択します。
-
スキーマからデータセットを作成 ウィザードの データセットを設定 手順で、次の操作を行います。
- データセットの 名前 を入力します。
- (任意)データセットの 説明 を入力します。
- 「完了」を選択します。
-
データセット/データセットの名前 で、変換後の JSON データファイルをドラッグし、ファイルをドラッグ&ドロップ にドロップします。 このアクションは、書き出された JSON データのデータセットへの取り込みを開始します。
-
取り込んだバッチを検証します。 データセットに失敗したバッチが含まれている場合は、データ管理/
接続の追加または編集
Experience Platformからのオーディエンスデータを含む変換された JSON データが正常に取り込まれたら、Customer Journey Analyticsの新しい接続または既存の接続にデータセットを追加できます。
Customer Journey Analytics UI で、次の操作を行います。
-
データ管理/接続 を選択します。
-
新しい接続を作成/定義 接続設定 および データ設定。 または、既存の接続を選択し、
-
-
作成し、変換後の JSON データを取り込んだデータセットを選択します。
-
データセットを設定します。 例:
-
保存 接続。
データビューの設定
作成または編集したばかりの接続のデータビューを設定します。
-
データ管理/データビュー を選択します。
-
既存のデータビューを編集するか、新しいデータビューを作成します。
-
データビューの コンポーネント タブで、オーディエンスメンバーシップ ID と オーディエンスメンバーシップ名 がディメンションコンポーネントとして追加されていることを確認します。
-
「保存して続行」を選択して、データビューを保存します。
レポートと分析
最後に、Analysis Workspaceを使用して、audienceMembershipId
、audienceMembershipIdName
、personID
などのオーディエンスメンバーシップコンポーネントと共にデータビューを使用する 1 つ以上のパネルで、Experience Platform オーディエンスデータについてレポートします。
追加情報
-
このプロセスは、定期的に実行して、Customer Journey Analytics内でオーディエンスデータが常に更新されるようにする必要があります。
-
1 つのCustomer Journey Analytics接続内で複数のオーディエンスを読み込むことができます。 これは、プロセスがさらに複雑になりますが、可能です。これを機能させるには、前述のプロセスに少し修正を加える必要があります。
- RTCP 内のオーディエンスコレクションの目的の各オーディエンスに対して、このプロセスを実行します。
- Customer Journey Analyticsは、プロファイルデータセットの配列/オブジェクト配列をサポートします。 または に対して
audienceMembershipId
オブジェクトの配列audienceMembershipIdName
を使用するのが最適なオプションです。 - データビューで、
audienceMembershipId
フィールドの部分文字列変換を使用して、新しいディメンションを作成し、コンマ区切り値の文字列を配列に変換します。メモ:現在、配列の値は 10 個までという制限があります。 - Customer Journey Analytics Workspace内で、この新しいディメンション
audienceMembershipIds
についてレポートできるようになりました。