tiktok_top_ads_analysis
Retrieve TikTok Top Ads interactive time analysis to chart retention, CTR, CVR, clicks, conversions, or remains and compare percentile for a material.
Instructions
Retrieve TikTok Top Ads interactive time analysis. Returns the detail-page interactive time analysis chart and percentile for a Top Ads material. Metric values are retain_ctr (CTR), retain_cvr (CVR), click_cnt (Clicks), convert_cnt (Conversion), and play_retain_cnt (Remain).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"material_id": "<material_id>"
},
"name": "tiktok_top_ads_analysis"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| metric | No | Interactive time analysis metric | |
| material_id | Yes | Top Ads material id | |
| period_type | No | Percentile lookback period in days |