ChatGPT Ads logo

Advertising integration

ChatGPT Ads reporting & dashboards

Turn campaign, creative, and performance data from ChatGPT ads into 411 governed metrics for dashboards, agent answers, and cross-channel reporting.

What you can do with ChatGPT Ads in Maven

Maven models ChatGPT Ads into 411 governed metrics from the semantic layer. Track Ad-Level Add-to-Cart Value, Ad-Level Add to Carts, Ad-Level All Conversion Value, Ad-Level All Conversions and Ad-Level Clicks, break results down by Entity Level, Campaign, Ad group and Ad, and report ChatGPT Ads alongside Google Analytics 4, Shopify and Google Ads without rebuilding exports or metric logic for every report.

What you can measure

411 ChatGPT Ads metrics you can use consistently

Maven keeps ChatGPT Ads numbers consistent across dashboards, reports, and answers so the team is not debating which spreadsheet is right.

Ad-Level Add-to-Cart Value

Compatibility name for add_to_cart_value; returns the same value. No entity_level filter was ever applied.

Ad-Level Add to Carts

Compatibility name for add_to_carts; returns the same value. No entity_level filter was ever applied.

Ad-Level All Conversion Value

Compatibility name for all_conversion_value; returns the same value. No entity_level filter was ever applied.

Ad-Level All Conversions

Compatibility name for all_conversions; returns the same value. No entity_level filter was ever applied.

Ad-Level Clicks

Compatibility name for clicks; returns the same value. No entity_level filter was ever applied.

Ad-Level Comments

Compatibility name for paid_comments; returns the same value. No entity_level filter was ever applied.

Ad-Level Complete Registrations

Compatibility name for complete_registrations; returns the same value. No entity_level filter was ever applied.

Ad-Level Conversions

Compatibility name for provider_summary_conversions; returns the same value. No entity_level filter was ever applied.

Ad-Level CPA

Compatibility name for provider_summary_cpa; returns the same value. No entity_level filter was ever applied.

Show all 411 metrics

Ad-Level CPC

Compatibility name for cpc; returns the same value. No entity_level filter was ever applied.

Ad-Level CPM

Compatibility name for cpm; returns the same value. No entity_level filter was ever applied.

Ad-Level CTR

Compatibility name for ctr; returns the same value. No entity_level filter was ever applied.

Ad-Level Engagements

Compatibility name for paid_engagements; returns the same value. No entity_level filter was ever applied.

Ad-Level Impressions

Compatibility name for impressions; returns the same value. No entity_level filter was ever applied.

Ad-Level Initiate Checkouts

Compatibility name for initiate_checkouts; returns the same value. No entity_level filter was ever applied.

Ad-Level Landing Page Views

Compatibility name for landing_page_views; returns the same value. No entity_level filter was ever applied.

Ad-Level Lead Value

Compatibility name for lead_value; returns the same value. No entity_level filter was ever applied.

Ad-Level Leads

Compatibility name for leads; returns the same value. No entity_level filter was ever applied.

Ad-Level Likes

Compatibility name for paid_likes; returns the same value. No entity_level filter was ever applied.

Ad-Level Link Clicks

Compatibility name for link_clicks; returns the same value. No entity_level filter was ever applied.

Ad-Level One-Click Leads

Compatibility name for one_click_leads; returns the same value. No entity_level filter was ever applied.

Ad-Level Page Engagements

Compatibility name for page_engagements; returns the same value. No entity_level filter was ever applied.

Ad-Level Post Engagements

Compatibility name for post_engagements; returns the same value. No entity_level filter was ever applied.

Ad-Level Post Reactions

Compatibility name for post_reactions; returns the same value. No entity_level filter was ever applied.

Ad-Level Reach

Compatibility name for reach; returns the same value. No entity_level filter was ever applied.

Ad-Level Revenue

Compatibility name for revenue; returns the same value. No entity_level filter was ever applied.

Ad-Level ROAS

Compatibility name for roas; returns the same value. No entity_level filter was ever applied.

Ad-Level Shares

Compatibility name for paid_shares; returns the same value. No entity_level filter was ever applied.

Ad-Level Spend

Compatibility name for total_ad_spend; returns the same value. No entity_level filter was ever applied.

Ad-Level Spend with Commission

Compatibility name for ad_spend_with_commission; returns the same value. No entity_level filter was ever applied.

Ad-Level Units Ordered

Compatibility name for units_ordered; returns the same value. No entity_level filter was ever applied.

Ad-Level Video Views

Compatibility name for video_views; returns the same value. No entity_level filter was ever applied.

Ad Spend with Commission

Paid media spend with the workspace commission rate applied

Add-to-Cart Value

Platform-reported value for add-to-cart events where available

Add to Carts

Platform-reported add-to-cart events where available

All Conversion Value

Platform-reported value for all conversions where available

All Conversions

Platform-reported all-conversions count where available

AMC Clicks

Privacy-thresholded clicks from Amazon Marketing Cloud

AMC Conversions

Privacy-thresholded conversions from Amazon Marketing Cloud

AMC Impressions

Privacy-thresholded impressions from Amazon Marketing Cloud

AMC Purchases

Privacy-thresholded purchases from Amazon Marketing Cloud

AMC Sales

Privacy-thresholded attributed sales from Amazon Marketing Cloud

AMC Spend

Privacy-thresholded spend from Amazon Marketing Cloud

AMC Unique Users

Privacy-thresholded unique users from Amazon Marketing Cloud

Attributed Units

Attributed units reported by Walmart Connect

Clicks

Paid ad clicks reported by connected ad platforms

Complete Registrations

Platform-reported completed registration events where available

CPC

Paid media cost per click calculated from raw spend divided by clicks

CPM

Paid media cost per thousand impressions calculated from raw spend divided by impressions

CTR

Paid ad click-through rate calculated as clicks divided by impressions

Impressions

Ad impressions served by connected paid media platforms

Initiate Checkouts

Platform-reported initiated checkout events where available

Landing Page Views

Platform-reported landing page views or page-view conversion proxy where available

Lead Value

Platform-reported lead value where available

Leads

Platform-reported lead events where available. For LinkedIn this is Lead Gen Form (one-click) leads, which LinkedIn does not count in conversions.

Link Clicks

Platform-reported link clicks where available

LinkedIn Ads Clicks

LinkedIn chargeable clicks

LinkedIn Ad Comments

Comments on sponsored content

LinkedIn Conversion Value

Advertiser-defined conversion value in account currency

LinkedIn Ads Conversions

Total attributed external website conversions

LinkedIn Cost per Lead

Account-currency spend per one-click lead

LinkedIn Ads CPC

Account-currency spend per chargeable click

LinkedIn Ads CPM

Account-currency spend per thousand impressions

LinkedIn Ads CTR

Chargeable clicks divided by impressions

LinkedIn Document Completions

Document ads reaching 100 percent

LinkedIn Ads Engagements

Total interactions with LinkedIn ad units

LinkedIn Ad Follows

Follows attributed to sponsored content or follower ads

LinkedIn Ads Impressions

LinkedIn sponsored-creative impressions

LinkedIn Job Applications

Completed job applications attributed to ads

LinkedIn Job Apply Clicks

Clicks to start a job application

LinkedIn Landing Page Clicks

Clicks to the creative landing page

LinkedIn Lead Form Completion Rate

One-click leads divided by Lead Gen Form opens

LinkedIn Lead Form Opens

One-click Lead Gen Form opens

LinkedIn Leads

One-click leads generated

LinkedIn Ad Likes

Likes on sponsored content

LinkedIn Message Contact Info Shares

Sponsored Messaging contact-info shares

LinkedIn Message Interested Clicks

Sponsored Messaging interested clicks

LinkedIn Message Ad Opens

Sponsored Messaging opens

LinkedIn Message Ad Sends

Sponsored Messaging sends

LinkedIn Post-Click Conversions

Conversions attributed after a click

LinkedIn Post-Click Registrations

Registrations attributed after a click

LinkedIn Post-View Conversions

Conversions attributed after an impression (view-through); included in LinkedIn conversions

LinkedIn Post-View Registrations

Registrations attributed after an impression

LinkedIn Qualified Leads

Leads marked qualified by the advertiser

LinkedIn Ad Reactions

Positive reactions on sponsored content

LinkedIn Registrations

Event or seminar registrations attributed to ads

LinkedIn Ad Shares

Shares of sponsored content

LinkedIn Ads Spend

Spend in the LinkedIn ad account currency

LinkedIn Ads Spend (USD)

LinkedIn provider-converted USD spend

LinkedIn Video Completion Rate

Video completions divided by video starts

LinkedIn Video Completions

Video plays reaching 97–100 percent

LinkedIn Video 25% Completions

Video plays reaching the first quartile

LinkedIn Video 50% Completions

Video plays reaching the midpoint

LinkedIn Video Starts

Sponsored video starts

LinkedIn Video 75% Completions

Video plays reaching the third quartile

LinkedIn Video Views

Qualified sponsored video views

Media Budget Amount

One-Click Leads

LinkedIn one-click lead events where available

Page Engagements

Paid social page engagements where available

Paid Comments

Paid social comments where available

Paid Engagements

Platform-reported paid engagement actions where available

Paid Likes

Paid social likes where available

Paid Shares

Paid social shares where available

Pinterest Checkout Value

Pinterest-attributed checkout value in the provider ad-account currency.

Pinterest Checkouts

Checkout conversions attributed to Pinterest ads.

Pinterest Ads Clicks

Total Pinterest Pin clickthroughs including earned activity.

Pinterest Ads Conversions

Total Pinterest-attributed conversions using the retained attribution windows.

Pinterest Ads CPA

Account-currency Pinterest spend per attributed conversion.

Pinterest Ads CPC

Account-currency Pinterest spend per total clickthrough.

Pinterest Ads CPM

Account-currency Pinterest spend per thousand impressions.

Pinterest Ads CTR

Pinterest total clickthroughs divided by total impressions.

Pinterest Engagement Rate

Pinterest engagements divided by total impressions.

Pinterest Ads Engagements

Total engagements with Pinterest ads.

Pinterest Ads Impressions

Total paid and earned Pinterest ad impressions.

Pinterest Leads

Lead conversions attributed to Pinterest ads.

Pinterest Native Leads

Pinterest native lead-form submissions.

Pinterest Outbound Clicks

First-order clicks from Pinterest ads to an advertiser destination.

Pinterest Outbound CTR

Pinterest outbound clicks divided by total impressions.

Pinterest Page Visits

Page-visit conversions attributed to Pinterest ads.

Pinterest Paid Impressions

First-order paid Pinterest ad impressions.

Pinterest Ads Daily Reach

Provider-reported unique users reached; non-additive across dates and entities.

Pinterest Ads ROAS

Pinterest-attributed checkout value divided by spend.

Pinterest Ad Saves

First-order saves of Pinterest ads.

Pinterest Signups

Signup conversions attributed to Pinterest ads.

Pinterest Ads Spend

Pinterest spend in the provider ad-account currency.

Pinterest 15-Second Unique Video Views

Unique Pinterest video viewers reaching fifteen seconds.

Pinterest Video 25% Views

Pinterest video plays reaching 25 percent.

Pinterest 3-Second Video Views

Pinterest video views lasting at least three seconds.

Pinterest Video 50% Views

Pinterest video plays reaching 50 percent.

Pinterest Video 75% Views

Pinterest video plays reaching 75 percent.

Pinterest Video 95% Views

Pinterest video plays reaching 95 percent.

Pinterest Video Completion Rate

Pinterest video completions divided by video starts represented by 3-second views.

Pinterest Video Completions

Pinterest video plays reaching 100 percent.

Pinterest MRC Video Views

Pinterest video views meeting MRC viewability criteria.

Pinterest Web Sessions

Web sessions attributed to Pinterest ads.

Post Engagements

Paid social post engagements where available

Post Reactions

Paid social post reactions where available

Provider Summary Conversion Value

Compatibility conversion value from the provider ad-performance summary. For Facebook this is the primary named-conversion set's conversion value (conversions source at 7-day click plus 1-day view, platform_default fallback), not purchase value; purchase value remains available in obt_paid_media_conversion_actions filtered on event_name. Do not use for canonical paid-media conversion-value questions.

Provider Summary Conversions

Compatibility total from the provider ad-performance summary. For Facebook this is Meta Results for the ad set's optimization event (only the conversion event each ad set optimizes for, under that ad set's attribution setting; 0 for reach, traffic and engagement goals; the primary named-conversion set when the ad set's target cannot be resolved), matching Ads Manager's Results column. obt_paid_media_conversion_actions rows with is_results_event = true reconcile to it; every other event stays available there by event_name. For LinkedIn this is external website conversions (post-click plus post-view) and excludes Lead Gen Form leads, which are reported in leads.

Provider Summary CPA

Compatibility provider-summary spend divided by provider-summary conversions. Canonical action-based CPA is calculated from total_ad_spend and conversions at a shared grain.

Reach

Platform-reported paid reach where available; daily reach is not deduped across wider periods

Reddit Click-Attributed Add to Carts

Reddit add-to-cart events attributed to ad clicks.

Reddit Add-to-Cart Items

Items contained in Reddit-attributed add-to-cart events.

Reddit Add-to-Cart Value

Reddit-attributed add-to-cart value in provider account currency.

Reddit View-Attributed Add to Carts

Reddit add-to-cart events attributed to ad views.

Reddit Add to Carts

Click- and view-attributed add-to-cart events.

Reddit Ads Clicks

Total clicks reported for Reddit ads.

Reddit Click-Attributed Content Views

Reddit content views attributed to ad clicks.

Reddit View-Attributed Content Views

Reddit content views attributed to ad views.

Reddit Content Views

Click- and view-attributed content-view events.

Reddit Ads CPA

Account-currency Reddit spend per key conversion.

Reddit Ads CPC

Account-currency Reddit spend per click.

Reddit Ads CPM

Account-currency Reddit spend per thousand impressions.

Reddit Ads CTR

Reddit clicks divided by impressions.

Reddit Engaged Clicks

Reddit clicks that met the provider engaged-click definition.

Reddit Fully Viewable Video Impressions

Reddit video impressions that were fully viewable.

Reddit Ads Impressions

Total Reddit ad impressions.

Reddit Click-Attributed Key Conversions

Reddit key conversions attributed to ad clicks.

Reddit View-Attributed Key Conversions

Reddit key conversions attributed to ad views.

Reddit Key Conversions

Provider key-conversion total selected as the canonical Reddit conversion metric.

Reddit Click-Attributed Leads

Reddit lead events attributed to ad clicks.

Reddit Lead Value

Reddit-attributed lead value in provider account currency.

Reddit View-Attributed Leads

Reddit lead events attributed to ad views.

Reddit Attributed Leads

Click- and view-attributed lead events.

Reddit Native Leads

Native Reddit lead-form submissions.

Reddit Click-Attributed Page Visits

Reddit page visits attributed to ad clicks.

Reddit View-Attributed Page Visits

Reddit page visits attributed to ad views.

Reddit Page Visits

Click- and view-attributed page-visit events.

Reddit Click-Attributed Purchases

Reddit purchases attributed to ad clicks.

Reddit Purchase Items

Items contained in Reddit-attributed purchases.

Reddit Purchase Value

Reddit-attributed purchase value in provider account currency.

Reddit View-Attributed Purchases

Reddit purchases attributed to ad views.

Reddit Purchases

Click- and view-attributed Reddit purchase events.

Reddit Ads Daily Reach

Provider-reported daily unique users reached; non-additive across dates and entities.

Reddit Ads ROAS

Reddit-attributed purchase value divided by spend.

Reddit Click-Attributed Signups

Reddit signup events attributed to ad clicks.

Reddit Signup Value

Reddit-attributed signup value in provider account currency.

Reddit View-Attributed Signups

Reddit signup events attributed to ad views.

Reddit Signups

Click- and view-attributed signup events.

Reddit Ads Spend

Reddit ad spend in the provider account currency.

Reddit 10-Second Video Views

Reddit video plays reaching ten seconds.

Reddit Video 25% Views

Reddit video plays reaching 25 percent.

Reddit 3-Second Video Views

Reddit video plays reaching three seconds.

Reddit Video 50% Views

Reddit video plays reaching 50 percent.

Reddit 5-Second Video Views

Reddit video plays reaching five seconds.

Reddit Video 75% Views

Reddit video plays reaching 75 percent.

Reddit Video 95% Views

Reddit video plays reaching 95 percent.

Reddit Video Completion Rate

Reddit video completions divided by video starts.

Reddit Video Completions

Reddit video plays reaching 100 percent.

Reddit Expanded Video Plays

Reddit video plays opened in the expanded player.

Reddit Video Plays with Sound

Reddit video plays where sound was enabled.

Reddit Video Starts

Reddit ad video starts.

Reddit Viewable 15-Second Video Views

Reddit video plays meeting the provider fifteen-second viewability threshold.

Reddit Viewable 6-Second Video Views

Reddit video plays meeting the provider six-second viewability threshold.

Reddit Viewable Video Impressions

Reddit video impressions meeting provider viewability criteria.

Ad Revenue

Revenue attributed by the ad platform at the base ad performance grain. For Facebook this is the primary named-conversion set's conversion value (conversions source at 7-day click plus 1-day view, platform_default fallback), not purchase value; purchase value remains available in obt_paid_media_conversion_actions filtered on event_name.

ROAS

Platform-attributed return on ad spend calculated from ad revenue divided by raw spend. For Facebook the numerator is the primary named-conversion set's conversion value, not purchase value (see revenue).

Snapchat Add-to-Cart Value

Snapchat-attributed add-to-cart value in account currency.

Snapchat Add to Carts

Add-to-cart events attributed to Snapchat ads.

Snapchat Android Installs

Android app installs attributed to Snapchat ads.

Snapchat Average Screen Time

Total screen time divided by paid impressions at query time.

Snapchat Swipes

Snapchat swipe-up actions represented as canonical paid-media clicks.

Snapchat Content-View Value

Snapchat-attributed content-view value in account currency.

Snapchat Content Views

Content-view events attributed to Snapchat ads.

Snapchat Purchase CPA

Account-currency Snapchat spend per attributed purchase.

Snapchat Ads CPC

Account-currency Snapchat spend per swipe.

Snapchat Ads CPM

Account-currency Snapchat spend per thousand paid impressions.

Snapchat Ads CTR

Snapchat swipes divided by paid impressions.

Snapchat Earned Impressions

Earned impressions generated by Snapchat ads.

Snapchat Frequency

Paid impressions divided by provider-deduplicated daily reach at query time.

Snapchat Ads Impressions

Paid Snapchat ad impressions at the canonical ad-day grain.

Snapchat iOS Installs

iOS app installs attributed to Snapchat ads.

Snapchat Landing Page Views

Landing-page views attributed to Snapchat ads.

Snapchat Native Leads

Native Snapchat lead-form submissions.

Snapchat Page-View Value

Snapchat-attributed page-view value in account currency.

Snapchat Page Views

Page-view events attributed to Snapchat ads.

Snapchat Paid Impressions

First-order paid Snapchat impressions.

Snapchat Profile Clicks

Clicks from ads to a Snapchat Public Profile.

Snapchat Purchase Value

Snapchat-attributed purchase value in provider account currency.

Snapchat Purchases

Purchases attributed by Snapchat under the retained swipe and view windows.

Snapchat Daily Reach

Provider-deduplicated daily unique reach; non-additive across dates and entities.

Snapchat Purchase ROAS

Snapchat-attributed purchase value divided by spend.

Snapchat Saves

Saves generated by Snapchat ads.

Snapchat Screen Time

Total time Snapchat ads were on screen in milliseconds.

Snapchat Shares

Shares of Snapchat ads.

Snapchat Signup Value

Snapchat-attributed signup value in account currency.

Snapchat Signups

Signup events attributed to Snapchat ads.

Snapchat Ads Spend

Snapchat spend in the provider ad-account currency.

Snapchat Checkout-Start Value

Snapchat-attributed checkout-start value in account currency.

Snapchat Checkout Starts

Checkout-start events attributed to Snapchat ads.

Snapchat Subscription Value

Snapchat-attributed subscription value in account currency.

Snapchat Subscriptions

Subscription events attributed to Snapchat ads.

Snapchat Total Impressions

Paid plus earned Snapchat impressions.

Snapchat Total Installs

Total app installs attributed to Snapchat ads.

Snapchat Trial Value

Snapchat-attributed trial value in account currency.

Snapchat Trial Starts

Trial-start events attributed to Snapchat ads.

Snapchat 15-Second Video Views

Snapchat video views lasting at least fifteen seconds.

Snapchat Video 25% Views

Snapchat video plays reaching 25 percent.

Snapchat Video 50% Views

Snapchat video plays reaching 50 percent.

Snapchat 5-Second Video Views

Snapchat video views lasting at least five seconds.

Snapchat Video 75% Views

Snapchat video plays reaching 75 percent.

Snapchat Video Completion Rate

Snapchat video completions divided by qualified video views.

Snapchat Video Completions

Snapchat video plays reaching 100 percent.

Snapchat Time-Based Video Views

Snapchat time-based video views.

Snapchat Video Views

Snapchat two-second qualified video views.

TikTok Ads Clicks

TikTok paid ad clicks.

TikTok Ad Comments

Comments on TikTok ads.

TikTok Ads Conversions

TikTok attributed conversions using the account attribution settings.

TikTok Ads CPA

Account-currency TikTok spend per attributed conversion.

TikTok Ads CPC

Account-currency TikTok spend per click.

TikTok Ads CPM

Account-currency TikTok spend per thousand impressions.

TikTok Ads CTR

TikTok clicks divided by impressions.

TikTok Follows

Follows attributed to TikTok ads.

TikTok Ads Impressions

TikTok paid ad impressions.

TikTok Ad Likes

Likes on TikTok ads.

TikTok Profile Visits

Profile visits attributed to TikTok ads.

TikTok Ads Daily Reach

Daily TikTok reach; non-additive across dates and entities.

TikTok Real-Time Conversions

TikTok real-time attributed conversions.

TikTok Real-Time Results

TikTok real-time objective-specific result count.

TikTok Ads Results

TikTok objective-specific result count; interpretation depends on campaign objective.

TikTok Ads Revenue

TikTok attributed purchase value in account currency.

TikTok Ads ROAS

TikTok attributed purchase value divided by spend.

TikTok Ad Shares

Shares of TikTok ads.

TikTok Ads Spend

TikTok spend in the provider account currency.

TikTok Video Completions

TikTok video plays reaching 100 percent.

TikTok Video 25% Views

TikTok video plays reaching 25 percent.

TikTok 2-Second Video Views

TikTok video views lasting at least two seconds.

TikTok Video 50% Views

TikTok video plays reaching 50 percent.

TikTok 6-Second Video Views

TikTok video views lasting at least six seconds.

TikTok Video 75% Views

TikTok video plays reaching 75 percent.

TikTok Video Plays

TikTok video play actions.

Total Ad Spend

Media spend reported by ad platforms before Maven commission adjustments

Units Ordered

Ordered units from commerce-oriented ad platforms where available

Video Views

Paid video views where available

Walmart Connect Attributed Orders

Attributed orders reported by Walmart Connect

Walmart Connect Attributed Sales

Attributed sales reported by Walmart Connect

Walmart Connect Clicks

Campaign clicks reported by Walmart Connect

Walmart Connect Impressions

Campaign impressions reported by Walmart Connect

Walmart Connect Spend

Campaign spend reported by Walmart Connect

Add-to-Cart Items

Items contained in ad-attributed add-to-cart events. Reported by Reddit only.

Advertiser Qualified Leads

Ad leads the advertiser marked as qualified in the ad platform. Reported by LinkedIn only; distinct from CRM qualified_leads.

Android App Installs

Android app installs attributed to ads. Reported by Snapchat only.

App Installs

Total app installs attributed to ads. Reported by Snapchat only.

Attributed Web Sessions

Web sessions attributed to ads by the ad platform (not site analytics web_sessions). Reported by Pinterest only.

Click-Through Add to Carts

Click-through share of add_to_carts. Reported by Reddit only.

Click-Through Complete Registrations

Click-through share of signups / complete registrations. Contributing platforms: Reddit click-attributed signups and LinkedIn post-click registrations.

Click-Through Content Views

Click-through share of content_views. Reported by Reddit only.

Click-Through Conversions

Click-through share of each platform's headline conversions. Contributing platforms: Reddit click-attributed key conversions and LinkedIn post-click conversions.

Click-Through Lead Conversions

Click-through share of lead_conversions (pixel Lead events). Reported by Reddit only.

Click-Through Page Visit Conversions

Click-through share of page_visit_conversions. Reported by Reddit only.

Click-Through Purchase Conversions

Click-through share of purchase_conversions. Reported by Reddit only.

Complete Registration Value

Signup (complete registration) value attributed to ads in provider account currency. Contributing platforms: Reddit and Snapchat.

Content View Value

Content-view value attributed to ads in account currency. Reported by Snapchat only.

Content Views

Pixel ViewContent conversion events attributed to ads. Contributing platforms: Reddit (click- plus view-attributed) and Snapchat.

Document Completions

Document ads read to 100 percent. Reported by LinkedIn only.

Earned Impressions

Earned impressions generated by ads (shares and other organic re-exposure). Reported by Snapchat only.

Engaged Clicks

Clicks that met Reddit's engaged-click definition. Reported by Reddit only.

Expanded Video Plays

Video plays opened in the expanded player. Reported by Reddit only.

Follows

Follows attributed to ads. Contributing platforms: LinkedIn (sponsored content and follower ads) and TikTok.

Fully Viewable Video Impressions

Video impressions that were fully viewable. Reported by Reddit only.

Initiate Checkout Value

Checkout-start value attributed to ads in account currency; pairs with initiate_checkouts. Reported by Snapchat only.

iOS App Installs

iOS app installs attributed to ads. Reported by Snapchat only.

Job Applications

Completed job applications attributed to ads. Reported by LinkedIn only.

Job Apply Clicks

Clicks to start a job application. Reported by LinkedIn only.

Lead Conversions

Pixel Lead conversion events attributed to ads. Contributing platforms: Reddit (click- plus view-attributed) and Pinterest. Distinct from leads, which counts native lead-form submissions.

Lead Form Opens

One-click Lead Gen Form opens. Reported by LinkedIn only.

MRC Video Views

Video views meeting MRC viewability criteria. Reported by Pinterest only.

Objective Results

Objective-specific result count; interpretation depends on the campaign objective, so group by objective. Reported by TikTok only.

Page Visit Conversion Value

Page-view conversion value attributed to ads in account currency; pairs with page_visit_conversions. Reported by Snapchat only.

Page Visit Conversions

Pixel page-visit (PAGE_VIEW) conversion events attributed to ads. Contributing platforms: Reddit (click- plus view-attributed page visits), Pinterest page visits and Snapchat page views. Kept separate from landing_page_views, which counts landing-page loads or clicks.

Paid and Earned Impressions

Paid plus earned impressions. Contributing platforms: Snapchat total impressions and Pinterest impressions (which Pinterest reports as paid plus earned).

Paid Impressions

First-order paid impressions, excluding earned impressions. Contributing platforms: Pinterest and Snapchat. Generic impressions are paid plus earned on Pinterest and the provider impressions field on Snapchat.

Profile Visits

Visits from ads to the advertiser's profile page. Contributing platforms: TikTok profile visits and Snapchat profile clicks (Snapchat counts clicks to the Public Profile), plus LinkedIn company-page clicks at creative/day grain; unreported values remain NULL.

Provider-Converted Spend (USD)

Spend converted to USD by the provider's own FX, not Maven currency normalisation. Reported by LinkedIn only.

Purchase Conversion Value

Purchase value attributed to ads in provider account currency. Contributing platforms: Reddit purchase value, Pinterest checkout value and Snapchat purchase value (the generic revenue column on Pinterest and Snapchat rows).

Purchase Conversions

Purchase conversion events attributed to ads. Contributing platforms: Reddit purchases (click- plus view-attributed), Pinterest checkouts (Pinterest's completed-purchase event) and Snapchat conversions (Snapchat purchases).

Real-Time Conversions

Conversions under real-time attribution (differs from the standard conversions count). Reported by TikTok only.

Real-Time Objective Results

Real-time objective-specific result count. Reported by TikTok only.

Saves

Ads saved by users. Contributing platforms: Pinterest (first-order saves) and Snapchat.

Screen Time

Total time ads were on screen in milliseconds. Reported by Snapchat only.

Sponsored Message Contact Info Shares

Sponsored Messaging contact-info shares. Reported by LinkedIn only.

Sponsored Message Interested Clicks

Sponsored Messaging interested clicks. Reported by LinkedIn only.

Sponsored Message Opens

Sponsored Messaging opens. Reported by LinkedIn only.

Sponsored Message Sends

Sponsored Messaging sends. Reported by LinkedIn only.

Subscription Conversion Value

Subscription conversion value attributed to ads in account currency. Reported by Snapchat only.

Subscription Conversions

Subscription conversion events attributed to ads. Reported by Snapchat only.

Time-Based Video Views

Time-based video views. Reported by Snapchat only.

Trial Start Value

Trial-start value attributed to ads in account currency. Reported by Snapchat only.

Trial Starts

Trial-start events attributed to ads. Reported by Snapchat only.

Unique 15-Second Video Viewers

Unique viewers reaching fifteen seconds of video; non-additive across dates and entities. Reported by Pinterest only.

10-Second Video Views

Video plays reaching ten seconds. Reported by Reddit only.

15-Second Video Views

Video views lasting at least fifteen seconds. Reported by Snapchat only; distinct from unique_video_15_second_viewers (Pinterest) and viewable_video_15_second_views (Reddit).

Video 25% Views

Paid video plays reaching 25 percent of the video length. Contributing platforms: Reddit, Pinterest, Snapchat, TikTok and LinkedIn (LinkedIn first-quartile completions).

2-Second Video Views

Paid video views lasting at least two seconds. Reported by TikTok only for now; Snapchat two-second qualified views (which also count swipe-ups) stay in snapchat_ads_video_views until that definition is signed off.

3-Second Video Views

Paid video views lasting at least three seconds. Contributing platforms: Reddit (also the generic video_views on Reddit rows) and Pinterest.

Video 50% Views

Paid video plays reaching 50 percent of the video length. Contributing platforms: Reddit, Pinterest, Snapchat, TikTok and LinkedIn (LinkedIn midpoint completions).

5-Second Video Views

Paid video views lasting at least five seconds. Contributing platforms: Reddit and Snapchat.

6-Second Video Views

Video views lasting at least six seconds (no viewability gate; distinct from viewable_video_6_second_views). Reported by TikTok only.

Video 75% Views

Paid video plays reaching 75 percent of the video length. Contributing platforms: Reddit, Pinterest, Snapchat, TikTok and LinkedIn (LinkedIn third-quartile completions).

Video 95% Views

Paid video plays reaching 95 percent of the video length. Contributing platforms: Reddit and Pinterest.

Video Completions

Paid video plays reaching 100 percent of the video length. Contributing platforms: Reddit, Pinterest, Snapchat and TikTok (100% views). LinkedIn completions (97-100 percent of length) are not included yet; use linkedin_ads_video_completions.

Video Plays with Sound

Video plays where sound was enabled. Reported by Reddit only.

Video Starts

Paid video playback starts. Contributing platforms: Reddit (video starts), LinkedIn (video starts) and TikTok (video play actions, which is also what video_views returns on TikTok rows). Other platforms report no starts column; group or filter by platform to compare.

View-Through Add to Carts

View-through share of add_to_carts. Reported by Reddit only.

View-Through Complete Registrations

View-through share of signups / complete registrations. Contributing platforms: Reddit view-attributed signups and LinkedIn post-view registrations.

View-Through Content Views

View-through share of content_views. Reported by Reddit only.

View-Through Conversions

View-through share of each platform's headline conversions. Contributing platforms: Reddit view-attributed key conversions and LinkedIn post-view conversions (included in LinkedIn conversions).

View-Through Lead Conversions

View-through share of lead_conversions (pixel Lead events). Reported by Reddit only.

View-Through Page Visit Conversions

View-through share of page_visit_conversions. Reported by Reddit only.

View-Through Purchase Conversions

View-through share of purchase_conversions. Reported by Reddit only.

Viewable 15-Second Video Views

Video plays meeting the provider fifteen-second viewability threshold. Reported by Reddit only.

Viewable 6-Second Video Views

Video plays meeting the provider six-second viewability threshold. Reported by Reddit only; distinct from video_6_second_views (TikTok, no viewability gate).

Viewable Video Impressions

Video impressions meeting provider viewability criteria. Reported by Reddit only.

Video Completion Rate

Video completions divided by video starts, with both sides limited to platforms that report a starts column: Reddit and TikTok. LinkedIn is excluded until its 97-100 percent completion threshold is signed off; Pinterest and Snapchat completion rates use different denominators (3-second and 2-second views) and stay separate.

Creative Clicks

Clicks reported for the selected native asset or ad-container creative row

Creative Conversions

Conversions for the selected creative row. Ad-container rows sum the is_results_event rows of obt_paid_media_conversion_actions at ad-day grain (Meta Results for Facebook, the primary set elsewhere); native asset rows report the provider's per-asset conversions and are not additive across sibling assets.

Creative Cost per Video View

Cost per reported video view for creative-performance rows

Creative CPA

Cost per conversion for creative-performance rows

Creative CPC

Cost per click for creative-performance rows

Creative CPM

Cost per thousand impressions for creative-performance rows

Creative CTR

Click-through rate for creative-performance rows

Creative Impressions

Impressions reported for the selected native asset or ad-container creative row

Creative Revenue

Revenue or conversion value for the selected creative row. Ad-container rows sum the conversion value of the primary conversion set from obt_paid_media_conversion_actions at ad-day grain (not provider purchase revenue); native asset rows report the provider's per-asset revenue and are not additive across sibling assets.

Creative ROAS

Return on ad spend for creative-performance rows

Creative Spend

Spend reported for the selected native asset or ad-container creative row

Creative Video Views

Video views reported for the selected native asset or ad-container creative row

Expected MTD Spend

Linear-pace expected month-to-date spend as of the latest day in range

Monthly Budget

Configured campaign monthly budget level as of the latest day in range

MTD Spend

Daily spend on the pacing fact; sums to month-to-date over a month-to-date window

Budget Pacing Ratio

Month-to-date spend as a fraction of monthly budget as of the latest day in range

Projected Monthly Spend

Projected month-end spend at current pace as of the latest day in range

Daily Budget

Daily Budget Variance

Lifetime Budget

Mtd Conversions

Mtd Revenue

Mtd Spend Actual

Mtd Spend With Commission

Spend With Commission

Attributed Closed CRM Deals

Closed CRM deals with deterministic campaign attribution matched to paid delivery

Attributed CRM Deals

CRM deals with deterministic campaign attribution matched to paid delivery

Attributed Won CRM Deals

Won CRM deals with deterministic campaign attribution matched to paid delivery

Paid CRM Clicks

Paid-media clicks represented in the paid-to-CRM surface

Paid CRM Cost per Deal

Paid spend divided by attributed CRM deals

Paid CRM Cost per Won Deal

Paid spend divided by attributed won CRM deals

Deterministically Matched CRM Deals

Attributed deals backed by a deterministic identity match

Paid CRM Impressions

Paid-media impressions represented in the paid-to-CRM surface

Paid CRM Spend

Paid-media spend on campaign-day rows with CRM attribution coverage; group or filter by spend_currency

Attributed Closed Deals

Closed CRM deals with deterministic campaign attribution matched to paid delivery

Attributed Deals

CRM deals with deterministic campaign attribution matched to paid delivery

Attributed Won Deals

Won CRM deals with deterministic campaign attribution matched to paid delivery

Deterministically Matched Deals

Attributed deals backed by a deterministic identity match

GA4 Site Conversions by Geo

GA4 key events (site conversions) by geography and channel; GA4 rows only, never added to platform conversions

GA4 Key Event Days Covered

GA4 day-rows whose key events were fully reported; compare with geo_channel_ga4_days_expected

GA4 Key Event Days Expected

GA4 day-rows expected for key-event coverage

GA4 Revenue by Geo

GA4 revenue by geography and channel

GA4 Sessions by Geo

GA4 sessions by geography and channel

Platform Clicks by Geo

Ad platform clicks by geography and channel

Platform Conversions by Geo

Platform-reported conversions (each platform's own attribution) by geography and channel; NULL where the platform does not report them, never added to GA4 conversions

Platform Impressions by Geo

Ad platform impressions by geography and channel

Platform Conversion Value by Geo

Platform-reported conversion value by geography and channel; NULL where not reported

Platform Spend by Geo

Ad platform spend by geography and channel, including spend a geo level does not account for (__not_reported__ rows)

Platform Spend with Reported Conversions

Ad platform spend on rows whose conversions the platform reports at that geo level; the CPA numerator

GA4 Conversion Rate by Geo

GA4 site conversions divided by GA4 sessions

GA4 Conversion Share of Total

Each grouped row's share of all GA4 site conversions in the result

GA4 Conversion Share within Geo

Each grouped row's share of GA4 site conversions within its geography

Platform Conversion Share of Total

Each grouped row's share of all platform conversions in the result (for example a state's share of the total)

Platform Conversion Share within Geo

Each grouped row's share of platform conversions within its geography (for example a channel's share of a state)

Platform CPA by Geo

Spend with reported conversions divided by platform-reported conversions

Conversion Value

Provider-attributed value from named primary paid-media conversion actions.

Conversions

Provider-attributed paid-media conversions at named conversion-action grain. The semantic default selects primary conversion rows to prevent attribution-window and event-source duplication; filter event_name when the user requests a conversion subset. For Facebook, the default total sums all named conversion rows from the conversions source at 7-day click plus 1-day view; filter is_results_event = true for Meta Results (each ad set's optimization event), which is what obt_ad_performance conversions report. For LinkedIn, rows are website conversion rules counted under each rule's own click and view windows, so they include post-view (view-through) conversions; Lead Gen Form leads are not conversions (use leads).

Questions you can ask

Just ask Maven about ChatGPT Ads

Maven’s agent answers in plain language with the right metric definitions applied automatically. These are real, verified questions it can run today.

How much did we spend on ads by platform over the last 30 days?

What are the top campaigns by spend?

Show commission-adjusted ad spend by platform

Show top creatives by ROAS with previews

Show creative preview coverage by platform

What conversion events did we record last week by platform?

Show rolled-up conversion events by creative

Connection and sync

What Maven pulls from ChatGPT Ads

You connect ChatGPT Ads with API credentials from the ChatGPT Ads account. Maven stores them encrypted. The first ChatGPT Ads sync pulls the most recent 30 days so the workspace fills quickly. A follow-up backfill then adds older history, up to 2 years in total. After that, each scheduled sync re-reads the last 7 days, so late changes are picked up.

Ad account

Single-row account metadata snapshot.

Fields: account name, URL, preview URL, timezone, currency code

Campaigns

Campaign entity table — snapshot of all campaigns.

Fields: campaign name, description, status, start time, end time, lifetime spend limit micros, lifetime spend limit, targeting countries, targeting excluded countries, created at, and 1 more

Ad groups

Ad group entity table — snapshot of all ad groups.

Fields: ad group name, description, status, context hints, billing event type, max bid micros, max bid, created at, updated at

Ads

Ad entity + creative metadata — snapshot of all ads.

Fields: ad name, status, review status, creative type, creative title, creative body, creative target URL, creative image URL, created at, updated at

Ad insights

Ad-grain daily insights.

Fields: ad name, ad group name, campaign name, impressions, clicks, spend, CTR, CPC, CPM, start time, and 2 more

Ad group insights

Ad-group-grain daily insights.

Fields: ad group name, campaign name, impressions, clicks, spend, CTR, CPC, CPM, start time, end time, and 1 more

Campaign insights

Campaign-grain daily insights.

Fields: campaign name, impressions, clicks, spend, CTR, CPC, CPM, start time, end time, timezone

Conversion pixels

Conversion pixel catalog for the ad account (id, name, client type). Daily snapshot, upserted on the natural key + snapshot_date so history accrues day over day (no historical backfill is possible -- the API only exposes current pixel state).

Fields: pixel name, client type, snapshot date

Conversion event settings

Per-account conversion event/goal configuration (attribution windows, associated campaigns/sources, archived flag). Config only -- not volume or event-level data. Discovered live 2026-09-24 via GET /v1/conversions/event_settings (sparsely documented by OpenAI at the time of writing), so the full raw record is also kept in raw_json in case future fields are not yet modeled here. Daily snapshot, upserted on the natural key + snapshot_date.

Fields: name, event type, custom event name, archived, is shopify managed, attribution window days, view through attribution window days, version, source IDs json, sources json, and 2 more

Conversion event samples daily

Aggregated per-sync health sample of chatgpt_ads conversion events. NOT for attribution or reporting: GET /v1/conversions/events?pid= returns at most ~50 recent events from roughly the last 15 minutes (OpenAI's own docs say so), so this table is a liveness/server-split/ latency signal only. Never contains event_data_json or any other per-event payload -- only in-memory-aggregated counts and latency percentiles per (pixel, action_source, api_channel, event_type, day). Cumulative-safety note: this table is written with a plain upsert (MERGE-replace on the natural key); this connector does not read the prior row back before writing, so every column is a LAST-SAMPLE value from the single most recent sync's observation window, not a cumulative daily total. syncs_sampled is therefore always 1 -- this is the simplest correct option given the upsert semantics above, and is intentional rather than a bug.

Fields: sample date, action source, API channel, event type, sample event count, last event timestamp, last received at, p50 latency seconds, p95 latency seconds, syncs sampled

Account insights

Account-grain daily insights.

Fields: impressions, clicks, spend, CTR, CPC, CPM, start time, end time, timezone

How it works

Connect ChatGPT Ads to a client’s workspace

No SQL or warehouse setup. Connect the source, then build the client’s report by asking Claude or ChatGPT.

Step 1

Connect ChatGPT Ads

In the client’s workspace, open Sources, add ChatGPT Ads and choose the account to sync. If you don’t have access to the account, send the client a connect link where the platform supports one.

Step 2

Maven syncs and models the data

Maven pulls the client’s ChatGPT Ads data (5 objects) and models it into documented tables. No SQL, warehouse or pipeline setup.

Step 3

Report, ask and automate

Build the client’s report or deck by asking Claude or ChatGPT through the MCP, set alerts on what matters, and publish to the client’s portal once you approve it.

Works well with

Report ChatGPT Ads alongside the rest of your stack

FAQ

ChatGPT Ads reporting questions

What ChatGPT Ads metrics can I report on in Maven?

Maven exposes 411 governed ChatGPT Ads metrics, including Ad-Level Add-to-Cart Value, Ad-Level Add to Carts, Ad-Level All Conversion Value, Ad-Level All Conversions, Ad-Level Clicks and Ad-Level Comments — each defined once so it means the same thing in every report.

What can I break ChatGPT Ads performance down by?

You can break ChatGPT Ads metrics down by Entity Level, Campaign, Ad group, Ad, Ad status, Objective, Commission Rate Percent and Media Budget Currency, and more.

Can I combine ChatGPT Ads with other data sources?

Yes. ChatGPT Ads sits in the same client workspace as sources like Google Analytics 4, Shopify, Google Ads, Facebook Ads and HubSpot, so one report or question can use them together.

What ChatGPT Ads data does Maven sync?

Maven syncs campaigns, ad groups, ads, ad insights and campaign insights from ChatGPT Ads.

How often does ChatGPT Ads data sync to Maven?

Maven refreshes ChatGPT Ads on a schedule after the source is connected, and shows each source’s last sync time in the client’s workspace, so you can check the data is current before a report goes out.

Is my ChatGPT Ads data secure with Maven?

Yes. Maven encrypts integration credentials and tokens, scopes access to the workspace, and uses the connection only to sync the reporting data needed for governed analytics.

Start your 14-day trial

Set up your first client, build their report by asking Claude or ChatGPT, and publish it to their portal.

  • Free for 14 days, no credit card
  • Your first client workspace and portal
  • Every report template, ready to clone
Start a 14-day trial

Nothing is charged unless you subscribe.

Prefer a walkthrough? Book a demo on one of your own clients.