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.
| Field | Type |
|---|---|
| date | Date |
| account ID | Text |
| campaign ID | Text |
| impressions | Number |
| clicks | Number |
| spend | Number |
| conversions | Number |
| revenue | Number |
Conversion actions daily#
Provider-attributed X web conversion actions at promoted-tweet grain, with unallocated campaign fallback.
| Field | Type |
|---|---|
| action key | Text |
| date | Date |
| account ID | Text |
| account name | Text |
| campaign ID | Text |
| campaign name | Text |
| ad group ID | Text |
| ad group name | Text |
| ad ID | Text |
| ad name | Text |
| creative ID | Text |
| conversion action ID | Text |
| conversion action name | Text |
| conversions | Number |
| conversion value | Number |
| reported grain | Text |
Conversion report coverage daily#
Successful X web-conversion report coverage, including empty and campaign-fallback days.
| Field | Type |
|---|---|
| coverage key | Text |
| date | Date |
| account ID | Text |
| report name | Text |
| requested grain | Text |
| reported grain | Text |
| report status | Text |
| row count | Integer |
| is partial | True/false |
| fallback reason | Text |