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

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

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

次の図は、Adobe Experience Platformとアプリケーションへのデータの流れを簡略化したものです。 この図を参照として使用すると、このページの内容をより深く理解できます。

{modal="regular"}

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

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

自分のIDがID サービスに取り込まれていません my-identities-are-not-getting-ingested-into-identity-service

この問題が発生する理由は様々ですが、次のようなものがあります。

Identity Graph Linking Rulesのコンテキストでは、受信イベントに同じ一意の名前空間を持つ2つ以上のIDが含まれていますが、ID値が異なるため、レコードが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を含むイベントを拒否します。 例えば、ID設定が次のように設定されているとします。

各シナリオについて、エクスペリエンスイベントに次のイベントが含まれていると仮定します。

シナリオ 1: 2 GAID、1 ECID

シナリオ 2: 2 CRMID、1 GAID

シナリオ 3: 1 CRMID、2 GAID

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

データがプロファイルではなくデータレイクに送信され、これが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のID値がわからない場合に、複数のユーザー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 グラフの状態に関するインサイトを得ることができます。 折りたたまれたグラフの数については、「複数の名前空間を持つグラフ数」という指標を参照してください。これらは、同じ名前空間を持つ2つ以上の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を使用してログインする場合、グラフが折りたたまれる可能性があります。 詳しくは、実装ページの「単一のユーザー名前空間要件」の節を参照してください。

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

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

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

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

ECIDがある人から別の人に転送される場合、Adobe Journey Optimizerのジャーニーはどのように影響しますか？

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

重要なポイントは次のとおりです。

名前空間の優先度

名前空間の優先度に関するよくある質問に対する回答については、この節を参照してください。

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

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

Real-Time Customer ProfileがIDMapで「プライマリ」フラグを使用しなくなった場合、この値を送信する必要がありますか？

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

Real-Time Customer Profileのプロファイルレコードデータセットには、名前空間優先度が適用されますか？

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

この機能は、1つのグラフにつき50 IDのID グラフガードレールと連動して、どのように機能しますか？ 名前空間の優先順位は、このシステム定義のガードレールに影響しますか？

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

テスト

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

開発サンドボックス環境でテストすべきシナリオは何ですか？

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

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

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

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