Upbuildby Uptimal

Data reference · Snapchat Ads

Every Snapchat Ads metric and dimension you can ask for.

Upbuild reads Snapchat's Marketing API stats at campaign, ad squad and ad level. These are the real field names the snap stats tool requests: swipes and all: so answers match Ads Manager exports.

41Fields

26Metrics

8Dimensions

7Breakdowns

Source: Snapchat Marketing API, stats endpoints · Updated August 2026

41 shown

Delivery

7 fields

Spend arrives in micro-currency: the assistant divides by a million for you.

Try it in Claude, ChatGPT or Copilot Studio

Impressions, swipes and spend by campaign for the last 30 days.

Field	Type	What it is
`impressions`	Metric	Paid impressions served. “impressions by campaign this month”
`swipes`	Metric	Swipe-ups: Snapchat's click. “swipes and swipe rate by ad squad”
`spend`	Metric	Spend in micro-currency units.
`ecpm`	Metric	Effective cost per thousand impressions.
`ecpc`	Metric	Effective cost per swipe.
`frequency`	Metric	Average impressions per user.
`uniques`	Metric	Unique users reached.

Video and story

8 fields

Watch depth and story behavior.

Try it in Claude, ChatGPT or Copilot Studio

Video completion rates and story completes by creative this month.

Field	Type	What it is
`video_views`	Metric	2-second or swipe-qualified video views.
`quartile_1`	Metric	Plays reaching 25 percent.
`quartile_2`	Metric	Plays reaching 50 percent.
`quartile_3`	Metric	Plays reaching 75 percent.
`view_completion`	Metric	Plays to the end. “completion rate by creative”
`screen_time_millis`	Metric	Total screen time, in milliseconds.
`story_opens`	Metric	Story ad opens.
`story_completes`	Metric	Stories viewed to the last snap.

Engagement

2 fields

Beyond the swipe.

Try it in Claude, ChatGPT or Copilot Studio

Saves and shares by campaign, this month versus last.

Field	Type	What it is
`saves`	Metric	Saves of the content.
`shares`	Metric	Shares of the ad. “saves and shares by campaign”

Conversions

9 fields

Snap Pixel and app events, attributed on the account's windows.

Try it in Claude, ChatGPT or Copilot Studio

Purchases and purchase value by campaign, with cost per purchase, last month.

Field	Type	What it is
`conversion_purchases`	Metric	Purchase events. “purchases and value by campaign”
`conversion_purchases_value`	Metric	Purchase value.
`conversion_sign_ups`	Metric	Sign-up events.
`conversion_add_cart`	Metric	Add-to-cart events.
`conversion_page_views`	Metric	Page view events.
`conversion_start_checkout`	Metric	Checkout starts.
`conversion_view_content`	Metric	Content views.
`conversion_app_opens`	Metric	App opens from ads.
`conversion_app_installs`	Metric	App installs. “installs by campaign last month”

Entities

6 fields

The levels stats aggregate at.

Try it in Claude, ChatGPT or Copilot Studio

List ad squads with spend and swipe rate, biggest first.

Field	Type	What it is
`campaign.id`	Dimension	Campaign ID.
`campaign.name`	Dimension	Campaign name. “spend by campaign name”
`adsquad.id`	Dimension	Ad squad, Snapchat's ad set.
`adsquad.name`	Dimension	Ad squad name.
`ad.id`	Dimension	Ad ID.
`ad.name`	Dimension	Ad name.

Time and audience breakdowns

9 fields

Granularity and demographic splits.

Try it in Claude, ChatGPT or Copilot Studio

Break last month's swipes down by country, gender and age bucket.

Field	Type	What it is
`granularity:DAY`	Dimension	One row per day. “daily spend last 14 days”
`granularity:HOUR`	Dimension	One row per hour.
`dimension:country`	Breakdown	Country of delivery. “swipes by country”
`dimension:region`	Breakdown	Region or state.
`dimension:dma`	Breakdown	US DMA.
`dimension:gender`	Breakdown	male, female, unknown. “results by gender and age”
`dimension:age_bucket`	Breakdown	Age bands, 13-17 through 50+.
`dimension:os`	Breakdown	iOS or Android.
`dimension:make`	Breakdown	Device make.

Good to know

Snapchat Ads questions.

Why is spend such a huge number?

Snapchat returns money in micro-currency: millionths of the account currency. The assistant divides by 1,000,000 and shows normal figures, but exports from the raw API will look inflated until you do the same.

Is a swipe the same as a click?

Functionally yes: the swipe-up is Snapchat's click, and ecpc is cost per swipe. Cross-platform comparisons map swipes to clicks.

Which attribution windows apply?

The account defaults, typically 28-day swipe and 1-day view, applied by Snapchat at reporting time. Ask for a different window and the assistant re-queries with it where the API allows.

How granular can reporting get?

Hourly at the finest, by day for most work, at campaign, ad squad or ad level, with the demographic and geo breakdowns listed here.

Next

Snapchat Ads MCP guide → All platforms → Connect Upbuild in two minutes →