ID サービストラブルシューティングガイド

このドキュメントでは、Adobe Experience Platform Identity Serviceに関するよくある質問と、一般的なエラーのトラブルシューティングガイドについて回答します。 Platform APIに関する一般的な質問とトラブルシューティングについては、Adobe Experience Platform APIのトラブルシューティングガイドを参照してください。

1 人の顧客を識別するデータは、多くの場合、顧客がブランドに関与するために使用する様々なデバイスやシステムにわたって断片化されます。Identity Service では、これらの断片化されたIDをまとめて収集し、顧客の行動を完全に理解し、効果的なデジタルエクスペリエンスをリアルタイムで提供します。詳しくは、「ID サービスの概要」を参照してください。

FAQ

以下は、Identity Serviceに関するよくある質問に対する回答のリストです。

ID データとは

ID データは、個人を識別するために使用できる任意のデータです。組織内でのデータの使用方法のコンテキストに応じて、ID データには、ユーザー名、電子メールアドレス、CRM システムの ID が含まれる場合があります。匿名ユーザーはデバイスや cookie ID で識別できるので、ID データは Web サイトやサービスの登録ユーザーに限定されません。

データフィールドを ID としてラベル付けする利点は何ですか。

特定のデータフィールドをレコードおよび時系列データの ID としてラベル付けすると、データの自然構造内で ID の関係をマッピングし、重複データをチャネル間で調整できます。詳しくは、「ID サービスの概要」を参照してください。

既知 ID と匿名 ID とは

既知 ID とは、個人を識別、連絡、または場所を特定するために、単独または他の情報と共に使用できる ID 値を指します。既知 ID の例としては、電子メールアドレス、電話番号、CRM ID などがあります。

匿名 ID とは、個人を識別、連絡、または場所を特定するために、単独で、または他の情報と共に使用できない ID 値を指します(cookie ID など)。

プライベート ID グラフとは

プライベート ID グラフは、組織にのみ表示される、結合済み ID とリンクされた ID の間の関係を示すプライベートマップです。

ストリーミングエンドポイントから取り込まれたデータやIdentity Serviceが有効なデータセットに送信されたデータに複数のIDが含まれている場合、それらのIDはプライベートIDグラフにリンクされます。 Identity Service は、このグラフを利用して特定の消費者またはエンティティのIDを収集し、IDの結合とプロファイルの結合を可能にします。

XDM スキーマ内に複数の ID フィールドを作成する方法を教えてください。

エクスペリエンスデータモデル(XDM)スキーマは、複数の ID フィールドをサポートします。XDM Individual Profile または XDM ExperienceEvent クラスを実装するスキーマ内の任意の string 型のデータフィールドは、ID フィールドとしてラベル付けできます。ラベルが付けられると、これらのフィールドに含まれるすべてのデータがプロファイルの ID マップに追加されます。

ユーザーインターフェイスを使用して XDM フィールドに ID フィールドのラベルを付ける手順については、『スキーマエディタのチュートリアル』の「ID」節を参照してください。API を使用している場合は、『スキーマレジストリ API のチュートリアル』の「ID 記述子」の節を参照してください。

一部のフィールドをコンテキストとしてラベル付けしないようにする必要はありますか。

「ID」フィールドは、個々のユーザーに固有の値のために予約する必要があります。例えば、顧客のロイヤリティープログラムのデータセットを考えてみましょう。「ロイヤリティーレベル」フィールド(ゴールド、シルバー、ブロンズ)は有用な ID フィールドではありませんが、一意の値であるロイヤリティー ID は有用な ID フィールドです。

郵便番号や IP アドレスなどのフィールドは、値が複数の個人に適用される場合があるので、個人の ID としてラベル付けできません。これらのタイプのフィールドは、世帯レベルのマーケティング戦略の ID としてのみラベル付けする必要があります。

ID フィールドが期待どおりにリンクされないのはなぜですか。

ID サービス API の/cluster/membersエンドポイントを使用して、1 つ以上の ID フィールドに関連付けられた ID を表示できます。応答が期待するリンクされた ID を返さない場合は、XDM データに適切な ID 情報を提供していることを確認します。詳しくは、「ID サービスの概要」の「XDM データの ID サービスへの提供」の節を参照してください。

ID 名前空間とは

ID 名前空間は、ID フィールドと顧客の ID との関係を示すコンテキストを提供します。例えば、「Email」名前空間の下の ID フィールドは標準的な電子メールの形式(name@emailprovider.com)に準拠し、「Phone」名前空間を使用するフィールドは標準電話番号(北米では 987-555-1234 など)に準拠する必要があります。

名前空間は、異なる CRM システム間で類似した ID 値を区別します。例えば、企業の報酬プログラムに関連付けられた数値のロイヤリティー ID を含むプロファイルを考えてみます。「Loyalty」名前空間では、同じプロファイルにも表示される e コマースシステムの類似した数値 ID からこの値が分離されます。

詳しくは、「ID 名前空間の概要」を参照してください。

ID を ID 名前空間に関連付ける方法を教えてください。

ID フィールドは、作成時に既存の ID 名前空間に関連付ける必要があります。新しい名前空間は、API を使用して作成してから、ID フィールドに関連付ける必要があります。

API を使用して ID 記述子を作成する際に名前空間を定義する手順については、『スキーマレジストリ開発者ガイド』の「記述子の作成」の節を参照してください。UI でスキーマフィールドを ID としてマークする場合は、『スキーマエディタのチュートリアル』の手順に従います。

Experience Platform が提供する標準 ID 名前空間は何ですか。

標準ID名前空間は、すべての組織で使用できる名前空間です。 使用可能な標準名前空間の完全なリストについては、「ID名前空間の概要」を参照してください。

組織で使用できる ID 名前空間のリストはどこで見つけられますか?

ID サービス API を使用して、/idnamespace/identities エンドポイントに GET リクエストをおこなうことで、組織で使用可能なすべての ID 名前空間をリストできます。詳しくは、「ID サービス API の概要」で使用可能な名前空間のリストを参照してください。

組織のカスタム名前空間を作成する方法を教えてください。

ID サービス API を使用して /idnamespace/identities エンドポイントに POST リクエストをおこなうことで、組織のカスタム ID 名前空間を作成できます。詳しくは、「ID サービス API の概要」のカスタム名前空間の作成に関する節を参照してください。

複合 ID と XID とは何ですか。

ID は、API 呼び出しで複合 ID または XID によって参照されます。複合 ID は、ID 値と名前空間を含む ID を表します。XID は、複合 ID(ID および名前空間)と同じ構成を表す単一値 ID で、ID サービスによって永続化されると、新しい ID に自動的に割り当てられます。詳しくは、「ID サービス API の概要」を参照してください。

ID サービスが個人を特定できる情報(PII)をどのように処理するのか教えてください。

ID サービスは、値を永続化する前に、PII の強力で一方向の暗号化ハッシュを作成します。「Phone」名前空間と「Email」名前空間の ID データは、SHA-256 を使用して自動的にハッシュ化され、「Email」値はハッシュ前に自動的に小文字に変換されます。

Platform に送信する前に、すべての PII を暗号化する必要がありますか。

Platform に取得する前に、PII データを手動で暗号化する必要はありません。Platform は、I1 データ使用ラベルを適用可能なすべてのデータフィールドに適用することで、取得時にこれらのフィールドをハッシュ ID 値に自動的に変換します。

データ使用ラベルを適用および管理する手順については、『データ使用ラベルのチュートリアル』を参照してください。

PII ベースの ID をハッシュする際に考慮すべき点はありますか。

ハッシュ化された PII 値を ID サービスに送信する場合は、データセット全体で同じ暗号化方式を使用する必要があります。これにより、データセット間で同じ ID 値が同じハッシュ値を生成し、ID グラフで適切に一致およびリンクできるようになります。

トラブルシューティング

以下の節では、Identity Service APIの操作中に発生する可能性のある特定のエラーコードと予期しない動作に関するトラブルシューティングの推奨事項を示します。

Identity Service エラーメッセージ

以下は、Identity Service APIの使用時に発生する可能性のあるエラーメッセージのリストです。

必要なクエリーパラメーターがありません

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "Missing required query parameter - namespace"
}

このエラーは、リクエストされたクエリーパラメータがリクエストパスに含まれていない場合に表示されます。エラーメッセージの detail に、見つからないパラメーターの名前が表示されます。このエラーメッセージには、次のようなバリエーションがあります。

  • 必要なクエリーパラメーターがありません — nsId
  • 必要なクエリーパラメーターがありません — id
  • 必要なクエリーパラメーターがありません — xid または(nsid,id)
  • 必要なクエリーパラメーターがありません — targetNs
  • 必要なクエリーパラメーターがありません — xids または compositeXids

再試行する前に、指定したパラメーターがリクエストパスに正しく含まれていることを確認してください。

タイムスタンプは過去 180 日以内にする必要があります

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "Timestamp should be within last 180 days"
}

Identity Service 180日を超えるデータを削除します。このエラーメッセージは、これより古いデータにアクセスしようとすると表示されます。

1 回の呼び出しで使用できる XID は 1,000 個までです

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "There is a limit of 1000 XIDs in a single call"
}

このエラーメッセージは、1 回の API 呼び出しで許可される XID の最大数を超える ID 情報を取得しようとすると表示されます。この問題を解決するには、リクエストの XID の数を表示された上限を下回るように減らします。

1 回の呼び出しで使用できる compositeXids は 1,000 個までです

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "There is a limit for 1000 compositeXids in a single call"
}

このエラーメッセージは、1 回の API 呼び出しで許可される複合 ID の最大数を超える ID 情報を取得しようとすると表示されます。この問題を解決するには、リクエスト内の複合 ID の数を、表示される制限を下回るように減らします。

指定されたグラフの種類は無効です

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "The graph-type abc specified is invalid. Please provide a valid graph-type"
}

このエラーメッセージは、リクエストパスで graph-type クエリーパラメーターに無効な値が与えられた場合に表示されます。サポートされているグラフのタイプについては、Identity Serviceの概要のIDグラフの節を参照してください。

サービストークンに有効なスコープがありません

{
    "title": "UnauthorizedAccess",
    "status": 401,
    "detail": "Service token does not have valid scope. Either acp.core.identity or acp.foundation is required"
}

このエラーメッセージは、IMS組織がIdentity Serviceに対する適切な権限を持つプロビジョニングされていない場合に表示されます。 この問題を解決するには、システム管理者に問い合わせてください。

ゲートウェイサービストークンが無効です

{
    "title": "UnauthorizedAccess",
    "status": 401,
    "detail": "Gateway service token is not valid"
}

このエラーが発生した場合、アクセストークンは無効です。アクセストークンは24時間ごとに期限が切れ、引き続きPlatform APIを使用するには再生成する必要があります。 新しいアクセストークンの生成手順については、認証に関するチュートリアルを参照してください。

認証サービストークンが無効です

{
    "title": "UnauthorizedAccess",
    "status": 401,
    "detail": "Authorization service token is not valid"
}

このエラーが発生した場合、アクセストークンは無効です。アクセストークンは24時間ごとに期限が切れ、引き続きPlatform APIを使用するには再生成する必要があります。 新しいアクセストークンの生成手順については、認証に関するチュートリアルを参照してください。

ユーザートークンに有効な製品コンテキストがありません

{
    "title": "UnauthorizedAccess",
    "status": 401,
    "detail": "User token does not have valid product context"
}

このエラーメッセージは、アクセストークンがExperience Platform統合から生成されていない場合に表示されます。 統合のための新しいアクセストークンの生成手順については、認証に関するチュートリアルを参照してください。Experience Platform

ID とネイティブ XID を取得する際の内部エラーと名前空間コード

{
    "title": "UnauthorizedAccess",
    "status": 401,
    "detail": "Invalid IMS Token/IMS Org | Internal error - when tried to get native XID from identity and namespace code"
}

Identity ServiceがIDを保持する場合、IDのIDと関連する名前空間IDには、XIDと呼ばれる一意の識別子が割り当てられます。 このメッセージは、特定の ID 値と名前空間の XID を見つけるプロセス中にエラーが発生した場合に表示されます。

IMS組織はIdentity Serviceの使用のためにプロビジョニングされていません

{
    "title": "AccountNotProvisioned",
    "status": 403,
    "detail": "The IMS Org. {IMS_ORG_NAME} is not provisioned for Identity Service usage"
}

このエラーメッセージは、IMS組織がIdentity Serviceに対する適切な権限を持つプロビジョニングされていない場合に表示されます。 この問題を解決するには、システム管理者に問い合わせてください。

内部サーバーエラー

{
    "title": "InternalError",
    "status": 500,
    "detail": "Internal Server Error. There was a problem processing your request"
}

このエラーは、Platformサービス呼び出しの実行中に予期しない例外が発生した場合に表示されます。 ベストプラクティスは、自動呼び出しをプログラムして、このエラーを受け取ったときに一定の時間間隔でリクエストを数回再試行することです。問題が解決しない場合は、システム管理者に問い合わせてください。

バッチ取得エラーコード

Identity Service は、バッチ取得を使用してにアップロードされたレコードおよび時系列データからIDデ Platform ータを取り込みます。バッチ取得は非同期的なプロセスなので、エラーを表示するには、バッチの詳細を表示する必要があります。バッチが完了するまで、バッチの進行に合わせてエラーが蓄積されます。

以下は、データ取得APIの使用時に発生する可能性のあるIdentity Serviceに関するエラーメッセージのリストです。

不明な XDM スキーマ

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "Unknown XDM schema"
}

Identity Service は、それぞれまたはクラスに準拠するレコードまたは時系列データのID Profile のみを ExperienceEvent 使用します。どちらのクラスにも準拠していないIdentity Serviceのデータを取り込もうとすると、このエラーがトリガーします。

処理されたバッチの最初の 100 行に 0 個の有効な ID がありました

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "There were 0 valid identities in the first 100 rows of the processed batch"
}

このエラーは、バッチの最初の 100 行に ID が見つからなかった場合に表示されます。ただし、このエラーは、後続のレコードで ID が見つからなかったことを最終的に示すものではありません。

XDM レコード 1 つにつき ID が 1 つしかないので、レコードをスキップしました

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "Skipped {NUMBER_OF_RECORDS} records as they had only 1 identity per XDM record"
}

Identity Service は、1つのレコードに2つ以上のID値が存在する場合にのみIDをリンクします。このエラーメッセージは、取得されたバッチごとに 1 回ずつ発生し、1 つの ID しか見つからずに ID グラフに変更が生じなかったレコードの数を表示します。

名前空間コードがこの IMS 組織に登録されていません

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "Namespace Code {ERRONEOUS_CODE} is not registered for this IMS Org"
}

このエラーは、取得したレコードに関連付けられた名前空間が存在しないか、IMS 組織からアクセスできない ID が存在する場合に表示されます。

IMS 組織がプライベート ID グラフ用にプロビジョニングされていないため、バッチ取得をスキップします

{
    "title": "AccountNotProvisioned",
    "status": 403,
    "detail": "Skipping batch ingestion as IMS Org is not provisioned for Private Identity Graph"
}

バッチデータを取り込むと、このエラーメッセージは、IMS組織がIdentity Serviceに対する適切な権限を持つプロビジョニングされていない場合に表示されます。 この問題を解決するには、システム管理者に問い合わせてください。

内部エラー

{
    "title": "InternalError",
    "status": 500,
    "detail": "Internal Error. There was a problem during the ingestion"
}

このエラーは、バッチ取得中に予期しない例外が発生した場合に表示されます。ベストプラクティスは、自動呼び出しをプログラムして、このエラーを受け取ったときに一定の時間間隔でリクエストを数回再試行することです。問題が解決しない場合は、システム管理者に問い合わせてください。

このページ