ChannelMix API connection is built around the StackAdapt API.
Connection Guide
| Currently Supported Version: | v2 (GraphQL) |
|---|---|
| Attribution Window: | n/a |
| Time Zone Reporting: |
StackAdapt allows users to setup a default time zone on your StackAdapt account. When pulling data, ChannelMix will use the default time zone on the account OR the time zone associated to individual campaigns (if campaign time zone is not specified then account time zone is used). ChannelMix can not currently support time zone conversions for this connection. |
| API Limitations: | Rate Limit Documentation |
| Backfill Limitations: |
Standard source activation allows for up to 731 days of backfill (see Dataset Activation). |
| Refresh Limit: | Each ChannelMix client can refresh no more than 5,000 days' worth of data across all profiles per month (see Dataset Refresh). |
Connection Authentication
ChannelMix's integration with StackAdapt can be configured by selecting the StackAdapt icon located in the Control Center Connection page. The source connection uses an API Token to authenticate your StackAdapt account so ChannelMix can automate reports. For this connection, you will need an API Token for the GraphQL StackAdapt API. If you need help accessing your StackAdapt API token, please contact your StackAdapt account manager.
After providing a valid API Token, you'll need to associate a ChannelMix Profile to a StackAdapt Advertiser account. This relationship will help ChannelMix classify your StackAdapt data into appropriate groups so that your ETL reporting processes stay organized.
Profile Association and Values
A profile in ChannelMix will be a one-to-one relationship to an advertiser ID. If no advertiser ID is provided, ALL advertisers to which the API Token has access can be returned, however, this is not recommended.
Required User Permission Levels
n/a
Data Guide
| Lag Time: | 1 day |
|---|---|
| Span: |
7 days for performance data (clicks, impressions, cost, etc.) 30 days for conversion data |
ChannelMix builds datasets using the Get Stats endpoint in the StackAdapt API. This endpoint requests a combination of a "Resource" and a "Type" in order to build stat reports.
| Support Resources | API Source Documentation | ChannelMix Datasets |
|---|---|---|
| ads (including campaign groups and campaigns) | GraphQL | Queries | Ads (requires StackAdapt credentials) | |
| conversion_tracker | GraphQL | Queries | Conversion Path (requires StackAdapt credentials) |
Support Types:
- daily
- hourly
- domain (only available for campaign resource)
Advertiser data is included although not specifically listed as an available resource.
Reporting Guide
| Type of Application: | DSP (Demand-side Platform) |
|---|
Relevant OneViews
- Display and Video OneView
- Ecommerce Pipeline OneView
- Lead Generation Pipeline Oneview
- Paid Media OneView Performance and Conversion