データ収集でのIDのトラブルシューティング
IDの問題は、多くの場合、実装自体のエラーではなく、ダウンストリームのレポート(訪問者数の増加、プロファイルの断片化、パーソナライゼーションの断片化)で発生します。 このページでは、Web SDKの実装で最も一般的なIDの問題を診断および解決する方法を説明します。 データ収集でのIDの仕組みについて詳しくは、IDの概要を参照してください。
ID値の検査 inspect-identity
特定の問題をトラブルシューティングする前に、Web SDKで使用されている現在のID値を取得します。 getIdentity コマンドを使用して、ECIDおよびその他のID シグナルを表示します。
alloy("getIdentity", { namespaces: ["ECID", "CORE"] }).then(function(result) {
console.log("ECID:", result.identity.ECID);
console.log("CORE ID:", result.identity.CORE);
console.log("Edge region:", result.edge.regionID);
});
ブラウザーの開発者ツールでID値を検査することもできます。
- アプリケーション タブ (Chrome/Edge)またはストレージ タブ (Firefox/Safari)を開きます。
- ドメインの
kndctr_が先頭に付いたCookieを探します。kndctr_<ORG_ID>_AdobeOrg_identityCookieにECIDが含まれています。 - 「Network」タブを開き、Edge Networkへの
interactまたはcollectリクエストを見つけます。identityMapのリクエストペイロードと、ID ハンドルの応答ペイロードを調べます。
一般的な問題 common-issues
訪問者数のインフレーション
症状:Analytics レポートに表示されるユニーク訪問者の数が予想を上回っているか、セッション間で同じユーザーが複数の訪問者として表示されています。
考えられる原因:
| table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 | ||
|---|---|---|
| 原因 | 特定方法 | 解決策 |
| Cookieの短期間保持 | ブラウザーでkndctr_ Cookieの有効期限を確認します。 7日以内に有効期限が切れる場合、ブラウザーポリシーによってCookieの期間が制限される可能性があります。 |
DNS A/AAAA レコードを使用してサーバーから設定された ファーストパーティデバイス ID (FPID) を実装し、Cookieの永続性を長くします。 |
| 最初のリクエストでFPIDがありません | ページ読み込み時に最初のEdge Network リクエストを調べます。 FPID Cookieが存在しない場合、Edge Networkは新しいECIDを生成します。 最初のリクエストの後にFPIDが設定されている場合、その最初のリクエストで生成されたECIDは孤立します。 | Web SDKが最初のリクエストを送信する前に、FPID Cookieを設定します。 「Cookieを設定するタイミング 」を参照してください。 |
ドメイン間でorgIdの不一致 |
ドメイン間でorgId設定値を比較します。 値が一致しない場合は、ID スコープが別々になります。 |
組織内のすべてのドメインで同じorgIdを使用します。 |
| Cookieを削除する同意バナー | 同意が付与される前に同意の実装がすべてのCookieをクリアし、Web SDKが初期化されると、新しいECIDが生成されます。 | 同意バナーを設定してkndctr_ Cookieを保持するか、同意が確立されるまでWeb SDKの初期化を遅らせます。 同意とIDも参照してください。 |
| JavaScriptで設定されたFPID Cookie | document.cookieを使用して設定されたCookieは、ブラウザの制限(ITP、ETP)の対象となり、有効期間が24時間に制限されることがあります。 |
JavaScriptからではなく、DNS A/AAAA レコードを使用して、サーバーからFPID Cookieを設定します。 |
ECIDがページ間で予期せず変更される
症状:ECIDは、同じドメインの異なるページで異なっているか、ページ読み込みごとに変更されます。
診断手順:
kndctr_ID Cookieが両方のページに存在することを確認します。 1つのページに欠けている場合は、Web SDKがそのページで設定されていることを確認します。- Cookie ドメインが十分に広く設定されていることを確認します。
shop.example.comに設定されたCookieは、www.example.comには使用できません。 ファーストパーティの収集とCookie設定インフラストラクチャで同じドメインスコープを使用することを確認します。 - ナビゲーション時にCookieをクリアするJavaScriptを確認します(例:攻撃的なCookie同意スクリプトやプライバシーツール)。
- シングルページアプリケーションを使用する場合は、Web SDKがアプリケーションの初期化時に1回設定され、すべてのルート変更で再初期化されないことを確認します。 再初期化すると、新しいECIDを生成できます。
FPIDはECIDをシードしていません
現象: FPID Cookieを設定しましたが、getIdentityは訪問全体で一貫性のないECIDを返すか、FPIDがEdge Network リクエストペイロードに表示されません。
診断手順:
- FPID Cookie形式を確認してください: FPIDは有効なUUIDv4である必要があります。 ブラウザーの開発者ツールを開き、FPID Cookieを見つけ、値がパターン
xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxxと一致することを確認します。 - データストリームのCookie名を確認: データストリームのCookie メソッド を使用している場合、データストリームで設定されたCookie名は、サーバーが設定したCookieの名前と完全に一致する必要があります。
- リクエストでCookieが送信されていることを確認します:「ネットワーク」タブで、Edge Network リクエストの
Cookieヘッダーを調べます。 FPID Cookieを含める必要があります。 - IDの優先度を確認:既存のECIDが既に
kndctr_Cookieに保存されている場合は、FPIDよりも優先されます。 FPIDは、既存のECIDが存在しない場合にのみ新しいECIDをシードします。 優先度の完全な順序については、FPIDの仕組みを参照してください。 - CNAMEの検証: データストリーム cookie メソッドを使用する場合は、ファーストパーティコレクション CNAMEが正しく設定されていること、およびリクエストがルーティングされていることを確認します。
クロスドメイン IDが機能しません
現象:いずれかのドメインから別のドメインにクリックした訪問者は、宛先ドメインの新しい訪問者として扱われます。
診断手順:
- URLを確認:訪問者がリンクをクリックしたときに、宛先URLを調べます。
adobe_mcクエリ文字列パラメーターを含める必要があります。 パラメーターが見つからない場合、ソースドメインはパラメーターを追加しません。 クロスドメイン共有の実装を参照してください。 - タイミングを確認:
adobe_mcパラメーターは5分後に有効期限が切れます。 宛先ページの読み込みに時間がかかりすぎる場合(リダイレクトやネットワークの速度が遅いなど)、パラメーターはWeb SDKが読み込む前に期限切れになる可能性があります。 - 一致する
orgIdを確認:両方のドメインで同じorgIdを使用する必要があります。 組織IDが一致しない場合、宛先ドメインはハンドオフ IDを拒否します。 - Web SDKが宛先にあることを確認します。宛先ページには、Web SDKがインストールされ、設定されている必要があります。 これを指定しない場合、
adobe_mcパラメーターは無視されます。 - URL ストリッピングの確認:一部のリダイレクトサービス、CDN、またはサーバーサイド ロジック ストリップの不明なクエリ文字列パラメーター。 ソース ページと宛先ページ間の中間リダイレクトが
adobe_mcで維持されていることを確認します。
モバイルからWebへのIDの引き継ぎが失敗しています
症状: モバイルアプリで開始し、WebViewまたはモバイルブラウザーを開いた訪問者は、Web側では新しい訪問者として扱われます。
診断手順:
- URLを確認: WebViewに渡されるURLをログに記録します。
adobe_mcgetUrlVariablesによって生成された パラメーターを含める必要があります。 - SDKのバージョンを確認: Edge Network拡張機能のモバイル IDはバージョン 1.1.0以降、Web SDKはバージョン 2.11.0以降である必要があります。
- タイミングを確認: ドメイン間の共有と同様に、
adobe_mcパラメーターは5分後に有効期限が切れます。 URLの構築後、WebViewが迅速に読み込まれることを確認します。 - 一致する
orgIdを確認: Experience Cloud組織IDは、モバイル SDKとWeb SDKの両方の設定で同じである必要があります。
recommendation-more-help
1ae86b30-e55e-49c1-ab11-9d0356a5f3e1