Google Ads | Polytomic Docs

Supports:

✅ Model sync destination
✅ Bulk sync source
✅ Connection Proxy

Connection

Configuration

Name	Type	Description	Required
`accounts`	`array`	Accounts	`optional`
`auto_add_accounts`	`boolean`	Automatically add new accounts	`optional`
`blanket_user_consent`	`boolean`	All transmitted users consented to ad personalization and information sharing with Google Ads Causes this connection to send signals to Google Ads indicating that every transmitted user has accepted ad personalization and data sharing policies. This will cause the user to be included in more advertising functions, but requires you to have obtained express consent.	`optional`
`client_id`	`string`		`optional`
`client_secret`	`string`		`optional`
`custom_reports`	`string`	Custom reports One report per line. Format is a report name:ads object:field list. e.g. myReport:ad_groups:campaign.id,metrics.clicks	`optional`
`oauth_refresh_token`	`string`		`optional`
`use_data_manager_apis`	`boolean`	Use Data Manager APIs Use Google Data Manager APIs for user list operations and conversion uploads. Requires a token granted the Data Manager OAuth scope.	`optional`

Read-only property	Type	Description
`connected_user`	`string`	Connected user’s email

Example

{
  "name": "Google Ads connection",
  "type": "googleads",
  "configuration": {
    "accounts": [
        {
            "label": "",
            "value": ""
        }
    ],
    "auto_add_accounts": false,
    "blanket_user_consent": false,
    "client_id": "a45gadsfdsaf47byor2ugfbhsgllpf12gf56gfds",
    "client_secret": "ay8d5hdepz62px8lqeoakuea2ccl4rxm13i6tbyorxhu1i20kc8ruvksmzxq",
    "custom_reports": "",
    "oauth_refresh_token": "dasfdasz62px8lqeoakuea2ccl4rxm13i6tbyorxhu1i20kc8ruvksmzxq",
    "use_data_manager_apis": false
  }
}

Model Sync

Target

Google Ads connections may be used as the destination in a model sync.

All targets

Configuration

Name	Type	Description	Required
`finalize_async_checks_early`	`boolean`	Stop waiting for results early If true, stop waiting for Google Ads to finish processing accepted uploads after upload_result_wait_minutes and complete with a warning. Applies to user list uploads and to conversion uploads made through the Data Manager API.	`optional`
`upload_result_wait_minutes`	`integer`	Stop waiting after (minutes) Minutes from sync execution creation before finalizing accepted uploads with a warning. Uploads still in progress must finish first. Applies when finalize_async_checks_early is true; defaults to 240 and accepts 1 through 2880.	`optional`

Example

{
  ...
  "target": {
      "configuration": {
        "finalize_async_checks_early": false,
        "upload_result_wait_minutes": 240
    }
  }
}

Target creation

Google Ads connections may be used to create a new target for a model sync. The following parameters are required to create a new target:

NAME	DESCRIPTION	ENUM
account	Account ID	true
name	User list name	false

Bulk Sync

Source

Configuration

Name	Type	Description	Required
`reporting_lookback`	`integer`	Lookback period for reports	`optional`

Example

{
  ...
  "source_configuration": {
    "reporting_lookback": 8
  }
}