跳到正文
AsKlear Data开发者文档

商品变化贡献

通过两次商品级原子查询归因跨期销售额变化。

Markdown文档 ID: agent.dataset.jd.task.product_contribution

租户实际范围和当前数据时间以认证后的 describe 返回为准。

必要输入

scope必填 · search_values

精确品类范围

category_l3
periods必填 · user_required

两个可比较期间

执行步骤

  1. 1
    resolve_scope · search_values

    对齐品类值。

    调用参数
    category_l3 ← $scope
  2. 2
    query_first_period · query_metrics

    查询第一个期间的商品销售额。

    调用参数
    metrics: gmvgroup_by: product_id, title, product_urlfilter: category_l3 eq $scopetime: $periods.firstlimit: 1000
  3. 3
    query_second_period · query_metrics

    查询第二个期间的商品销售额。

    调用参数
    metrics: gmvgroup_by: product_id, title, product_urlfilter: category_l3 eq $scopetime: $periods.secondlimit: 1000

Agent 计算

compute_contribution · contribution

按商品 ID 连接、计算期间差值并排序贡献。

source_steps: query_first_period, query_second_period

输出纪律

  • 展示商品 ID、标题、标准链接、变化量及其对总变化的贡献。

停止条件

  • 两个期间或筛选条件不一致时停止。
  • 任一期间响应的 meta.truncated=true 时停止并说明结果被截断。

限制

  • 贡献度是算术归因，不是因果推断。
  • 归因要求来源查询完整；以每个响应的 meta.truncated 标记为唯一判断依据。