疑難排解Customer Journey Analytics中的Adobe Advertising資料
以下是潛在問題、其可能原因和解決方案。
所有潛在問題的清單
_experience.adcloud。alloy()傳送事件呼叫成功(回應為200),但報表中缺少Adobe Advertising轉換資料。_experience.adcloud物件。安裝和設定問題 issues-installation-setup
WebSDK擴充功能未初始化#websdk-extension-doesn’t-initialize
問題:
- 在瀏覽器的程式碼檢查工具的Network標籤中看不到alloy()呼叫。
- 主控台錯誤:未定義alloy。
- 不會向edge.adobedc.net發出互動或收集請求。
可能的原因和驗證/解決方案
資料流未設定或設定錯誤 datastream-not-configured-or-misconfigured
問題:
- 要求會連線至Adobe Experience Platform Edge Network,但傳回400或500個錯誤。
- Adobe Analytics或Adobe Advertising報表中不會出現任何資料。
- 網路回應中的錯誤:「找不到資料流」
可能的原因和驗證/解決方案
- 在Tags中,開啟標籤屬性的資料流組態設定。
- 確認Datastream欄位指向每個環境(開發、測試和生產)的正確資料流,以及正確的結構和資料集。
除非您在所有三個環境中明確共用一個資料流,否則每個環境都應該有自己的資料流。
開啟資料流設定,並確認下列服務已啟用:
- Adobe Advertising (用於轉換/對象同步)
- Adobe Experience Platform (用於設定檔擷取)
Advertising擴充功能設定問題 advertising-extension-setup-issues
問題:
-
不會針對網頁記錄任何瀏覽轉換或點進轉換。
若要驗證是否已記錄轉換:
- 開啟網頁並附加
ef_id=test&s_kwcid=test至URL。 - 開啟瀏覽器的程式碼檢查工具(通常稱為Inspect),開啟Network標籤,並從Adobe Experience Platform尋找event_type="advertising.enrichment_ct"的互動呼叫。
- 在資料收集介面中,開啟您要收集之網站資料的結構描述定義,並確認
xdm->_experience->adcloud->conversionDetails->trackingCode和trackingIdentities包含ef_id和s_kwcid。
- 開啟網頁並附加
-
點進的Experience Data Model (XDM)承載中缺少
_experience.adcloud。 -
轉換會在除錯工具中確認,但不會出現在Adobe Advertising報表中
可能的原因和驗證/解決方案
Adobe Advertising服務。-
在Tags中,開啟標籤屬性的資料流組態設定。
-
啟用下列服務並儲存設定:
- Adobe Advertising (用於轉換/對象同步)
- Adobe Experience Platform (用於設定檔擷取)
Adobe Advertising元件。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 服務已新增至資料流。
- 已在WebSDK擴充功能組態中啟用 Adobe Advertising 元件。
- 啟用元件後,已重建及重新發佈程式庫。
- 針對點進追蹤,登陸頁面URL在廣告點按上包含
s_kwcid和ef_id。 - 針對閱覽追蹤,廣告商在Adobe Advertising DSP中設定為使用正確的廣告商ID。
- WebSDK擴充功能的版本為2.36.0或更新版本。
身分和ECID問題 identity-and-ecid-issues
問題:
- 訪客ID會在頁面之間變更。
- Advertising對象區段不相符。
可能的原因和驗證/解決方案
s_ecid Cookie時,idMigrationEnabled設為false。規則或事件不會觸發#rules-or-events-don’t-fire
問題:
- 除錯程式會顯示系統未符合規則條件。
- Send Event動作永遠不會執行。
驗證與解析
請確認下列專案:
程式庫建置和發佈問題 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完整擴充功能。
- 如果遺失,請選取「新增」,搜尋Adobe Advertising Cloud,選取「Adobe Advertising Cloud ExperienceEvent完整擴充功能」,然後儲存設定。
結構描述變更不需要單獨重新發佈您的Tags資料庫,但如果新增新欄位,則必須重新對應Tags中的XDM資料元素。
_experience.adcloud.conversionDetails下的結構描述中存在必要的Adobe Advertising欄位。 請參閱參考:必要的結構描述欄位。如果缺少任一欄位,請確認 Adobe Advertising Cloud ExperienceEvent完整擴充功能 欄位群組已儲存至結構描述,然後重新整理結構描述編輯器。
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的摘要已為廣告商2啟用。 請洽詢您的Adobe客戶團隊。
- 確認在Customer Journey Analytics連線中,已為您的三個資料集(維度/分類/查詢、摘要和事件量度)啟用設定"Backfill all existing data"。
如果您已驗證上述所有條件,但仍看不到摘要資料,請為您的組織開啟支援票證。
如果帳戶已啟用摘要,但您仍然看不到摘要資料,請為您的組織開啟支援票證。 包含廣告網路帳戶的Account ID。
- 確認您在Workspace和Adobe Advertising報表中使用相同的日期範圍。
- 確認Workspace和Adobe Advertising報表中套用的任何篩選器和區段不會造成資料差異。
- 確認您Customer Journey Analytics資料檢視的Time Zone符合您Advertising DSP帳戶的Default Timezone。
- 確認在Customer Journey Analytics連線中,已為您的三個資料集(維度/分類/查詢、摘要和事件量度)啟用設定"Backfill all existing data"。
如果您確定資料不一致,請為您的組織開啟支援票證。 包含廣告網路帳戶的Account ID。 若要顯示差異的證據,請包含熒幕擷取畫面和電子表格。 您的Adobe客戶團隊可回溯修正資料摘要,以視需要解決差異。
事件層級報表
Page Views)不適用於報表維度(例如Campaign)。從驗證障礙最少的專案開始,驗證以下內容:
- 確認您使用正確的資料檢視。
- 確認適用的轉換量度為網頁/線上事件,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標籤
使用瀏覽器程式碼檢查工具的Network標籤(通常稱為「Inspect」)執行下列動作:
依edge.adobedc.net篩選以檢查原始Edge Network請求:
- 要求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規則包含識別對應,並在正確的事件上引發。
- 沒有CSP或瀏覽器隱私設定會封鎖Edge Network請求。
- 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錯誤。 - 已在Debugger中確認Advertising次轉換,但24-48小時後不會出現在報表中。
- WebSDK版本更新引進了舊版中不存在的回歸。 在支援票證中包含特定版本號碼。