Omniture(Site Catalyst) API滚动日期配置及Klipfolio自动取数咨询

嘿，好消息！Adobe Analytics（也就是之前的Omniture/Site Catalyst）的Reporting API完全支持滚动/相对日期参数，完美解决你在Klipfolio里自动获取过去52周数据的需求，不用再手动硬编码固定日期了。

下面分享两种靠谱的实现方式，结合Klipfolio的场景给你拆解：

1. 直接用API的相对日期字符串替代固定日期 #

Adobe Analytics API允许用自然语言风格的相对日期字符串来替换dateFrom和dateTo参数，比如要获取从当前日期往前推52周到今天的数据，你可以把请求体改成这样：

{
  "dateFrom": "minus 52 weeks",
  "dateTo": "today"
}

或者用更简洁的缩写格式：

{
  "dateFrom": "current-52w",
  "dateTo": "current"
}

这里的current会自动解析为API调用瞬间的系统日期，current-52w就是当前日期往前倒推52周的日期，完全自动计算，不用你手动改。

2. 用dateRangeType配置标准化滚动范围 #

如果你想要更规范的配置方式，可以用API的dateRangeType参数指定为rolling，再搭配rollingDateRange参数直接定义范围：

{
  "dateRangeType": "rolling",
  "rollingDateRange": "Last 52 Weeks"
}

这种方式不需要单独写dateFrom和dateTo，API会自动帮你计算对应的时间区间，非常省心。

3. 结合Klipfolio的动态日期变量（适配Klipfolio场景） #

Klipfolio本身也自带系统日期变量，比如{{date.today}}（当前日期）、{{date.today-52w}}（今天往前52周的日期），你可以直接在Klipfolio的API请求配置里用这些变量来生成参数：

{
  "dateFrom": "{{date.today-52w}}",
  "dateTo": "{{date.today}}"
}

每次Klipfolio刷新仪表盘时，都会自动把这些变量替换成真实的日期值，彻底实现自动化拉取。

小提醒 #

• 先确认你的Adobe Analytics API权限足够访问目标报表的数据；
• 可以先用Postman之类的工具测试下相对日期参数的返回结果，确保时间范围符合预期；
• 如果遇到日期格式不匹配的问题，在Klipfolio里把日期变量的输出格式改成YYYY-MM-DD，和API要求的格式对齐就行。

内容的提问来源于stack exchange，提问作者Vipul Rodrigues