Customer Journey AnalyticsでのAdobe Advertising データのトラブルシューティング
次に潜在的な問題、それらの考えられる原因、および解決策を示します。
潜在的な課題のリスト
_experience.adcloudがありません。alloy()送信イベント呼び出しは成功しましたが(応答は200)、Adobe Advertising コンバージョンデータがレポートにありません。_experience.adcloud オブジェクトが表示されません。Page Viewsなど)は、CJA Customer Journey Analytics Workspaceのレポートディメンション (Campaignなど)では使用できません。インストールとセットアップの問題 issues-installation-setup
WebSDK拡張機能がを初期化しません#websdk-extension-doesn’t-initialize
問題:
- ブラウザーのコード検査ツールのNetwork タブには、alloy ()呼び出しは表示されません。
- コンソールエラー:合金が定義されていません。
- edge.adobedc.netに対してインタラクションまたは収集リクエストは行われません。
考えられる原因と検証/解決
//assets.adobedtm.com/... スクリプトタグの<head> タグで環境を探します。データストリームが設定されていないか、設定が正しくありません datastream-not-configured-or-misconfigured
問題:
- リクエストはAdobe Experience Platform Edge Networkに到達しますが、400または500 エラーが返されます。
- Adobe AnalyticsまたはAdobe Advertising レポートにはデータが表示されません。
- ネットワーク応答のエラー:「データストリームが見つかりません」
考えられる原因と検証/解決
- Tagsで、タグプロパティの データストリーム設定設定を開きます。
- Datastream フィールドが、各環境(開発、ステージング、実稼動)の正しいデータストリーム、および正しいスキーマとデータセットを指していることを確認します。
3つの環境すべてで1つのデータストリームを明示的に共有しない限り、各環境には独自のデータストリームが必要です。
データストリーム設定を開き、次のサービスが有効になっていることを確認します。
- Adobe Advertising(コンバージョン/オーディエンス同期用)
- Adobe Experience Platform(プロファイル取得用)
Advertising拡張機能の設定に関する問題 advertising-extension-setup-issues
問題:
-
web ページのビュースルーコンバージョンまたはクリックスルーコンバージョンは記録されません。
コンバージョンが記録されているかどうかを確認するには:
- URLに
ef_id=test&s_kwcid=testが追加されたweb ページを開きます。 - ブラウザーのコード検査ツール(Inspectと呼ばれることが多い)を開き、「Network」タブを開き、Adobe Experience Platformのevent_type="advertising.enrichment_ct"のインタラクティブ呼び出しを探します。
- データ収集インターフェイスで、収集するweb サイト データのスキーマ定義を開き、
xdm->_experience->adcloud->conversionDetails->trackingCodeとtrackingIdentitiesにef_idとs_kwcidが含まれていることを確認します。
- URLに
-
クリックスルー用のExperience Data Model (XDM) ペイロードに
_experience.adcloudがありません。 -
コンバージョンはデバッガーツールで確認されますが、Adobe Advertising レポートには表示されません
考えられる原因と検証/解決
Adobe Advertising サービスが有効になっていません。-
Tagsで、タグプロパティの データストリーム設定設定を開きます。
-
次のサービスを有効にし、設定を保存します。
- Adobe Advertising(コンバージョン/オーディエンス同期用)
- Adobe Experience Platform(プロファイル取得用)
Adobe Advertising コンポーネントはWebSDK拡張機能に対して有効になっていません。WebSDK拡張機能のAdobe Advertising コンポーネントはデフォルトで無効になっており、XDM スキーマまたはルールの設定方法に関係なく、Adobe Advertising クリックスルーまたはビュースルーのトラッキングが機能する前に、明示的に有効にする必要があります。
- Tagsで、Adobe Experience Platform Web SDKの設定🔗で、プロパティの ビルドオプションを開きます。
- Advertising コンポーネントを有効にし、設定を保存します。
- ライブラリを再構築して再公開します。
Adobe Advertising コンポーネントが有効になると、s_kwcidおよびef_idのURL クエリパラメーターを使用して、クリックスルー追跡が自動的にアクティブになります。 ビュースルートラッキングはデフォルトで無効になっており、追加の設定が必要です。次の行を参照してください。- データストリームのAdobe Advertising サービスを有効にする
-
- Adobe Experience PlatformのData Collection > Datastreamsに移動し、Tags プロパティで使用されているデータストリームを開きます。
- サービスを追加を選択し、Adobe Advertisingおよび Adobe Experience Platform を選択してから、保存を選択します。 Adobe Advertising DSPでの広告主の設定
-
- Tagsで、Extensions > Installed > Adobe Experience Platform Web SDK > Configureに移動します。
- 「Advertiser」セクションで、ドロップダウンから広告主を選択して有効にします。 複数の広告主を設定するには、広告主を追加を選択します。 ビュースルーコンバージョンピクセルが起動していることを確認します
- Adobe Experience Platform Debuggerで、
xdm.queryフィールドの下にstitchIdが含まれていることを確認します。 - ブラウザーのコード検査ツールの「Network」タブで、タイプ
advertising.enrichmentのイベントが発生し、xdm.queryの下にstitchIdが含まれていることを確認します。
ビュースルーコンバージョンは、訪問数に関係なく、30分ごとに実行されます。 インタラクション呼び出しが表示されない場合は、ブラウザーのキャッシュをクリアして、もう一度試してください。
Advertising拡張機能の設定に関するサポートチケットを開く前に、次の点を確認してください。
- Adobe AdvertisingおよびAdobe Experience Platform サービスがデータストリームに追加されます。
- Adobe Advertising コンポーネントは、WebSDK拡張機能コンフィギュレーションで有効になっています。
- コンポーネントを有効にした後、ライブラリが再構築され、再公開されました。
- クリックスルー追跡の場合、ランディングページ URLには、広告クリック時に
s_kwcidとef_idが含まれます。 - ビュースルートラッキングの場合、広告主はAdobe Advertising DSPで正しい広告主IDで設定されます。
- WebSDK拡張機能は、バージョン 2.36.0以降です。
IDとECIDの問題 identity-and-ecid-issues
問題:
- ページ間で訪問者IDが変更されます。
- Advertisingのオーディエンスセグメントが一致しない。
考えられる原因と検証/解決
s_ecid Cookieが存在する間、idMigrationEnabledはfalseに設定されます。ルールまたはイベントが実行されない#rules-or-events-don’t-fire
問題:
- デバッガーは、ルール条件が満たされていないことを示します。
- Send Event アクションは実行されません。
検証と解決
次の点を確認します。
- ルールが保存され、アクティブな ライブラリビルド に含まれます。
- イベントタイプは、実際のページ動作(Library Loaded対DOM Ready対Window Loadedなど)と一致します。
- ルールの条件はそれほど制限されていません。 一時的に条件を削除してテストし、問題を分離します。
- ルールの順序は正しいです。 複数のルールが同じイベントを共有する場合は、 ルールの順序を確認してください。
- ページの以前のJavaScript エラーで実行が停止することはありません。 ブラウザーコンソールで捕捉されない例外がないか確認します。
ライブラリのビルドと公開の問題 library-build-and-publishing-issues
問題:
- Tagsで行われた変更は、ライブサイトに反映されません。
- 拡張機能の更新が適用されましたが、古い動作は保持されます。
考えられる原因と検証/解決
Advertising フィールドのスキーマ検証の問題 schema-validation-for-advertising-fields
問題:
alloy()送信イベント呼び出しは成功しましたが(応答は200)、Adobe Advertising コンバージョンデータがレポートにありません。- デバッガーのXDM ペイロードに
_experience.adcloudオブジェクトが表示されません。
考えられる原因と検証/解決
- Adobe Experience Platform > Data Management > Schemasに移動します。
- データストリームで使用するスキーマを開きます。
- Field Groups パネルで、Adobe Advertising Cloud ExperienceEvent Full Extensionがリストされていることを確認します。
- 見つからない場合は、追加を選択し、Adobe Advertising Cloudを検索し、Adobe Advertising Cloud ExperienceEvent Full Extensionを選択して、設定を保存します。
スキーマの変更だけではTags ライブラリを再公開する必要はありませんが、新しいフィールドが追加された場合は、TagsでXDM データ要素を再マッピングする必要があります。
_experience.adcloud.conversionDetailsの スキーマ に存在することを確認してください。 「参照:必須スキーマフィールド 」を参照してください。いずれかのフィールドが見つからない場合は、Adobe Advertising Cloud ExperienceEvent Full Extension フィールドグループがスキーマに保存されていることを確認してから、スキーマエディターを更新してください。
s_kwcidとef_id パラメーター(https://www.example.com/landing-page?s_kwcid=AL!12345!3!abc123&ef_id=abc123xyz:G:sなど)の両方のクエリを含める必要があります。 考えられる原因については、「参照:見つからないクエリパラメーター」を参照してください。edge.adobedc.netのフィルターを実行し、インタラクションのリクエスト本文を調べます(以下のペイロードの例を参照)。もし
trackingCodeまたはtrackingIdentityが空または見つからない場合、a) ルールが実行されたときにクエリパラメーターがページに存在しなかった(URLとルールのイベントタイミング確認)またはb)。参照:必須スキーマフィールド required-schema-fields
_experience.adcloud.conversionDetails.trackingCodes_kwcid クエリパラメーターから入力されました。_experience.adcloud.conversionDetails.trackingIdentityef_id クエリパラメーターから入力されました。参照:クエリパラメーターがありません missing-query-parameters
s_kwcidef_idクリックスルーのペイロードの例
{
"events": [{
"xdm": {
"eventType": "advertising.clicks",
"_experience": {
"adcloud": {
"conversionDetails": {
"trackingCode": "AL!12345!3!abc123",
"trackingIdentity": "abc123xyz:G:s"
}
}
}
}
}]
}
Customer Journey Analytics Workspaceのレポートの問題
概要レポート
- Customer Journey Analytics Workspaceが正しいデータビューを参照していることを確認します。
- Adobe AdvertisingからCustomer Journey Analyticsへのフィードが有効になっていることを確認します。 Adobeのアカウントチームにお問い合わせください。
- Adobe Advertising ディメンション/分類/参照データセットとサマリーデータセットがCustomer Journey Analytics接続に含まれていることを確認します。
- Adobe Advertisingのディメンションと概要指標がCustomer Journey Analytics データビューに含まれていることを確認します。
上記のすべての設定を確認しても概要データが表示されない場合は、組織の サポートチケット を開きます。
- Adobe AdvertisingからCustomer Journey AnalyticsへのフィードがAdvertiser 2に対して有効になっていることを確認します。 Adobeのアカウントチームにお問い合わせください。
- Customer Journey Analytics接続で3つのデータセット(ディメンション/分類/ルックアップ、サマリー、イベント指標)に対して設定「Backfill all existing data」が有効になっていることを確認します。
上記の条件をすべて確認しても概要データが表示されない場合は、組織の サポートチケット を開きます。
フィードがアカウントに対して有効になっていても概要データが表示されない場合は、組織の サポートチケット を開きます。 広告ネットワーク アカウントのAccount IDを含めます。
- WorkspaceとAdobe Advertising レポートの両方で同じ日付範囲を使用していることを確認してください。
- WorkspaceとAdobe Advertising レポートに適用されているフィルターとセグメントが、データの違いを引き起こしていないことを確認します。
- Customer Journey Analytics データビューのTime Zoneが、Advertising DSP アカウント のDefault Timezoneと一致することを確認してください。
- Customer Journey Analytics接続で3つのデータセット(ディメンション/分類/ルックアップ、サマリー、イベント指標)に対して設定「Backfill all existing data」が有効になっていることを確認します。
データの相違が確認できる場合は、組織の サポートチケット を開きます。 広告ネットワーク アカウントのAccount IDを含めます。 食い違いの証拠を示すには、スクリーンショットとスプレッドシートを含めます。 Adobe アカウントチームは、必要に応じてデータフィードを過去にさかのぼって修正し、差異を解決できます。
イベントレベルのレポート
Page Viewsなど)は、Customer Journey Analytics Workspaceのレポートディメンション (Campaignなど)では使用できません。以下を確認します。最初に、検証障壁が最も少ない項目を確認します。
- 正しいデータビューを使用していることを確認してください。
- 該当するコンバージョン指標がweb/オンラインイベントであり、Adobe Advertisingがディメンションに関連付けられていることを確認します。
- Adobe Advertisingが、該当するサイトのクリックスルーとビュースルーを追跡していることを確認します。
- 分類データセットのCustomer Journey Analytics接続で、KeyおよびMatching Key設定の値が正しいことを確認します:Key:
Tracking Code(_customername.adLens2.trackingCode)、Matching Key:Tracking Code(event._experience.adcloud.conversionDetails.trackingCode)。 - Adobe Advertising サービスがAdobe Experience Platform データストリームに追加されていること、データストリーム用にマッピングされたスキーマが
XDM ExperienceEvent Schemaであること、フィールドグループAdobe Advertising Cloud ExperienceEvent Full ExtensionがXDM ExperienceEventスキーマに追加されていることを確認します。 - Adobe Advertisingの設定がWebSDK拡張機能で正しく設定され、公開されていることを確認します。
上記のすべての設定を確認しても、コンバージョンデータが表示されない場合は、組織の サポートチケット を開きます。 広告ネットワーク アカウントのAccount IDを含めます。
便利な検証ツールとデバッグツール
Adobe Experience Platform Debugger
ChromeのAdobe Experience Platform Debugger拡張機能をインストールします:
- すべてのWebSDK
alloy()呼び出しのリアルタイム ビュー - データストリーム IDと環境の検証
- XDM ペイロード検査
- Edge Networkのリクエストとレスポンスの詳細
デバッガーのキーチェック:
advertising.enrichment イベントタイプで確認します。ブラウザーのコード検査ツールのNetwork タブ
ブラウザーのコード検査ツール(「Inspect」と呼ばれることが多い)の「Network」タブを使用して、次の操作を行います。
生のEdge Network リクエストを調べるためにedge.adobedc.netでフィルタリングします。
- リクエスト URL:
https://[org-id].data.adobedc.net/ee/v2/interact - メソッド:
POST - ステータス:
200(正常)、400(不正なペイロード)、または500(サーバーまたはデータストリームエラー)
次のリクエストペイロードを確認します。
- 正しい
dataStreamId - 予期されたフィールドを持つ
xdmオブジェクトの存在 - ECIDが入力された
identityMap
コンソールの検証
インストールされているWebSDKのバージョンを確認します。
window.alloy.version
テストイベントを手動でトリガーする:
alloy("sendEvent", {
xdm: {
eventType: "web.webpagedetails.pageViews",
web: {
webPageDetails: { name: "Test Page", URL: window.location.href }
}
}
}).then(result => console.log("Edge response:", result))
.catch(err => console.error("Send event error:", err));
サポートをリクエストする前に、クイックリファレンスチェックリストを参照する
サポートチケットを開封する前に、次の点を確認してください。
- WebSDK拡張機能は最新バージョンです。
- ライブラリが公開され、埋め込みコードが環境に適しています。
- データストリーム IDは、開発、ステージング、実稼動用に正しく設定されます。
- 必要なすべてのデータストリームサービスが有効になります。
- Advertising コンポーネントはWebSDK拡張機能の設定で有効になっており、DSP広告主IDが設定されています。
- XDM スキーマには、Advertising フィールドグループが含まれています。
- Send Event ルールにはID マップが含まれており、正しいイベントに対して実行されます。
- Edge Network リクエストをブロックしているCSPまたはブラウザーのプライバシー設定はありません。
- Adobe Experience Platform Debuggerは、出来事がEdge Networkに到達していることを認める。
- ブラウザーコンソールで実行を停止しているJavaScript エラーはありません。
Adobe Advertising Cloud ExperienceEvent Full Extensionフィールドグループがスキーマに追加されます。_experience.adcloud.conversionDetails.trackingCodeはスキーマに存在します。_experience.adcloud.conversionDetails.trackingIdentityはスキーマに存在します。- ランディングページ URLには、クリックスルー時に
s_kwcidとef_idの両方のパラメーターが含まれています。 - Adobe Experience Platform Debuggerは、
conversionDetailsがアウトバウンドペイロードに入力されていることを確認します。
問題をエスカレーションするタイミング
次の場合は、Adobeのアカウントチームまたはエンジニアリングチームにお問い合わせください。
- Edge Network リクエストは、データストリームの検証後に永続的な
500エラーを返します。 - Advertising個のコンバージョンがデバッガーで確認されますが、24 ~ 48時間後にレポートに表示されません。
- WebSDK バージョンのアップデートでは、以前のバージョンには存在しなかった回帰が導入されます。 サポートチケットに特定のバージョン番号を含めます。