TikTok Ads Get Ad Interactive Analysis
2.07 credits/call
ae_tiktok_ads_get_ad_interactive_analysis
用于分析指定广告素材在视频不同时间点的互动表现,帮助了解留存、点击或转化相关指标的时间变化。 输入: - `material_id`:必填,广告素材 ID。 - `metric_type`:可选,分析类型,可填写 `ctr`(点击率)、`cvr`(转化率)、`clicks`(点击次数)、`conversion`(转化次数)或 `remain`(留存率);默认值为 `remain`。 - `period_type`:可选,分析时间范围,单位为天;默认值为 180。 - `cookie`:可选的自定义 Cookie 字符串。 返回:成功响应中的 `data` 字段包含互动分析结果;具体结果内容取决于所选指标和时间范围。
2.07 credits/call
Pricing
2.07 credits/call
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
2.07 credits/call Charges are per query. A successful query is billed even if it returns no results.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | Yes | 广告互动时间分析请求体,使用对象字段提供广告素材 ID,并可填写分析类型、分析时间范围(天)和自定义 Cookie。 | — |
request_body.cookie | string | No | 自定义Cookie字符串(可选) | — |
request_body.material_id | string | Yes | 广告素材ID/Ad material ID | — |
request_body.metric_type | string | No | 分析类型/Analysis type (ctr, cvr, clicks, conversion, remain) | remain |
request_body.period_type | integer | No | 时间范围(天)/Period type (days) | 180 |
Invocation example
Parameter templateGenerated from the parameter configuration. Replace the sample values before use.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest coderequest.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_tiktok_ads_get_ad_interactive_analysis' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"material_id": "xxx"
}
}
}'No response example available yet.

