文档Experience Cloud KCS

自定义营销查询参数导致缓存丢失

最近更新： 2026年7月8日

在AEMaaCS中，包含自定义营销查询参数的促销活动URL可能会降低CDN和Dispatcher缓存效率。 发生这种情况是因为完整的请求URL（包括查询参数）将成为缓存键的一部分，除非在缓存层一致地删除或忽略这些参数。 标准营销参数可能已得到处理，但自定义参数（如elq_cid）仍可以创建单独的缓存条目并增加原始流量。 查看CDN和Dispatcher配置，以便自定义营销参数不再片段缓存条目。

描述 description

环境

  • Adobe Experience Manager as a Cloud Service (AEMaaCS)
  • Adobe管理的CDN或客户管理的CDN
  • Dispatcher

症状

  • 营销活动流量期间缓存命中率下降。
  • 只有参数（如elq_cid或类似的跟踪值）不同的请求不会重复使用相同的缓存响应。
  • 即使页面内容不会因查询参数而更改，原始流量也会增加。
  • Dispatcher会忽略某些参数，但缓存碎片仍然存在，因为CDN层处理这些参数的方式有所不同。

原因

CDN缓存键包括完整的请求URL，其中包括查询参数。 如果未在CDN层删除或规范化自定义营销参数，则每个唯一的参数值将创建一个单独的缓存条目。 Dispatcher可以通过忽略选定的查询参数来减少缓存碎片，但是如果CDN或客户管理的CDN仍将这些参数视为唯一的请求变体，则无法完全保护缓存效率。

解决方法 resolution

要解决由自定义营销查询参数导致的缓存未命中，请执行以下步骤：

  1. 识别不会更改页面响应的自定义营销查询参数，如elq_cid或类似的促销活动跟踪值。
  2. 请查看CDN配置，并确保删除或标准化这些参数，然后它们才会成为缓存键的一部分。
  3. 如果您使用客户管理的CDN，请在该处配置等效规则，以便CDN不会将这些自定义参数视为唯一的缓存变体。
  4. 查看Dispatcher配置，并在适当时将相同的无法正常运行的营销参数添加到ignoreUrlParams。
  5. 部署CDN和Dispatcher配置更改。
  6. 使用不同的自定义营销参数值重新测试对同一页面的请求，并确认缓存命中率已得到提高。
  7. 如果配置更改后缓存碎片继续存在，请联系Adobe支持，并共享受影响的参数名称、请求示例和缓存行为。

相关阅读

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