文件Experience Cloud KCS

CDN或Dispatcher重新導向Adobe Experience Manager期間遺失的查詢引數

最後更新： 2026年6月22日

在Adobe Experience Manager as a Cloud Service中，查詢引數（例如utm、gclid和fbclid）會在重新導向期間移除。 當CDN移除引數或重新導向忽略查詢字串時，此行為會影響重新導向邏輯和追蹤。 若要修正此問題，請更新CDN設定並使用正確的重新導向規則。

說明 description

環境

Adobe Experience Manager as a Cloud Service

Adobe Experience Manager資產

問題/症狀

  • UTM引數（例如utm_source、utm_campaign或gclid）在重新導向後消失。
  • 根據%{QUERY_STRING}的Dispatcher重新導向規則不會執行。
  • 使用reqProperty: path時，CDN層級重新導向會卸除所有查詢引數。
  • 重新導向可在本機或AMS中運作，但在雲端環境中會失敗。

解決方法 resolution

若要修正此問題，請遵循下列步驟：

  1. 識別在到達Dispatcher之前查詢引數是否遺失，或只在重新導向期間遺失。

  2. 使用下列結構建立或更新存放庫中的cdn.yaml檔案：

    code language-none 
    kind: "CDN"
version: "1"
metadata:
  envTypes: [ "dev", "stage", "prod"]
data:
  requestTransformations:
    removeMarketingParams: false
    rules: [ ]

  3. 如果驗證失敗，遺失rules屬性，請在requestTransformations下新增空的rules: [ ]專案。

  4. 重新測試並確認查詢引數已保留。

  5. 檢查cdn.yaml和Dispatcher設定中是否有衝突的重新導向規則。

  6. 如果使用CDN重新導向，請設定reqProperty: url而非reqProperty: path。

  7. 確認比對和轉換規則適用於包含查詢引數的URL。

  8. 更新Dispatcher重新導向規則，以使用QSA保留查詢引數：

    code language-none 
    RewriteRule /path$ /target [ R=301,L,QSA]

相關閱讀

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