AEMaaCS中後端請求缺少行銷查詢引數

在AEM as a Cloud Service中,行銷查詢引數(例如utm_*cidbid)不適用於後端Servlet或服務。 CDN會在請求到達Dispatcher或AEM之前移除這些引數,進而影響依賴這些引數進行業務處理的伺服器端邏輯。 若要修正此問題,請更新CDN設定以保留行銷查詢引數。

說明 description

環境

  • 產品: Adobe Experience Manager as a Cloud Service — 網站
  • 範圍:在2023年10月或之後建立的環境(預設行為)

問題/症狀

  • 行銷和促銷活動相關的查詢引數,例如utm_sourcecidbid,會出現在瀏覽器要求中。
  • 這些查詢引數不會到達後端servlet或服務。
  • 伺服器端邏輯無法存取行銷查詢引數值。

解決方法 resolution

若要修正此問題,請遵循下列步驟:

  1. 開啟受影響環境的cdn.yaml設定檔。
  2. 找到與requestTransformations相關的區段。
  3. requestTransformations下的removeMarketingParams旗標設為false
  4. 儲存更新後的設定並將其認可到您的存放庫。
  5. 使用環境的設定管道來部署更新的cdn.yaml檔案。
  6. 部署完成後,請確認後端servlet和服務會收到行銷查詢引數。

附註:

  • 依預設,此行為僅適用於2023年10月或之後建立的環境。 較舊的環境需要明確啟用。
  • 在瀏覽器中執行的使用者端指令碼會繼續存取行銷查詢引數,因為移除只會發生在CDN層級。
  • Adobe建議您在使用者端處理行銷引數,或是在後端處理需要時,透過請求內文或自訂標頭傳遞這些引數。
  • 2023年10月之前建立的環境沒有全球執行日期。 需要時手動啟用此行為。

相關閱讀

recommendation-more-help
experience-cloud-kcs-help-kbarticles