Tool name get_campaignReads one GAM campaign (order) — its details and lifetime delivery (impressions, CTR, viewability) — with optional breakdowns per cohort, per day, or per line item.
Example prompt
Break down that campaign’s delivery by cohort and by day so I can see which audiences drove impressions.
Parameters The campaign id to read (from list_campaigns).
Which breakdowns to include. Omit for the campaign’s totals only. each one of: targeted_cohorts, observed_cohorts, day, line_item.
Restrict every figure to these line items.
The workspaces the campaign runs across — pass the workspace_ids from the campaign’s list_campaigns row. min 1 item.
Returns campaign CampaignDetail object
required
The campaign’s details. Whether the campaign is currently active — its end date is in the future.
Agency associated with the order, when GAM records one. Often absent.
Order end date (ISO 8601).
Whether the campaign uses Permutive targeting.
Order start date (ISO 8601).
Per-cohort breakdown, when requested via include. This cohort’s available audience (estimated unique users, last 30 days) in each of the requested workspaces — showing where its users are collected. Estimated unique users (last 30 days) for the cohort available in this workspace; 0 = no recent activity here.
One of the requested workspace ids.
Short cohort identifier. Pass to get_cohort_detail or as a measure_audiences reference.
The cohort’s type (e.g. custom, lookalike). one of: custom, lookalike, contextual, standard, classificationModel, advertiser, curated.
This cohort’s absolute click-through rate.
This cohort’s click-through rate relative to the campaign’s overall CTR (cohort_ctr / campaign_ctr). 1.0 = the campaign average; >1 = clicks better than average, <1 = worse.
This cohort’s impressions (per the reading in targeted).
Human-readable cohort name.
This cohort’s impressions as a fraction of the campaign’s total (0..1).
Whether the campaign targets this cohort.
This cohort’s viewable-impression percentage (0..1).
Lifetime click-through rate.
The campaign’s own delivery by day (impressions/CTR/viewability), for spotting trends over its flight. Present when day is in include. The campaign’s click-through rate on this day.
The campaign’s impressions on this day.
The campaign’s viewable-impression percentage on this day (0..1).
Lifetime impressions delivered against the order (line-item-scoped when line_item_ids is set).
Comparison of the restricted impressions to the whole order. Present only when line_item_ids is set. This figure as a fraction of the whole order’s figure (0..1).
This figure divided by the order’s per-line-item average (1.0 = exactly average).
Per-line-item breakdown, when requested via include. Show LineItemBreakdownItem
This line item’s click-through rate.
Impressions delivered by this line item.
Permutive-targeted impressions delivered by this line item (capped).
This line item’s viewable-impression percentage (0..1).
The aggregate of cohorts on this campaign not listed in cohort_breakdown (not visible to you, or not resolvable in the cohort catalogue). Present with the cohort breakdown when any were dropped, so the breakdown accounts for all cohort delivery. Absent when nothing was dropped. How many cohorts are aggregated here — those beyond the top-by-impressions cap, plus any not resolvable in the catalogue (owned outside this workspace, or uncatalogued). For observed_cohorts this is often large and is not a defect.
Impression-weighted click-through rate across those cohorts.
Summed impressions of those cohorts (same reading as the individual rows: targeted or observed).
These cohorts’ combined impressions as a fraction of the campaign total (0..1).
Impression-weighted viewable-impression percentage across those cohorts (0..1).
Lifetime viewable-impression percentage (0..1).
