Real-time Customer Profile API ガイド

Real-time Customer Profile を使用すると、Adobe Experience Platform内の各顧客の全体像を確認できます。Profile では、オンライン、オフライン、CRM、サードパーティなど、複数のチャネルの異なる顧客データを統合ビューに統合し、顧客とのやり取りごとに実用的なタイムスタンプ付きの説明を提供できます。

Real-time Customer Profile API には、次に示すように、複数のエンドポイントが含まれています。 詳しくは、個々のエンドポイントのガイドを参照し、必要なヘッダー、サンプル API 呼び出しの読み取りなどに関する重要な情報については、はじめにのガイドを参照してください。

使用可能なすべてのエンドポイントと CRUD 操作を表示するには、「 リアルタイム顧客プロファイル API リファレンス」スウォッチ を参照してください。

Experience Platform UI での Real-time Customer Profile データの操作に関するガイドについては、 プロファイルユーザーガイド を参照してください。

(アルファ版)計算済み属性

重要

計算済み属性機能はアルファ版であり、一部のユーザーが使用できます。ドキュメントと機能は変更される場合があります。

計算済み属性は、イベントレベルのデータをプロファイルレベルの属性に集計するために使用される関数です。これらの関数は自動的に計算され、セグメント化、アクティブ化およびパーソナライズ機能で使用できます。

各計算済み属性には、受信データを評価し、結果の値をプロファイル属性に保存する式(「ルール」)が含まれます。 これらの計算により、ライフタイム購入値、購入間隔、アプリケーションを開いた数などに関する質問に簡単に答えることができます。情報が必要になるたびに複雑な計算を手動で実行する必要はありません。これらの計算済み属性値は、その後、プロファイルで表示したり、セグメントの作成に使用したり、様々なアクセスパターンを使用してアクセスしたりできます。

計算済み属性の作成、表示、編集および削除は、config/computedAttributes エンドポイントを使用して行うことができます。 計算済み属性の使用方法については、 計算済み属性の概要 を参照してください。 API 操作については、 計算済み属性 API エンドポイントガイド を参照してください。

エッジ投影

Adobe Experience Platform を使用すると、「エッジ」と呼ばれる戦略的に配置されたサーバー上のデータに容易にアクセスして、顧客体験をリアルタイムでパーソナライズできます。Real-time Customer Profile API は、「投影」と呼ばれるコンポーネントを介してエッジを操作するためのエンドポイントを提供します。 これには、各エッジに投影するデータを決定する投影設定や、投影のルーティング先を定義する投影先が含まれます。エッジ投影の操作について詳しくは、「 投影設定と宛先エンドポイントのガイド 」を参照してください。

エンティティ(Profile アクセス)

Adobe Experience Platformを通じて、RESTful API またはユーザーインターフェイスを使用して Real-time Customer Profile データにアクセスできます。 API を使用して、「プロファイル」と呼ばれるエンティティにアクセスする方法を学ぶには、『 エンティティエンドポイントガイド 』で概要を説明する手順に従います。 Platform UI を使用してプロファイルにアクセスするには、『 プロファイルユーザガイド 』を参照してください。

書き出しジョブ(Profile 書き出し)

Real-time Customer Profile データは、データセットにエクスポートして、アクティベーション用のオーディエンスセグメントのエクスポートやレポート用のプロファイル属性など、さらに処理することができます。オーディエンスセグメントの書き出しジョブは Adobe Experience Platform Segmentation Service API の一部です。詳しくは、 セグメント化の書き出しジョブエンドポイントに関するガイド を参照してください。 プロファイル属性の書き出しジョブを作成および管理する手順については、『 書き出しジョブエンドポイントガイド 』を参照してください。

結合ポリシー

Experience Platform で複数のソースのデータを統合する場合、結合ポリシーとは、データの優先順位付け方法と、個々の顧客プロファイルを作成するために組み合わされるデータを決定する際に Platform で使用されるルールです。 Real-time Customer Profile API を使用して、新しい結合ポリシーの作成、既存のポリシーの管理、組織のデフォルトの結合ポリシーの設定を行うことができます。 を使用して結合ポリシーを使用するには、結合ポリシー API エンドポイントガイドを参照してください。

結合ポリシーと Platform 内での役割について詳しくは、まず 結合ポリシーの概要 を読んでください。

プレビューサンプルのステータス(Profile プレビュー)

データが Platform に取り込まれると、サンプルジョブが実行され、プロファイル数やその他のリアルタイム顧客プロファイルデータ関連指標が更新されます。 このサンプルジョブの結果は、リアルタイム顧客プロファイル API の一部である /previewsamplestatus エンドポイントを使用して確認できます。 また、このエンドポイントは、データセットと ID 名前空間の両方によるプロファイル配分のリストを作成したり、複数のレポートを生成して組織のプロファイルストアの構成を明確に把握したりするのにも使用できます。 /profilepreviewstatus エンドポイントの使用を開始するには、『 プレビューのサンプルステータスエンドポイントガイド 』を参照してください。

プロファイルシステムジョブ

Platform に取り込まれたプロファイル対応データは、Data Lake および Real-time Customer Profile データストアに保存されます。 不要になったデータやエラーで追加されたデータを削除するために、 Profile ストアからデータセットやバッチを削除する必要が生じる場合があります。 これには、API を使用して Profile System Job(「delete request」とも呼ばれる)を作成する必要があります。必要に応じて、この を変更、監視または削除できます。 Real-time Customer Profile API の /system/jobs エンドポイントを使用して削除リクエストを操作する方法を学ぶには、『 プロファイルシステムジョブエンドポイントガイド 』で概要を説明している手順に従います。

プロファイル属性の更新

場合によっては、組織のプロファイルストアのデータを更新する必要があります。例えば、レコードを修正したり、属性値を変更したりする必要がある場合があります。これは、バッチまたはストリーミングの取り込みを通じて行うことができ、upsert タグで構成されたプロファイル対応のデータセットが必要です。属性更新用にデータセットを構成する方法の詳細については、プロファイルとアップサートのデータセットの有効化に関するチュートリアルを参照してください。

次の手順

Real-time Customer Profile API を使用して呼び出しを開始するには、『 はじめに 』を読み、特定の Profile 関連エンドポイントの使用方法を学ぶために、いずれかのエンドポイントガイドを選択します。 Experience Platform UI を使用して Profile データを操作するには、『 リアルタイム顧客プロファイルユーザーガイド 』を参照してください。

このページ