AEMaaCS中的后端请求中缺少营销查询参数

在AEM as a Cloud Service中,营销查询参数(如utm_*cidbid)对后端Servlet或服务不可用。 CDN会在请求到达Dispatcher或AEM之前删除这些参数,这会影响依赖这些参数进行业务处理的服务器端逻辑。 要解决此问题,请更新CDN配置以保留营销查询参数。

描述 description

环境

  • 产品: Adobe Experience Manager as a Cloud Service — 站点
  • 范围:在2023年10月或之后创建的环境(默认行为)

问题/症状

  • 营销和营销活动相关的查询参数,如utm_sourcecidbid,显示在浏览器请求中。
  • 这些查询参数无法访问后端servlet或服务。
  • 服务器端逻辑无法访问营销查询参数值。

解决方法 resolution

要解决此问题,请执行以下步骤:

  1. 打开受影响环境的cdn.yaml配置文件。
  2. 找到与requestTransformations相关的部分。
  3. requestTransformations下将removeMarketingParams标志设置为false
  4. 保存更新后的配置并将其提交到存储库。
  5. 使用环境的配置管道部署更新的cdn.yaml文件。
  6. 部署完成后,确认后端servlet和服务接收营销查询参数。

注意:

  • 默认情况下,此行为仅适用于2023年10月或之后创建的环境。 较旧的环境需要明确启用。
  • 在浏览器中运行的客户端脚本可继续访问营销查询参数,因为删除仅在CDN级别发生。
  • Adobe建议在客户端处理营销参数,或者在后端处理需要时,通过请求正文或自定义标头传递这些参数。
  • 对于在2023年10月之前创建的环境,不存在全局实施日期。 需要时手动启用此行为。

相关阅读

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