AEMaaCS中後端請求缺少行銷查詢引數
在AEM as a Cloud Service中,行銷查詢引數(例如utm_*、cid和bid)不適用於後端Servlet或服務。 CDN會在請求到達Dispatcher或AEM之前移除這些引數,進而影響依賴這些引數進行業務處理的伺服器端邏輯。 若要修正此問題,請更新CDN設定以保留行銷查詢引數。
說明 description
環境
- 產品: Adobe Experience Manager as a Cloud Service — 網站
- 範圍:在2023年10月或之後建立的環境(預設行為)
問題/症狀
- 行銷和促銷活動相關的查詢引數,例如
utm_source、cid和bid,會出現在瀏覽器要求中。 - 這些查詢引數不會到達後端servlet或服務。
- 伺服器端邏輯無法存取行銷查詢引數值。
解決方法 resolution
若要修正此問題,請遵循下列步驟:
- 開啟受影響環境的
cdn.yaml設定檔。 - 找到與
requestTransformations相關的區段。 - 將
requestTransformations下的removeMarketingParams旗標設為false。 - 儲存更新後的設定並將其認可到您的存放庫。
- 使用環境的設定管道來部署更新的
cdn.yaml檔案。 - 部署完成後,請確認後端servlet和服務會收到行銷查詢引數。
附註:
- 依預設,此行為僅適用於2023年10月或之後建立的環境。 較舊的環境需要明確啟用。
- 在瀏覽器中執行的使用者端指令碼會繼續存取行銷查詢引數,因為移除只會發生在CDN層級。
- Adobe建議您在使用者端處理行銷引數,或是在後端處理需要時,透過請求內文或自訂標頭傳遞這些引數。
- 2023年10月之前建立的環境沒有全球執行日期。 需要時手動啟用此行為。
相關閱讀
recommendation-more-help
experience-cloud-kcs-help-kbarticles