Documentación

Faltan parámetros de consulta de marketing en las solicitudes back-end de AEMaaCS

Last update: Wed Apr 15 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

En AEM as a Cloud Service, los parámetros de consulta de marketing como utm_*, cid y bid no están disponibles para los servlets o servicios back-end. La CDN elimina estos parámetros antes de que las solicitudes lleguen a Dispatcher o AEM, lo que afecta a la lógica del lado del servidor que depende de ellos para el procesamiento empresarial. Para solucionar este problema, actualice la configuración de CDN para conservar los parámetros de consulta de marketing.

Descripción description

Entorno

  • Producto: Adobe Experience Manager as a Cloud Service - Sitios
  • Ámbito: Entornos creados en octubre de 2023 o posterior (comportamiento predeterminado)

Problema/Síntomas

  • Los parámetros de consulta de marketing y relacionados con campañas como utm_source, cid y bid aparecen en las solicitudes de explorador.
  • Estos parámetros de consulta no llegan a los servlets o servicios back-end.
  • La lógica del lado del servidor no puede acceder a los valores de parámetros de consulta de marketing.

Resolución resolution

Para solucionar este problema, siga estos pasos:

  1. Abra el archivo de configuración cdn.yaml del entorno afectado.
  2. Busque la sección relacionada con requestTransformations.
  3. Establezca el indicador removeMarketingParams en false en requestTransformations.
  4. Guarde y confirme la configuración actualizada en el repositorio.
  5. Implemente el archivo cdn.yaml actualizado mediante la canalización de configuración del entorno.
  6. Una vez finalizada la implementación, confirme que los servlets y servicios back-end reciben los parámetros de consulta de marketing.

Notas:

  • Este comportamiento se aplica de forma predeterminada solo a los entornos creados en octubre de 2023 o posterior. Los entornos más antiguos requieren una habilitación explícita.
  • Los scripts del lado del cliente que se ejecutan en los exploradores siguen accediendo a los parámetros de consulta de marketing porque la eliminación solo se produce en el nivel de CDN.
  • Adobe recomienda administrar los parámetros de marketing del lado del cliente o pasarlos a través del cuerpo de la solicitud o los encabezados personalizados cuando el procesamiento back-end los requiera.
  • No existe una fecha de aplicación global para los entornos creados antes de octubre de 2023. Active este comportamiento manualmente cuando sea necesario.

Lectura relacionada

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f