AEMaaCSのバックエンドリクエストにマーケティングクエリパラメーターが見つからない
AEM as a Cloud Serviceでは、utm_*、cid、bidなどのマーケティングクエリパラメーターは、バックエンドサーブレットまたはサービスでは使用できません。 CDNは、リクエストがDispatcherまたはAEMに到達する前に、これらのパラメーターを削除します。これは、ビジネス処理に依存するサーバーサイドロジックに影響を与えます。 この問題を修正するには、マーケティングクエリパラメーターを保持するようにCDN設定を更新します。
説明 description
環境
- 製品： Adobe Experience Manager as a Cloud Service - Sites
- 2023年10月以降に作成された スコープ：環境（デフォルトの動作）
問題/症状
utm_source、cid、bidなどのマーケティングおよびキャンペーン関連のクエリパラメーターが、ブラウザーリクエストに表示されます。- これらのクエリパラメーターは、バックエンドサーブレットまたはサービスに到達しません。
- サーバーサイド ロジックは、マーケティングクエリパラメーター値にアクセスできません。
解決策 resolution
この問題を修正するには、次の手順に従います。
- 影響を受ける環境の
cdn.yaml設定ファイルを開きます。 requestTransformationsに関連するセクションを探します。removeMarketingParamsフラグをrequestTransformationsのfalseに設定します。- 更新した設定を保存して、リポジトリにコミットします。
- 環境の設定パイプラインを使用して、更新された
cdn.yamlファイルをデプロイします。 - デプロイメントが完了したら、バックエンドサーブレットとサービスがマーケティングクエリパラメーターを受け取ることを確認します。
注意：
- この動作は、デフォルトでは、2023年10月以降に作成された環境にのみ適用されます。 古い環境では、明示的な有効化が必要です。
- ブラウザーで実行されているクライアントサイドスクリプトは、削除はCDN レベルでのみ行われるため、マーケティングクエリパラメーターに引き続きアクセスします。
- Adobeでは、バックエンド処理で必要な場合、クライアントサイドでマーケティングパラメーターを処理するか、リクエスト本文またはカスタムヘッダーを通して渡すことをお勧めします。
- 2023年10月より前に作成された環境に対するグローバルな適用日は存在しません。 必要に応じて、この動作を手動で有効にします。
experience-cloud-kcs-help-kbarticles