tiktok/ads/ad-interactive-analysis

Get ad interactive analysis

Purpose:

• Get ad interactive time analysis to understand audience retention and engagement at different video time points
• Analyze ad video attractiveness curve to find optimal duration and key interaction points
• Optimize ad content structure to improve overall effectiveness

Parameters:

• material_id: Ad material ID, required parameter
• metric_type: Analysis type
  • ctr: Click-through rate analysis
  • cvr: Conversion rate analysis
  • clicks: Click count analysis
  • conversion: Conversion count analysis
  • remain: Retention rate analysis (default)
• period_type: Time range, default 180 days

Return Description:

• interactive_data: Interactive analysis data
  • time_series: Time series data
    • time: Video playback time point (seconds)
    • value: Corresponding metric value (e.g., retention rate)
  • average_watch_time: Average watch time
  • completion_rate: Completion rate
  • peak_interaction_time: Peak interaction time point

Example Response:

{
  "code": 200,
  "router": "/api/v1/tiktok/ads/get_ad_interactive_analysis",
  "params": {
    "material_id": "7213258221116751874",
    "metric_type": "remain",
    "period_type": 180
  },
  "data": {
    "interactive_data": {
      "time_series": [
        {"time": 0, "value": 100},
        {"time": 1, "value": 95},
        {"time": 2, "value": 88}
      ],
      "average_watch_time": 8.5,
      "completion_rate": 65.2,
      "peak_interaction_time": 3
    }
  }
}

Imported from a validated TikHub OpenAPI document. Pricing must be reviewed before enabling.