ドキュメントExperience Cloud KCS

CDNまたはDispatcherがAdobe Experience Managerをリダイレクトする際に失われるクエリパラメーター

最終更新日： 2026年6月23日

Adobe Experience Manager as a Cloud Serviceでは、リダイレクト中にutm、gclid、fbclidなどのクエリパラメーターが削除されます。 この動作は、CDNがパラメーターを取り除いたり、リダイレクトがクエリ文字列を無視したりする場合のリダイレクトロジックとトラッキングに影響します。 この問題を修正するには、CDN設定を更新し、正しいリダイレクトルールを使用します。

説明 description

環境

Adobe Experience Manager as a Cloud Service

Adobe Experience Manager Asset

問題/症状

  • utm_source、utm_campaign、gclidなどのUTM パラメーターは、リダイレクト後に消えます。
  • %{QUERY_STRING}に応じたDispatcher リダイレクト ルールは実行されません。
  • CDN レベルのリダイレクトは、reqProperty: pathの使用時にすべてのクエリパラメーターをドロップします。
  • ローカルまたは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: pathではなくreqProperty: urlを設定します。

  7. 一致ルールと変換ルールが、クエリパラメーターを含むURLに適用されることを確認します。

  8. QSAを使用してクエリパラメーターを保持するようにDispatcher リダイレクトルールを更新します。

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

関連トピックス

  • AEM as a Cloud ServiceのCDN
  • OSGi構成設定
  • CDNでのトラフィックの設定
  • AEMaaCS🔗のバックエンドリクエストに マーケティングクエリパラメーターがありません
recommendation-more-help
experience-cloud-kcs-help-kbarticles