このドキュメントでは、リアルタイム顧客プロファイルに関するよくある質問への回答のほか、一般的なエラーのトラブルシューティングガイドを示します。Adobe Experience Platform の他のサービスに関する質問やトラブルシューティングについては、Experience Platform のトラブルシューティングガイドを参照してください。
Real-Time Customer Profile を使用すると、オンライン、オフライン、CRM、サードパーティなど、複数のチャネルのデータを組み合わせて、個々の顧客の全体像を把握できます。これにより、マーケターは、複数のチャネルにわたって、連携の取れた一貫性のある適切なエクスペリエンスを顧客に提供できます。
以下は、リアルタイム顧客プロファイルに関するよくある質問への回答のリストです。
プロファイルにはレコードデータと時系列データの両方を使用できますが、対象となっているデータには、データを一意の個人に関連付ける ID 値が少なくとも 1 つ含まれている必要があります。
他のすべての Platform サービスと同様に、プロファイルでは、そのデータがエクスペリエンスデータモデル(XDM)スキーマの下で意味的に構造化されている必要があります。次に、このスキーマにはプライマリ ID が定義されていて、プロファイルで使用できるようになっている必要があります。
XDM に慣れていない場合は、まず XDM の概要を参照してください。次に、ID フィールドの設定とプロファイルへのスキーマの有効化の手順については、XDM ユーザーガイドを参照してください。
リアルタイム顧客プロファイルは、取り込んだ他の Platform データを含んだデータレイクとは別に、独自のデータストア(「プロファイルストア」と呼ばれます)を維持管理します。
データがプロファイル以外のデータセットに取り込まれている場合、プロファイルストアで使用できるようにするには、そのデータをプロファイル対応のデータセットに再度取り込む必要があります。プロファイルの既存のデータセットを有効にすることはできますが、その設定以前に取り込まれたデータは、プロファイルストアには表示されません。
以前に取り込んだデータをプロファイルストアに追加する場合は、データセット設定のチュートリアルに従って、新しいデータセットを作成するか、既存のデータセットをプロファイルで使用できるように変換してから、そのデータセットに目的のデータを再度取り込みます。
API と UI のどちらを使用しているかに応じて、プロファイルデータを表示する方法は複数あります。
アクセスするプロファイルエンティティの ID がわかっている場合は、プロファイル API の /entities
(プロファイルアクセス)エンドポイントを使用して、それらのエンティティを検索できます。詳しくは、開発者ガイドのエンティティに関する節を参照してください。
また、Adobe Experience Platform セグメント化サービス API を使用して、セグメントメンバーシップの資格を持つ顧客の個人プロファイルにアクセスすることもできます。詳しくは、セグメント化サービスの概要を参照してください。
Experience Platform UI では、プロファイルワークスペースの「参照」タブを使用して、合計プロファイル数を表示し、ID 値で個人プロファイルを検索できます。詳しくは、プロファイルユーザーガイドを参照してください。
また、セグメントワークスペースの「参照」タブで、セグメントのリストを表示することもできます。セグメントを選択すると、そのセグメントに適格なプロファイルのサンプルが表示されます。 次に、これらのリストされたプロファイルのいずれかを選択して、その詳細を表示できます。詳しくは、クセグメント化 UI の概要を参照してください。
リアルタイム顧客プロファイル API を使用する際に発生する可能性のあるエラーメッセージのリストを以下に示します。発生したエラーがここに記載されていない場合は、代わりに一般的な Platform トラブルシューティングガイドで見つかることもあります。
{
"code": "400",
"message": "Could not lookup schema of the computed attribute for the provided path"
}
新しい計算属性を作成するときに、リクエストのペイロードで指定したスキーマが見つからなかった場合に、このエラーが発生します。ペイロードの path
プロパティに正しいテナント ID を指定したことと、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
プロパティで、それぞれ有効なデータセットまたはバッチ ID を指定していることを確認してください。詳しくは、プロファイル開発者ガイドの削除リクエストの作成に関する節を参照してください。
{
"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"
}
このエラーは、POST /config/projections
リクエストで指定した destinationId
が無効な場合に発生します。再試行する前に、有効な宛先 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 |