Campaign Performance Insights

Once a campaign is live, this is how you find out whether it worked - and it's the step that turns Drive from a one-shot send into a loop: performance here is what informs your next segment.

GET /drive-api/v1/campaigns/{campaign_id}/insights/performance/trends?metrics=campaign_audience,primary_button_unique_clicks

Pass one or more metrics (required) from: campaign_audience, customers_triggered, impressions_total, impressions_unique, impression_rate, primary_button_total_clicks, primary_button_unique_clicks, primary_button_click_efficiency, secondary_button_total_clicks, secondary_button_unique_clicks, secondary_button_click_efficiency, secondary_button_no_primary_button_unique_clicks. Optional start_date/end_date bound the window, and aggregation_type (daily, default, or cumulative) controls how the trend accumulates.

Each requested metric comes back as a headline figure plus its trend over time:

{
  "data": {
    "campaign_audience": {
      "headline": { "format": "counter", "value": 12000 },
      "trend": { "format": "trend", "value": [{ "date": "2026-07-01", "value": 12000 }] }
    },
    "primary_button_unique_clicks": {
      "headline": { "format": "counter", "value": 340 },
      "trend": { "format": "trend", "value": [{ "date": "2026-07-01", "value": 340 }] }
    }
  }
}

Seeing a metric underperform is usually the cue to go back to Understanding Segment Criteria and refine the audience, rather than the content - closing the loop back to Segments is the point.