---
document_id: agent.dataset.pdd.task.product_performance
schema_version: 2
parent_document_id: agent.dataset.pdd
section: capabilities
---

<!-- Generated by scripts.build_agent_guide; do not edit. -->

# Product performance / 商品销售表现

Query monthly sales metrics for one exact PDD product reference. / 查询一个精确拼多多商品引用的月度销售指标。

## Required inputs / 必要输入

- `product_reference` — `exact_reference`; required (`product_id`): Exact PDD product ID or standard URL
  精确拼多多商品 ID 或标准链接
- `time` — `user_required`; required: Analysis time range
  分析时间范围

## Steps / 步骤

1. `query_product` · `query_metrics` — Query monthly GMV, units, and ASP.
   查询月度销售额、销量和平均成交价。
   - metrics: `gmv`, `units`, `asp`
   - group_by: `product_id`, `title`, `product_url`, `month`
   - result entity: `product`
   - filters: `product_id eq ${product_reference}`
   - time: `${time}`

## Call example / 调用示例

Replace the example values with exact user inputs or values returned by `search_values`. / 将示例值替换为用户的精确输入或 `search_values` 返回的平台原始值。

`query_metrics`

```json
{
  "metrics": [
    "gmv",
    "units",
    "asp"
  ],
  "time": {
    "last_complete_months": 3
  },
  "group_by": [
    "product_id",
    "title",
    "product_url",
    "month"
  ],
  "filters": [
    {
      "field": "product_id",
      "op": "eq",
      "value": "示例商品 ID"
    }
  ],
  "task_query": "使用 pdd 数据执行商品销售表现；product_reference=示例商品 ID，time={\"last_complete_months\":3}",
  "dataset": "pdd"
}
```


## Output requirements / 输出要求

- Include product ID, title, canonical URL, monthly values, data coverage, and metric definitions.
  包含商品 ID、标题、标准链接、月度数值、数据覆盖范围和指标口径。

## Limitations / 限制

- Do not resolve product names, aliases, or short links.
  不解析商品名称、别名或短链。

## Stop conditions / 停止条件

- Stop and request an exact product reference when normalization fails.
  引用规范化失败时停止并要求精确商品引用。