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

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

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

一部のフィールドを 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 サービスには、電話番号とメールのハッシュ化された ID 値の取り込みをサポートする標準名前空間があります。ただし、値のハッシュ化はユーザーが行う必要があります。Experience Platformに取り込まれるデータのハッシュ化について詳しくは、Data Prep マッピング関数ガイドを参照してください。

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

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

ID グラフページや API にアクセスできないのはなぜですか?

ID グラフデータを表示するには、Experience Platform管理者から view-identity-graph 権限をプロビジョニングしてもらう必要があります。 この権限がないと、ID グラフビューアページと、Experience Platform API の呼び出し時に、権限が拒否されたというメッセージが表示されます。 権限について詳しくは、アクセス制御の概要を参照してください。

トラブルシューティング

次の節では、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"
}

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

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

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

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

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

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

このエラーが発生した場合、アクセストークンは無効です。アクセストークンは 24 時間ごとに期限切れになるので、引き続き Experience 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 には、XID と呼ばれる一意の ID が割り当てられます。このメッセージが表示されるのは、特定の ID 値および名前空間に対応する XID を見つける過程でエラーが発生した場合です。