Integrations

X Ads datasets and fields

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

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

Connection and sync#

You connect X Ads by signing in to it and approving access, so nobody shares a password.

The first X Ads sync pulls the most recent 30 days so the workspace fills quickly. A follow-up backfill then adds older history, up to 12 months in total. After that, each scheduled sync re-reads the last 7 days, so late changes are picked up.

Datasets#

Performance#

Normalized campaign and delivery report rows.

FieldType
dateDate
account IDText
campaign IDText
impressionsNumber
clicksNumber
spendNumber
conversionsNumber
revenueNumber

Conversion actions daily#

Provider-attributed X web conversion actions at promoted-tweet grain, with unallocated campaign fallback.

FieldType
action keyText
dateDate
account IDText
account nameText
campaign IDText
campaign nameText
ad group IDText
ad group nameText
ad IDText
ad nameText
creative IDText
conversion action IDText
conversion action nameText
conversionsNumber
conversion valueNumber
reported grainText

Conversion report coverage daily#

Successful X web-conversion report coverage, including empty and campaign-fallback days.

FieldType
coverage keyText
dateDate
account IDText
report nameText
requested grainText
reported grainText
report statusText
row countInteger
is partialTrue/false
fallback reasonText