Identity Graph Linking Rules のトラブルシューティングガイド

Identity Graph Linking Rules のテストと検証を行うと、データの取り込みとグラフの動作に関連した問題が発生する場合があります。 Identity Graph Linking Rules を使用する際に発生する可能性のある、一般的な問題のトラブルシューティング方法については、このドキュメントを参照してください。

データ取り込みフローの概要 data-ingestion-flow-overview

次の図は、データがAdobe Experience Platformとアプリケーションに送られる仕組みを簡単に表したものです。 このページの内容をより深く理解するために、この図を参考にしてください。

次の要因に注意することが重要です。

データ取り込みの問題 data-ingestion-issues

ID が ID サービスに取り込まれない my-identities-are-not-getting-ingested-into-identity-service

これが発生する理由には、次のように様々な理由があります（ただし、これらに限定されません）。

受信イベントには同じ一意の名前空間を持つが、ID 値が異なる 2 つ以上の ID があるので、Identity Graph Linking Rules のコンテキスト内では、レコードが ID サービスから拒否される場合があります。 このシナリオは通常、実装エラーが原因で発生します。

次の 2 つの前提があるイベントについて考えてみます。

次のイベントは、取り込みが失敗したことを示すエラーメッセージを返します。

{
  "_id": "random_string",
  "eventType": "web browsing event",
  "identityMap": {
    "ECID": [
      {
        "id": "11111111111111111111111111111111111111",
        "primary": false
      }
    ],
    "CRMID": [
      {
        "id": "Alice",
        "primary": true
      }
    ]
  },
  "CRMID": "Bob",
  "timestamp": "2024-08-17T15:22:51+00:00",
  "web": {
    "webPageDetails": {
      "URL": "https://www.adobe.com/acrobat.html",
      "name": "Adobe Acrobat"
    }
  }
}

トラブルシューティング手順

このエラーを解決するには、まず次の情報を収集する必要があります。

次に、Adobe Experience Platform クエリサービスを使用して次のクエリを実行します。

  SELECT key, col.id as identityValue, timestamp, _id, identityMap, *
  FROM (SELECT key, explode(value), *
  FROM (SELECT explode(identityMap), *
  FROM dataset_name)) WHERE col.id = 'identity_value'

クエリを実行した後、グラフを生成するために必要なイベントレコードを見つけ、同じ行で ID 値が異なることを検証します。 例として、次の画像を表示します。

認証後の ExperienceEvents は、間違った認証済みプロファイルに関連付けられています

名前空間の優先度は、イベントフラグメントがプライマリ ID を決定する方法において重要な役割を果たします。

認証済みユーザーイベントをユーザー名前空間に結び付けるには、すべての認証済みイベントにユーザー名前空間（CRMID）が含まれている必要があります。 つまり、ユーザーがログインした後も、認証済みのすべてのイベントにユーザーの名前空間が引き続き存在する必要があります。

プロファイルビューアでプロファイル primary=true 検索する際に、「イベント」フラグが引き続き表示される場合があります。 ただし、これは無視され、プロファイルでは使用されません。

AAID はデフォルトでブロックされます。 したがって、Adobe Analytics ソースコネクタを使用している場合は、未認証のイベントが ECID のプライマリ ID を持つように、ECID の優先順位が ECID よりも高くなるように設定する必要があります。

トラブルシューティング手順

エクスペリエンスイベントフラグメントがプロファイルに取り込まれない my-experience-event-fragments-are-not-getting-ingested-into-profile

エクスペリエンスイベントフラグメントがプロファイルに取り込まれない理由には、次のように様々な理由があります（ただし、これに限定されません）。

名前空間の優先度のコンテキストでは、プロファイルは、名前空間の優先度が最も高い 2 つ以上の ID を含むイベントを拒否します。 例えば、GAID が一意の名前空間としてマークされておらず、GAID 名前空間と異なる ID 値の両方を持つ 2 つの ID が入った場合、プロファイルは、イベントを保存しません。

トラブルシューティング手順

データがデータレイクに送信されたが、プロファイルには送信されておらず、これが 1 つのイベントで名前空間の優先順位が最も高い 2 つ以上の ID が送信されたことが原因であると考えられる場合は、次のクエリを実行して、同じ名前空間に対して送信された 2 つの異なる ID 値があることを検証できます。

  SELECT identityMap, key, col.id as identityValue, _testimsorg.identification.core.email, _id, timestamp
  FROM (SELECT key, explode(value), *
  FROM (SELECT explode(identityMap), *
  FROM dataset_name)) WHERE col.id != _testimsorg.identification.core.email and key = 'Email'

このクエリでは、次のことを前提としています。

グラフの動作に関連する問題 graph-behavior-related-issues

この節では、ID グラフの動作に関して発生する可能性のある一般的な問題について説明します。

認証されていない ExperienceEvents が、間違った認証済みプロファイルに添付されます

ID 最適化アルゴリズムは、 最近確立されたリンクを優先し、最も古いリンクを削除します。 したがって、この機能を有効にすると、あるユーザーから別のユーザーに ECID を再割り当て（再リンク）できるようになります。 ID が時間の経過と共にどのようにリンクされるかの履歴を理解するには、次の手順に従います。

トラブルシューティング手順

まず、次の情報を収集する必要があります。

ID 記号（namespaceCode）は大文字と小文字が区別されます。 identityMap で特定のデータセットのすべての ID 記号を取得するには、次のクエリを実行します。

SELECT distinct explode(*)FROM (SELECT map_keys(identityMap) FROM dataset_name)

cookie 識別子の ID 値が不明な場合、複数のユーザー識別子にリンクされた cookie ID を検索するには、次のクエリを実行する必要があります。 このクエリでは、ECID を cookie 名前空間、CRMID を人物名前空間と想定しています。

  SELECT identityMap['ECID'][0]['id'], count(distinct identityMap['CRMID'][0]['id']) as crmidCount FROM dataset_name GROUP BY identityMap['ECID'][0]['id'] ORDER BY crmidCount desc

  SELECT identityMap['ECID'][0]['id'], count(distinct personID) as crmidCount FROM dataset_name group by identityMap['ECID'][0]['id'] ORDER BY crmidCount desc

複数のユーザー ID にリンクされている cookie 値が識別されたら、結果から 1 つを取得し、次のクエリで使用して、その cookie 値が別のユーザー ID にリンクされたタイミングを時系列で確認します。

  SELECT identityMap['CRMID'][0]['id'] as personEntity, *
  FROM dataset_name
  WHERE identitymap['ECID'][0].id ='identity_value'
  ORDER BY timestamp desc

SELECT _experience.analytics.customDimensions.eVars.eVar10 as personEntity, *
FROM dataset_name
WHERE identitymap['ECID'][0].id ='identity_value'
ORDER BY timestamp desc

ID 最適化アルゴリズムが期待どおりに「動作」していません

トラブルシューティング手順

詳しくは、ID 最適化アルゴリズムおよびサポートされるグラフ構造のタイプに関するドキュメントを参照してください。

また、UI の グラフシミュレーションツールを使用して、イベントをシミュレートし、独自の名前空間や名前空間の優先度設定を設定することもできます。 これにより、ID 最適化アルゴリズムの動作のベースラインを理解するのに役立ちます。

シミュレーション結果がグラフの動作の期待と一致する場合は、ID 設定がシミュレーションで設定した設定と一致するかどうかを確認できます。

ID 設定を指定した後も、サンドボックスに折りたたまれたグラフが表示されます

ID グラフは、設定された一意の名前空間と名前空間の優先度 設定が保存された後 に従います。 新しい設定を保存する 前 に存在する「折りたたまれた」グラフは、折りたたまれたグラフが更新されるように新しいデータが取り込まれるまで、影響を受けません。 リアルタイム顧客プロファイルのイベントフラグメントのプライマリ ID は、名前空間の優先度が変更された後も更新されません。

トラブルシューティング手順

ID グラフビューアを使用すると、グラフが設定の前または後に取り込まれたかどうかを確認できます。 ​ リンクプロパティ ​ の下で最終更新されたタイムスタンプを調べて、ID サービスがグラフを取り込んだタイミングを確認します。 タイムスタンプが設定前の場合は、機能を有効にする前に「折りたたまれた」グラフが作成されたことを示します。

サンドボックス内に「折りたたまれた」グラフが何本存在するかを知りたい

ID ダッシュボードを使用すると、ID の数やグラフなど、ID グラフの状態に関するインサイトを得ることができます。 折りたたまれたグラフの数については、指標「複数の名前空間を持つグラフの数」を参照してください。これらは、同じ名前空間を持つ複数の ID を含むグラフです。 サンドボックスにデータがなく、名前空間（CRMID など）を一意になるように設定した場合、2 つ以上の CRMID を持つグラフがゼロになることが想定されます。 次の例では、2 つ以上のメールアドレスを含んだ 2 つのグラフがあります。

以下のクエリを実行すると、データレイクの プロファイルスナップショット書き出しデータセットで詳細な分類を確認できます。

  SELECT key, identityCountInGraph, count(identityCountInGraph) as graphCount
  FROM (SELECT key, cardinality(value) as identityCountInGraph
  FROM (SELECT explode(identityMap)
  FROM dataset_name
  WHERE cardinality(identityMap) > 1)) /* by definition, graphs have 2 or more identities */
  WHERE key not in ('ecid', 'aaid', 'idfa', 'gaid') /* filter out common device/cookie namespaces */
  GROUP BY 1, 2
  ORDER BY 1, 2 asc

プロファイルスナップショット書き出しデータセットで次のクエリを使用して、「折りたたまれた」グラフからサンプル ID を取得できます。

  SELECT identityMap
  FROM dataset_name
  WHERE cardinality(identityMap['CRMID'])>1 /* any graphs with 2+ CRMID. Change CRMID namespace if needed */

よくある質問 faq

この節では、Identity Graph Linking Rules に関するよくある質問に対する回答のリストの概要を説明します。

ID 最適化アルゴリズム identity-optimization-algorithm

ID 最適化アルゴリズムに関するよくある質問への回答については、この節を参照してください。

ビジネスユニット（B2C CRMID、B2B CRMID）ごとに CRMID がありますが、すべてのプロファイルに一意の名前空間があるわけではありません。 B2C CRMID と B2B CRMID を一意としてマークし、ID 設定を有効にすると、どうなりますか？

このシナリオはサポートされていません。 そのため、ユーザーが B2C CRMID を使用してログインし、別のユーザーが B2B CRMID を使用してログインすると、グラフが折りたたまれる場合があります。 詳しくは、実装ページの 1 人の名前空間要件に関する節を参照してください。

ID 最適化アルゴリズムは、折りたたまれている既存のグラフを「修正」しますか？

既存の折りたたまれたグラフは、新しい設定を保存した後にこれらのグラフが更新された場合にのみ、グラフアルゴリズムの影響（「固定」）を受けます。

2 人のユーザーが同じデバイスを使用してログインおよびログアウトした場合、イベントはどうなりますか。 すべてのイベントは、最後に認証されたユーザーに転送されますか？

詳しくは、 エクスペリエンスイベントのプライマリ ID の決定に関するガイドを参照してください。

ECID を人から人に転送すると、Adobe Journey Optimizerのジャーニーはどのような影響を受けますか？

最後に認証されたユーザーの CRMID が ECID （共有デバイス）にリンクされます。 ECID は、ユーザーの行動に基づいて、あるユーザーから別のユーザーに再割り当てすることができます。 影響はジャーニーの構築方法によって異なるので、顧客は開発サンドボックス環境でジャーニーをテストして、動作を検証することが重要です。

要点は以下の通りです。

名前空間の優先度

このセクションでは、 名前空間の優先度に関するよくある質問に対する回答を示しています。

ID 設定を有効にしました。 設定を有効にした後にカスタム名前空間を追加するとどうなりますか？

名前空間には、ユーザー名前空間とデバイス/cookie 名前空間の 2 つの「バケット」があります。 新しく作成したカスタム名前空間は、各「バケット」で最も優先度が低くなるので、この新しいカスタム名前空間が既存のデータ取り込みに影響を与えることはありません。

リアルタイム顧客プロファイルが identityMap で「プライマリ」フラグを使用しなくなった場合、この値を送信する必要がありますか？

はい、identityMap の「プライマリ」フラグは他のサービスで使用されます。 詳しくは、のガイド 他のExperience Platform サービスにおける名前空間の優先度の影響を参照してください。

名前空間の優先度は、リアルタイム顧客プロファイルのプロファイルレコードデータセットに適用されますか。

いいえ。名前空間の優先度は、XDM ExperienceEvent クラスを使用するエクスペリエンスイベントデータセットにのみ適用されます。

この機能は、グラフあたり 50 個の ID からなる ID グラフガードレールと並行してどのように機能しますか？ 名前空間の優先度は、このシステム定義のガードレールに影響を与えますか？

人物エンティティを確実に表現するために、ID 最適化アルゴリズムが最初に適用されます。 その後、グラフが ID グラフガードレール（グラフあたり 50 個の ID）を超えようとした場合、このロジックが適用されます。 名前空間の優先度は、50 ID/グラフガードレールの削除ロジックには影響しません。

テスト

Identity Graph Linking Rules の機能のテストとデバッグに関するよくある質問への回答については、この節を参照してください。

開発用サンドボックス環境では、どのようなシナリオをテストするとよいですか？

一般に、開発用サンドボックスでのテストは、実稼動用サンドボックスで実行する予定のユースケースを模倣する必要があります。 包括的なテストを実施する際に検証する必要がある主な領域については、次の表を参照してください。

この機能が期待どおりに動作していることを検証するにはどうすればよいですか？

グラフシミュレーションツールを使用して、フィーチャーが個々のグラフレベルで動作していることを検証します。

サンドボックスレベルで機能を検証するには、ID ダッシュボードの ​ 複数の名前空間を使用したグラフ数 ​ の節を参照してください。