このドキュメントでは、リアルタイム顧客プロファイルに関するよくある質問に対する回答と、一般的なエラーのトラブルシューティングガイドを提供します。 Adobe Experience Platform の他のサービスに関する質問やトラブルシューティングについては、Experience Platform のトラブルシューティングガイドを参照してください。
Real-Time Customer Profile では、オンライン、オフライン、CRM、サードパーティなど、複数のチャネルのデータを組み合わせた、各顧客の全体像を確認できます。これにより、マーケターは、複数のチャネルにわたって顧客に対して調整され、一貫性のある、関連性の高いエクスペリエンスを提供できます。
次に、リアルタイム顧客プロファイルに関するよくある質問に対する回答のリストを示します。
プロファイルは両方を受け入れます レコード および 時系列 データ(該当するデータに、データを一意の個人に関連付ける id 値が 1 つ以上含まれている場合)
すべての Platform サービスと同様に、プロファイルのデータは、エクスペリエンスデータモデル (XDM) スキーマの下で、意味的に構造化されている必要があります。 次に、このスキーマには プライマリ ID 定義済みで、プロファイルで使用できるようになります。
XDM に慣れていない場合は、まず XDM の概要 を参照してください。 次に、XDM ユーザーガイドで、 id フィールドを設定 および プロファイルのスキーマを有効にする.
リアルタイム顧客プロファイルは、他に取り込んだ Platform データを含むデータレイクとは別に、独自のデータストア(「プロファイルストア」と呼ばれます)を維持します。
データが非プロファイルデータセットに取り込まれている場合、プロファイルストアで使用できるようにするには、そのデータをプロファイル対応のデータセットに再取り込みする必要があります。 プロファイルの既存のデータセットを有効にすることはできますが、その設定以前に取り込まれたデータは、プロファイルストアには表示されません。
以前に取り込んだデータをプロファイルストアに追加する場合は、 データセット設定のチュートリアル を使用して、新しいデータセットを作成するか、既存のデータセットを変換してプロファイルに対して有効にし、目的のデータをそのデータセットに再取り込みします。
API と UI のどちらを使用しているかに応じて、プロファイルデータを表示する複数の方法があります。
アクセスするプロファイルエンティティの ID がわかっている場合は、 /entities
(プロファイルアクセス)エンドポイントを使用してエンティティを検索する必要があります。 詳しくは、 エンティティ (開発者ガイド)を参照してください。
また、Adobe Experience Platform Segmentation Service API を使用して、セグメントメンバーシップの対象として認定された顧客の個々のプロファイルにアクセスすることもできます。 詳しくは、 セグメント化サービスの概要 を参照してください。
Experience PlatformUI で、 参照 」タブをクリックします。 プロファイル workspace では、合計プロファイル数を表示し、id 値で個々のプロファイルを検索できます。 詳しくは、 プロファイルユーザーガイド を参照してください。
また、セグメントのリストは、 参照 」タブをクリックします。 セグメント ワークスペース。 セグメントを選択すると、そのセグメントに適合するプロファイルのサンプルが表示されます。 その後、リストに表示された任意のプロファイルを選択して、その詳細を表示できます。 詳しくは、 セグメント化 UI の概要 を参照してください。
次に、リアルタイム顧客プロファイル API を使用する際に発生する可能性のあるエラーメッセージのリストを示します。 発生したエラーがここに記載されていない場合は、一般に Platform トラブルシューティングガイド 代わりに、
{
"code": "400",
"message": "Could not lookup schema of the computed attribute for the provided path"
}
新しい計算済み属性を作成する場合、このエラーは、リクエストペイロードで提供されたスキーマがシステムで見つからなかった場合に発生します。 ペイロードの path
プロパティに含まれ、 schema.name
は有効なスキーマ名です。
テナント ID が不明な場合は、 スキーマレジストリ開発者ガイド.
{
"code": "400",
"message": "Function with the same name already exists for the specified schema or definedOn"
}
新しい計算済み属性を作成する際に、指定した name
プロパティは、次の場所に示されるスキーマに既に使用されています: schema.name
. 再試行する前に、値を一意の名前に置き換えてください。
{
"code": "400",
"message": "Return schema of the expression is not same as the schema of the computed attribute in the XDM schema"
}
新しい計算済み属性を作成する際に、指定した name
プロパティは、次の場所に示されるスキーマに既に使用されています: schema.name
. 再試行する前に、値を一意の名前に置き換えてください。
{
"code": "400",
"message": "Invalid delete request (Profile System Job)"
}
このエラーは、削除システムジョブに無効なペイロードが指定された場合に発生します。 ペイロードの dataSetID
または batchID
プロパティに設定されます。 詳しくは、 削除リクエストの作成 (プロファイル開発者ガイド)を参照してください。
{
"requestId":"LlTmQkhgHKFGHGHnIkmUxcIL4YTFSpQw",
"errors":{
"400":[
{
"code":"400",
"message":"Batch not found for profile dataset '5da688d2c4e60518ad25b7b1'"
}
]
}
}
このエラーは、プロファイルデータの削除リクエストを作成しようとしたときに有効なバッチが見つからなかった場合に発生します。 再試行する前に、プロファイル対応データセットの正しい ID を入力していることを確認してください。
{
"status":404,
"title":"The projection destination has not yet been created.",
"type":"http://ns.adobe.com/adobecloud/problem/missing-entity"
}
このエラーは、 destinationId
提供される POST /config/projections
リクエストが無効です。 再試行する前に、有効な宛先 ID を指定したことを再確認してください。 新しい宛先を作成するには、 プロファイル開発者ガイド.
{
"status": 415,
"title": "HTTP 415 Unsupported Media Type",
"type": "http://ns.adobe.com/adobecloud/problem/unsupported-media-type"
}
このエラーは、無効な Content-Type ヘッダーを持つPOSTまたはPUTリクエストを送信する際に発生します。 使用しているエンドポイントに有効な Content-Type 値を指定していることを再確認します。
ほとんどのプロファイルエンドポイントは、Content-Type ヘッダーに「application/json」を受け入れますが、次の例外があります。
エンドポイント | Content-Type |
---|---|
/config/projections |
application/vnd.adobe.platform.projectionConfig+json;version=1 |
/config/destinations |
application/vnd.adobe.platform.projectionDestination+json;version=1 |