Skip to main content
{
	"ad_campaign": {
		"id": "adcamp_xxxxxxxxxxx"
	},
	"ad_group": {
		"id": "adgrp_xxxxxxxxxxxx"
	},
	"click_through_rate": 6.9,
	"clicks": 42,
	"cost_per_click": 6.9,
	"cost_per_lead": 6.9,
	"cost_per_mille": 6.9,
	"cost_per_purchase": 6.9,
	"cost_per_result": 6.9,
	"created_at": "2023-12-01T05:00:00.401Z",
	"frequency": 6.9,
	"id": "ad_xxxxxxxxxxxxxxx",
	"impressions": 42,
	"issues": [
		{
			"category": "policy_rejection",
			"created_at": "2023-12-01T05:00:00.401Z",
			"resolution_status": "open",
			"resource_id": "<string>",
			"resource_type": "<string>",
			"subtype": "<string>"
		}
	],
	"leads": 42,
	"platform": "meta",
	"purchase_value": 6.9,
	"purchases": 42,
	"reach": 42,
	"return_on_ad_spend": 6.9,
	"spend": 6.9,
	"spend_currency": "usd",
	"status": "active",
	"title": "<string>",
	"unique_click_through_rate": 6.9,
	"unique_clicks": 42,
	"updated_at": "2023-12-01T05:00:00.401Z"
}
​
ad_campaign
object
required
The ad campaign this ad belongs to.
​
ad_group
object
required
The parent ad group this ad belongs to.
​
click_through_rate
number
required
Click-through rate as a fraction of impressions (clicks / impressions, 0–1).Example: 6.9
​
clicks
integer
required
Total clicks on this ad in the stats window.Example: 42
​
cost_per_click
number
required
Cost per click in dollars (spend / clicks). 0 when there are no clicks.Example: 6.9
​
cost_per_lead
number | null
required
Cost in dollars per Whop pixel-attributed lead (spend / leads). 0 when leads are tracked but none happened yet; null when leads are not a goal and none were attributed.Example: 6.9
​
cost_per_mille
number
required
Cost per 1,000 impressions in dollars (spend / impressions × 1000). 0 when there are no impressions.Example: 6.9
​
cost_per_purchase
number | null
required
Cost in dollars per Whop pixel-attributed purchase (spend / purchases). 0 when purchases are tracked but none happened yet; null when purchases are not a goal and none were attributed.Example: 6.9
​
cost_per_result
number | null
required
Cost in dollars per optimization result (spend / results). 0 when a result is being optimized for but none happened yet; null when nothing is being optimized for.Example: 6.9
​
created_at
string<date-time>
required
When the ad was created.Example: 2023-12-01T05:00:00.401Z
​
frequency
number | null
required
Average number of times each person saw an ad (impressions / reach), as reported by the platform.Example: 6.9
​
id
string
required
The unique identifier for this ad.Example: ad_xxxxxxxxxxxxxxx
​
impressions
integer
required
Total impressions (views) on this ad in the stats window.Example: 42
​
issues
array<object>
required
Open platform issues affecting this ad, deduplicated per object. Empty when there are none.
​
leads
integer
required
Number of Whop pixel-attributed leads (last-click) in the stats window.Example: 42
​
platform
AdCampaignPlatforms
required
The external ad platform this ad is running on (e.g., meta, tiktok).Available options: meta, tiktok
​
purchase_value
number
required
Total USD value of Whop pixel-attributed purchases in the stats window.Example: 6.9
​
purchases
integer
required
Number of Whop pixel-attributed purchases (last-click) in the stats window.Example: 42
​
reach
integer
required
Unique users reached in the stats window (deduplicated by the platform).Example: 42
​
return_on_ad_spend
number
required
Return on ad spend as a ratio (purchaseValue / spend) — 2.5 means 2.50ofattributedpurchasevalueper2.50 of attributed purchase value per 1 spent. 0 when there is no spend.Example: 6.9
​
spend
number
required
Amount charged in dollars in the stats window.Example: 6.9
​
spend_currency
Currencies | null
required
Currency of spend and the other monetary metric fields.Available options: usd, sgd, inr, aud, brl, cad, dkk, eur, nok, gbp, sek, chf, hkd, huf, jpy, mxn, myr, pln, czk, nzd, aed, eth, ape, cop, ron, thb, bgn, idr, dop, php, try, krw, twd, vnd, pkr, clp, uyu, ars, zar, dzd, tnd, mad, kes, kwd, jod, all, xcd, amd, bsd, bhd, bob, bam, khr, crc, xof, egp, etb, gmd, ghs, gtq, gyd, ils, jmd, mop, mga, mur, mdl, mnt, nad, ngn, mkd, omr, pyg, pen, qar, rwf, sar, rsd, lkr, tzs, ttd, uzs, rub, btc, cny, usdt, kzt, awg, whop_usd, xau
​
status
ExternalAdStatuses
required
Current delivery status of the ad.Available options: active, paused, inactive, in_review, rejected, flagged
​
title
string | null
required
The display title of the ad. Falls back to the creative set caption when unset.
​
unique_click_through_rate
number | null
required
Unique click-through rate as a fraction of impressions (unique clicks / impressions, 0–1).Example: 6.9
​
unique_clicks
integer
required
Unique clicks (deduplicated by the platform) in the stats window.Example: 42
​
updated_at
string<date-time>
required
When the ad was last updated.Example: 2023-12-01T05:00:00.401Z