Integrations
StackAdapt datasets and fields
The 13 datasets Maven lands from StackAdapt, every field in them, and how the connection syncs.
Maven lands 13 datasets from StackAdapt in each client workspace. This page lists every one with all of its fields. For the metrics, reports and setup steps, see the StackAdapt integration page.
Connection and sync#
You connect StackAdapt with API credentials from the StackAdapt account. Maven stores them encrypted.
The first StackAdapt sync pulls the most recent 30 days so the workspace fills quickly. A follow-up backfill then adds older history, up to 180 days in total. After that, each scheduled sync re-reads the last 30 days, so late changes are picked up.
Datasets#
Advertiser settings#
Advertiser reporting metadata from GraphQL advertisers or explicitly operator-verified connection settings.
| Field | Type |
|---|---|
| account ID | Text |
| account name | Text |
| account currency | Text |
| account timezone | Text |
| metadata provenance | Text |
| provider payload fields | Text |
Delivery stats#
| Field | Type |
|---|---|
| date | Date |
| source interval start | Timestamp |
| source interval end | Timestamp |
| account ID | Text |
| account name | Text |
| advertiser ID | Integer |
| line item ID | Integer |
| line item | Text |
| campaign ID | Integer |
| campaign | Text |
| ad ID | Text |
| native ad ID | Text |
| ad name | Text |
| imp | Integer |
| click | Integer |
| cost | Number |
| conv | Integer |
| s conv | Integer |
| conv rev | Number |
| vcomp 0 | Integer |
| vcomp 25 | Integer |
| vcomp 50 | Integer |
| vcomp 75 | Integer |
| vcomp 95 | Integer |
| acomp 0 | Integer |
| acomp 25 | Integer |
| acomp 50 | Integer |
| acomp 75 | Integer |
| acomp 95 | Integer |
Ads#
GraphQL creative/UTM metadata scoped to one selected StackAdapt advertiser.
| Field | Type |
|---|---|
| ad ID | Text |
| account ID | Text |
| advertiser ID | Text |
| line item ID | Text |
| line item name | Text |
| campaign ID | Text |
| campaign name | Text |
| campaign group ID | Text |
| campaign group name | Text |
| ad name | Text |
| ad type | Text |
| brandname | Text |
| audit status | Text |
| state | Text |
| creative size | Text |
| creative state | Text |
| creative status | Text |
| is archived | True/false |
| is draft | True/false |
| is rejected | True/false |
| is paused | True/false |
| click URL | Text |
| image URL | Text |
| thumbnail URL | Text |
| video URL | Text |
| preview asset ID | Text |
| preview storage path | Text |
| preview source URL | Text |
| preview status | Text |
| preview failure code | Text |
| preview verified at | Timestamp |
| preview content type | Text |
| preview width | Integer |
| preview height | Integer |
| headline | Text |
| body text | Text |
| call to action | Text |
| UTM source | Text |
| UTM medium | Text |
| UTM campaign | Text |
| UTM content | Text |
| UTM term | Text |
| UTM ID | Text |
| sa campaign ID | Text |
| sa line item ID | Text |
| sa creative ID | Text |
| landing domain | Text |
| landing path | Text |
Campaign groups#
Completed GraphQL Campaign Group snapshots at the canonical campaign level, including status, dates, timezone, budget, pacing, and frequency-cap metadata.
| Field | Type |
|---|---|
| account ID | Text |
| advertiser ID | Text |
| campaign group ID | Text |
| campaign group name | Text |
| state | Text |
| status | Text |
| is archived | True/false |
| created at | Timestamp |
| timezone | Text |
| budget type | Text |
| budget rollover | True/false |
| daily budget | Number |
| lifetime budget | Number |
| flight count | Integer |
| start time | Timestamp |
| end time | Timestamp |
| flights json | Text |
| freq cap limit | Integer |
| freq cap expiry minutes | Integer |
| revenue type | Text |
| revenue pricing | Number |
| budget allocation type | Text |
| min budget allocation percent | Integer |
| unranked campaigns max cap | Integer |
Campaigns#
Completed GraphQL Campaign snapshots at the canonical ad-group level, retaining their Campaign Group parent and flight configuration.
| Field | Type |
|---|---|
| account ID | Text |
| advertiser ID | Text |
| campaign group ID | Text |
| campaign group name | Text |
| campaign ID | Text |
| campaign name | Text |
| channel type | Text |
| goal type | Text |
| state | Text |
| status | Text |
| is archived | True/false |
| is draft | True/false |
| created at | Timestamp |
| updated at | Timestamp |
| timezone | Text |
| budget rollover | True/false |
| daily budget | Number |
| lifetime budget | Number |
| flight count | Integer |
| start time | Timestamp |
| end time | Timestamp |
| flights json | Text |
| freq cap limit | Integer |
| freq cap expiry minutes | Integer |
| conversion tracker config status | Text |
| primary conversion trackers json | Text |
| secondary conversion trackers json | Text |
Configured target coverage#
Current completeness status for StackAdapt Campaign audience tracker collection at Maven ad-group scope.
| Field | Type |
|---|---|
| coverage key | Text |
| account ID | Text |
| scope level | Text |
| collection status | Text |
| source entity count | Integer |
| configured target count | Integer |
| capability reason | Text |
| collected at | Timestamp |
Entity syncs#
Account-scoped completion marker published only after Campaign Group, Campaign, and ad entity writes all succeed.
| Field | Type |
|---|---|
| account ID | Text |
| API surface | Text |
| campaign group count | Integer |
| campaign count | Integer |
| ad count | Integer |
| completed at | Timestamp |
Campaign insights daily#
Daily advertiser-scoped campaign Insights with explicitly tagged grains.
| Field | Type |
|---|---|
| date | Date |
| account ID | Text |
| advertiser ID | Text |
| breakdown type | Text |
| campaign group ID | Text |
| campaign group name | Text |
| campaign ID | Text |
| campaign name | Text |
| ad ID | Text |
| ad name | Text |
| app domain | Text |
| app category | Text |
| app title | Text |
| supply source ID | Text |
| supply source name | Text |
| country code | Text |
| country name | Text |
| region code | Text |
| region name | Text |
| dma code | Text |
| zip code | Text |
| device type | Text |
| device os | Text |
| conversion pixel ID | Text |
| conversion pixel name | Text |
| conversion type | Text |
| conversion count type | Text |
| attribution window days | Integer |
| impressions | Integer |
| clicks | Integer |
| cost | Number |
| conversions | Integer |
| conversion revenue | Number |
| click conversions | Integer |
| impression conversions | Integer |
| secondary conversions | Integer |
| click secondary conversions | Integer |
| impression secondary conversions | Integer |
| unique conversions | Integer |
| unique impressions | Integer |
| frequency | Number |
| engagements | Integer |
| page starts | Integer |
| video starts | Integer |
| video q1 playbacks | Integer |
| video q2 playbacks | Integer |
| video q3 playbacks | Integer |
| video completions | Integer |
| audio starts | Integer |
| audio q1 playbacks | Integer |
| audio q2 playbacks | Integer |
| audio q3 playbacks | Integer |
| audio completions | Integer |
Conversion report coverage daily#
Successful native ad-by-conversion-pixel report coverage, including account-days with zero returned rows.
| Field | Type |
|---|---|
| date | Date |
| account ID | Text |
| report name | Text |
| requested grain | Text |
| reported grain | Text |
| report status | Text |
| row count | Integer |
| is partial | True/false |
Conversion trackers#
Conversion-tracker entity snapshot scoped to one selected StackAdapt advertiser via configured name prefixes.
| Field | Type |
|---|---|
| account ID | Text |
| conversion tracker ID | Integer |
| name | Text |
| description | Text |
| conv type | Text |
| post time | Integer |
| count type | Text |
| matched prefix | Text |
Conversion tracker stats#
Daily conversion-tracker stats scoped to one selected StackAdapt advertiser.
| Field | Type |
|---|---|
| date | Date |
| account ID | Text |
| conversion tracker ID | Integer |
| tracker name | Text |
| conv | Integer |
| s conv | Integer |
| sconv click | Integer |
| sconv imp | Integer |
| uniq conv | Integer |
Conversion pixels#
GraphQL ConversionPixel inventory safely bound to one selected advertiser.
| Field | Type |
|---|---|
| account ID | Text |
| conversion pixel ID | Text |
| name | Text |
| description | Text |
| unique key | Text |
| conversion type | Text |
| count type | Text |
| post time | Integer |
| advertiser restricted | True/false |
| advertiser IDs | Text |
| match method | Text |
| matched prefix | Text |
| rollout mode | Text |
Conversion pixel fires daily#
Dense GraphQL pixel fire time series at workspace, advertiser, date, and conversion-pixel grain.
| Field | Type |
|---|---|
| date | Date |
| account ID | Text |
| conversion pixel ID | Text |
| pixel name | Text |
| fire count | Integer |
| is zero filled | True/false |
| rollout mode | Text |