Microsoft Ads
Sync audience segments to Microsoft Advertising (formerly Bing Ads) for customer match targeting across the Microsoft Search Network.
Prerequisites
- A Microsoft Advertising account
- Your Account ID and Customer ID
- Access to the Microsoft Advertising API
Authentication
Microsoft Ads uses OAuth 2.0 via Microsoft identity platform.
- Click Connect with OAuth in Zeotap
- Sign in with your Microsoft account
- Authorize the requested permissions
OAuth scopes: https://ads.microsoft.com/msads.manage, offline_access.
Configuration
| Field | Type | Required | Description |
|---|---|---|---|
| Account ID | Text | Yes | Your Microsoft Advertising account identifier. Example: 123456789 |
| Customer ID | Text | Yes | Your Microsoft Advertising customer identifier. Example: 987654321 |
Target Settings
| Field | Type | Required | Description |
|---|---|---|---|
| Audience Name | Text | Yes | Name of the customer list audience |
| Audience ID | Text | No | Existing audience ID to update. Leave blank to create new. |
Supported Operations
Sync Modes: Upsert, Mirror
Audience Sync Modes: Add, Remove, Mirror, Upsert
Features
- Field Mapping: No
- Schema Introspection: No
Match Keys
Microsoft Advertising customer match works on hashed identifiers. Map raw columns and Zeotap normalizes and hashes them at delivery, or map pre-hashed SHA-256 hex digests directly:
| Field | Type | Description |
|---|---|---|
email | string | Raw email address — lowercased, trimmed, and SHA-256 hashed before upload |
hashed_email | string | Pre-hashed SHA-256 hex digest of the lowercase, trimmed email |
phone | string | Raw phone number — normalized to E.164 (digits with leading +) and SHA-256 hashed before upload |
hashed_phone | string | Pre-hashed SHA-256 hex digest of the E.164 phone number |
When both a raw field and its pre-hashed counterpart are mapped, the pre-hashed value wins. Values that are not valid 64-character hex digests are never uploaded — they are dropped (falling back to the raw column if mapped) and counted in the sync run logs. See Match Keys & Identifier Hashing for the full normalization contract, precedence, and validation rules.
Troubleshooting
Account ID or Customer ID not found
Find these values in Microsoft Advertising under Account Settings. The Account ID and Customer ID are different values.
Insufficient permissions
The authenticated user must have Super Admin or Standard User role on the Microsoft Advertising account.