リアルタイム顧客プロファイルトラブルシューティングガイド

このドキュメントでは、リアルタイム顧客プロファイルに関するよくある質問への回答のほか、一般的なエラーのトラブルシューティングガイドを示します。Adobe Experience Platform の他のサービスに関する質問やトラブルシューティングについては、Experience Platform のトラブルシューティングガイドを参照してください。

Real-Time Customer Profile を使用すると、オンライン、オフライン、CRM、サードパーティなど、複数のチャネルのデータを組み合わせて、個々の顧客の全体像を把握できます。これにより、マーケターは、複数のチャネルにわたって、連携の取れた一貫性のある適切なエクスペリエンスを顧客に提供できます。

FAQ

以下は、リアルタイム顧客プロファイルに関するよくある質問への回答のリストです。

どのような種類のデータをリアルタイム顧客プロファイルに使用できますか?

プロファイルには​ レコード ​データと​ 時系列 ​データの両方を使用できますが、対象となっているデータには、データを一意の個人に関連付ける ID 値が少なくとも 1 つ含まれている必要があります。

他のすべての Platform サービスと同様に、プロファイルでは、そのデータがエクスペリエンスデータモデル(XDM)スキーマの下で意味的に構造化されている必要があります。次に、このスキーマには​ プライマリ ID が定義されていて、プロファイルで使用できるようになっている必要があります。

XDM に慣れていない場合は、まず XDM の概要を参照してください。次に、ID フィールドの設定プロファイルへのスキーマの有効化の手順については、XDM ユーザーガイドを参照してください。

プロファイルデータはどこに保存されますか?

リアルタイム顧客プロファイルは、取り込んだ他の Platform データを含んだデータレイクとは別に、独自のデータストア(「プロファイルストア」と呼ばれます)を維持管理します。

データを既に Platform に取り込んでいる場合、それを Profile ストアで使用できるようにできますか?

データがプロファイル以外のデータセットに取り込まれている場合、プロファイルストアで使用できるようにするには、そのデータをプロファイル対応のデータセットに再度取り込む必要があります。プロファイルの既存のデータセットを有効にすることはできますが、その設定以前に取り込まれたデータは、プロファイルストアには表示されません。

以前に取り込んだデータをプロファイルストアに追加する場合は、データセット設定のチュートリアルに従って、新しいデータセットを作成するか、既存のデータセットをプロファイルで使用できるように変換してから、そのデータセットに目的のデータを再度取り込みます。

取り込んだプロファイルデータを表示するにはどうすればよいですか?

API と UI のどちらを使用しているかに応じて、プロファイルデータを表示する方法は複数あります。

API の使用

アクセスするプロファイルエンティティの ID がわかっている場合は、プロファイル API の /entities(プロファイルアクセス)エンドポイントを使用して、それらのエンティティを検索できます。詳しくは、開発者ガイドのエンティティに関する節を参照してください。

また、Adobe Experience Platform セグメント化サービス API を使用して、オーディエンスメンバーシップに適合した顧客の個人プロファイルにアクセスすることもできます。詳しくは、セグメント化サービスの概要を参照してください。

UI の使用

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 が不明な場合は、スキーマレジストリ開発者ガイドに記載されている手順に従って取得できます。

指定されたスキーマまたは definedOn に対して、同じ名前の関数が既に存在します

{
  "code": "400",
  "message": "Function with the same name already exists for the specified schema or definedOn"
}

新しい計算属性を作成するときに、指定した name プロパティが schema.name で示されるスキーマに既に使用されている場合、このエラーが発生します。値を一意の名前に置き換えてから、もう一度やり直してください。

式の戻りスキーマが XDM スキーマの計算属性のスキーマと同じではありません

{
  "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": 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
recommendation-more-help
54550d5b-f1a1-4065-a394-eb0f23a2c38b