DocumentaçãoKCS da Experience Cloud

Parâmetros de consulta de marketing ausentes nas solicitações de backend no AEMaaCS

Última atualização: 21 de junho de 2026

No AEM as a Cloud Service, parâmetros de consulta de marketing como utm_*, cid e bid não estão disponíveis para servlets ou serviços de back-end. A CDN remove esses parâmetros antes que as solicitações atinjam o Dispatcher ou o AEM, o que afeta a lógica do lado do servidor que depende deles para o processamento de negócios. Para corrigir esse problema, atualize a configuração do CDN para manter os parâmetros de consulta de marketing.

Descrição description

Ambiente

  • Produto: Adobe Experience Manager as a Cloud Service - Sites
  • Escopo: ambientes criados em outubro de 2023 ou posterior (comportamento padrão)

Problema/Sintomas

  • Parâmetros de marketing e de consulta relacionados à campanha, como utm_source, cid e bid, aparecem em solicitações do navegador.
  • Esses parâmetros de consulta não atingem servlets ou serviços de back-end.
  • A lógica do lado do servidor não pode acessar os valores do parâmetro de consulta de marketing.

Resolução resolution

Para corrigir esse problema, siga estas etapas:

  1. Abra o arquivo de configuração cdn.yaml do ambiente afetado.
  2. Localize a seção relacionada a requestTransformations.
  3. Defina o sinalizador removeMarketingParams como false em requestTransformations.
  4. Salve e confirme a configuração atualizada no repositório.
  5. Implante o arquivo cdn.yaml atualizado usando o pipeline de configuração do ambiente.
  6. Após a conclusão da implantação, confirme se os servlets e serviços de backend recebem os parâmetros de consulta de marketing.

Notas:

  • Esse comportamento se aplica por padrão somente a ambientes criados em outubro de 2023 ou posterior. Ambientes mais antigos exigem ativação explícita.
  • Os scripts do lado do cliente em execução nos navegadores continuam a acessar parâmetros de consulta de marketing porque a remoção ocorre somente no nível de CDN.
  • A Adobe recomenda manipular parâmetros de marketing no lado do cliente ou passá-los pelo corpo da solicitação ou por cabeçalhos personalizados quando o processamento de backend os exigir.
  • Não existe data de aplicação global para ambientes criados antes de outubro de 2023. Ative esse comportamento manualmente quando necessário.

Leitura relacionada

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