Microsoft Ads

Supports:

✅ Model sync destination
✅ Bulk sync source

Connection

Configuration

Name	Type	Description	Required
`auth_method`	`string`	Authentication method Accepted values: `microsoft`, `google`	`true`
`auto_add_accounts`	`boolean`	Automatically add new accounts	`false`
`client_id`	`string`		`false`
`client_secret`	`string`		`false`
`oauth_refresh_token`	`string`		`false`

`oauth_token_expiry`

When `oauth_token_expiry` has a value

Name	Type	Description	Required
`accounts`	`array`	Accounts	`false`
`agree_customer_match_terms`	`boolean`	Agree to Microsoft’s Customer Match Terms when syncing audiences	`false`

Example

{
  "name": "Microsoft Ads connection",
  "type": "msads",
  "configuration": {
    "auth_method": "",
    "auto_add_accounts": false,
    "client_id": "a45gadsfdsafbyorxhugfbhsgllpf12gf56gfds",
    "client_secret": "ay8d5hdepz62px8lqeoakuea2ccl4rxm13i6tbyorxhu1i20kc8ruvksmzxq",
    "oauth_refresh_token": "dasfdasz62px8lqeoakuea2ccl4rxm13i6tbyorxhu1i20kc8ruvksmzxq"
  }
}

Read-only properties

Name	Type	Description	Required
`username`	`string`	Connected user	`false`

Model Sync

Target

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

Target creation

Microsoft 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	Audience name	false

Bulk Sync

Source

Configuration

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

Example

{
  ...
  "source_configuration": {
    "reporting_lookback": 0
  }
}

Connection

Configuration

oauth_token_expiry

When oauth_token_expiry has a value

Example

Read-only properties

Model Sync

Target

Target creation

Bulk Sync

Source

Configuration

Example

`oauth_token_expiry`

When `oauth_token_expiry` has a value