Integrations

ChatGPT Ads datasets and fields

The 12 datasets Maven lands from ChatGPT Ads, every field in them, and how the connection syncs.

Maven lands 12 datasets from ChatGPT Ads in each client workspace. This page lists every one with all of its fields. For the metrics, reports and setup steps, see the ChatGPT Ads integration page.

Connection and sync#

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.

Datasets#

Ad account#

Single-row account metadata snapshot.

FieldType
account IDText
account nameText
URLText
preview URLText
timezoneText
currency codeText

Campaigns#

Campaign entity table — snapshot of all campaigns.

FieldType
campaign IDText
campaign nameText
descriptionText
statusText
start timeTimestamp
end timeTimestamp
lifetime spend limit microsInteger
lifetime spend limitNumber
targeting countriesText
targeting excluded countriesText
created atTimestamp
updated atTimestamp
account IDText

Ad groups#

Ad group entity table — snapshot of all ad groups.

FieldType
ad group IDText
ad group nameText
descriptionText
campaign IDText
statusText
context hintsText
billing event typeText
max bid microsInteger
max bidNumber
created atTimestamp
updated atTimestamp
account IDText

Ads#

Ad entity + creative metadata — snapshot of all ads.

FieldType
ad IDText
ad nameText
ad group IDText
campaign IDText
statusText
review statusText
creative typeText
creative titleText
creative bodyText
creative target URLText
creative file IDText
creative image URLText
created atTimestamp
updated atTimestamp
account IDText

Ad insights#

Ad-grain daily insights.

FieldType
dateDate
ad IDText
ad nameText
ad group IDText
ad group nameText
campaign IDText
campaign nameText
account IDText
impressionsInteger
clicksInteger
spendNumber
CTRNumber
CPCNumber
CPMNumber
start timeTimestamp
end timeTimestamp
timezoneText

Ad group insights#

Ad-group-grain daily insights.

FieldType
dateDate
ad group IDText
ad group nameText
campaign IDText
campaign nameText
account IDText
impressionsInteger
clicksInteger
spendNumber
CTRNumber
CPCNumber
CPMNumber
start timeTimestamp
end timeTimestamp
timezoneText

Campaign insights#

Campaign-grain daily insights.

FieldType
dateDate
campaign IDText
campaign nameText
account IDText
impressionsInteger
clicksInteger
spendNumber
CTRNumber
CPCNumber
CPMNumber
start timeTimestamp
end timeTimestamp
timezoneText

Conversion pixels#

Conversion pixel catalog for the ad account (id, name, client type).

FieldType
account IDText
pixel IDText
data source IDText
pixel nameText
client typeText
snapshot dateDate

Conversion event settings#

Per-account conversion event/goal configuration (attribution windows, associated campaigns/sources, archived flag). Config only -- not volume or event-level data.

FieldType
account IDText
event setting IDText
ad account IDText
nameText
event typeText
custom event nameText
archivedTrue/false
is shopify managedTrue/false
attribution window daysInteger
view through attribution window daysInteger
versionInteger
source IDs jsonText
sources jsonText
campaigns jsonText
snapshot dateDate

Conversion event samples daily#

FieldType
account IDText
pixel IDText
sample dateDate
action sourceText
API channelText
event typeText
sample event countInteger
last event timestampTimestamp
last received atTimestamp
p50 latency secondsNumber
p95 latency secondsNumber
syncs sampledInteger

Account insights#

Account-grain daily insights.

FieldType
dateDate
account IDText
impressionsInteger
clicksInteger
spendNumber
CTRNumber
CPCNumber
CPMNumber
start timeTimestamp
end timeTimestamp
timezoneText

Ad product insights#

FieldType
dateDate
account IDText
campaign IDText
campaign nameText
ad group IDText
ad group nameText
ad IDText
ad nameText
product feed IDText
product item IDText
product titleText
product image URLText
product target URLText
product brandText
product priceText
impressionsInteger
clicksInteger
spendNumber
spend reportedTrue/false
timezoneText