AEMaaCS中的后端请求中缺少营销查询参数
在AEM as a Cloud Service中,营销查询参数(如utm_*、cid和bid)对后端Servlet或服务不可用。 CDN会在请求到达Dispatcher或AEM之前删除这些参数,这会影响依赖这些参数进行业务处理的服务器端逻辑。 要解决此问题,请更新CDN配置以保留营销查询参数。
描述 description
环境
- 产品: Adobe Experience Manager as a Cloud Service — 站点
- 范围:在2023年10月或之后创建的环境(默认行为)
问题/症状
- 营销和营销活动相关的查询参数,如
utm_source、cid和bid,显示在浏览器请求中。 - 这些查询参数无法访问后端servlet或服务。
- 服务器端逻辑无法访问营销查询参数值。
解决方法 resolution
要解决此问题,请执行以下步骤:
- 打开受影响环境的
cdn.yaml配置文件。 - 找到与
requestTransformations相关的部分。 - 在
requestTransformations下将removeMarketingParams标志设置为false。 - 保存更新后的配置并将其提交到存储库。
- 使用环境的配置管道部署更新的
cdn.yaml文件。 - 部署完成后,确认后端servlet和服务接收营销查询参数。
注意:
- 默认情况下,此行为仅适用于2023年10月或之后创建的环境。 较旧的环境需要明确启用。
- 在浏览器中运行的客户端脚本可继续访问营销查询参数,因为删除仅在CDN级别发生。
- Adobe建议在客户端处理营销参数,或者在后端处理需要时,通过请求正文或自定义标头传递这些参数。
- 对于在2023年10月之前创建的环境,不存在全局实施日期。 需要时手动启用此行为。
相关阅读
recommendation-more-help
experience-cloud-kcs-help-kbarticles