ChannelMix API connection is built around Google Keyword Planner - Generate Keyword Historical Metrics. Use the following guides to help answer questions about ChannelMix's connection.
Connection Guide
| Currently Supported Version: | v17 |
|---|---|
| Attribution Window: | N/A |
| Time Zone Reporting: | Configured during Account setup. Google Ads Documentation |
| API Limitations: | API Limits and Quotas |
| Backfill Limitations: |
The API only allows for the last 12 months of data to be pulled with monthly aggregation (see Dataset Activation). |
| Refresh Limit: | Each ChannelMix client can refresh no more than 43,800 days' worth of data across all profiles per month (see Dataset Refresh). |
Connection Authentication
The authentication process is the same process that is used for Google Ads. Authentication for Google Ads is accomplished using the OAuth flow provided within the ChannelMix Control Center. Connecting Data Sources
Profile Association and Values
Keyword List: List of case-sensitive user defined keywords used to pull data. Click the '+' under the "Keyword List" section of the profile association widget and type in your keyword (remember the keywords are case sensitive). Use the trash can image to remove a keyword.
When setting up the Keyword List be sure that the main keyword is listed before any variations or close variants of the keyword, for example "Some Keyword" should be listed before "SomeKeyword". The API does not return all listed keywords if they are close or variations of each other and if a variation with no data is listed first, then no data will be returned.
Geo Target: You can select "--ALL GEOS--" to pull all geo locations or associate one geo location for each ChannelMix profile. Since each ChannelMix profile can only be associated with one selection from the Geo Target list, if you want to select more than one geo location, but don't want to select "--ALL GEOS--", you will need to associate multiple profiles with the connection and choose one geo location per profile.
Manager ID: The unique identifier associated with a manager account.
Customer Client ID: The unique identifier for the Google Account to pull reporting for. (Also known as the Profile ID)
Required User Permission Levels
The authenticating user must either be an MCC account holder or the owner of the account for which we need to pull data.
Data Guide
| Lag Time: | 0 days |
|---|---|
| Span: | 1 day (the API will always return the last 12 months of data even when the date range passed to it is 1 day) |
| Report Type | API Source Documentation | ChannelMix Datasets |
|---|---|---|
| Generate Keyword Historical Metrics |