Vizio Ads

Sync audience segments to Vizio Ads for targeted Connected TV (CTV) advertising across Vizio SmartCast devices. Zeotap uploads audience data using IP address and email identifiers for household-level matching.

Prerequisites

A Vizio Ads account with API access (requires prior approval from the Vizio Ads team)
Your API credentials: Access Key and Secret Key (provided by your Vizio Ads representative)
Your Customer Directory identifier (provided by your Vizio Ads representative)

Authentication

Vizio Ads uses HMAC-signed API Key authentication.

Contact your Vizio Ads representative to obtain your Access Key and Secret Key
In Zeotap, navigate to Destinations and click Add Destination
Select Vizio Ads and enter your Access Key and Secret Key

Zeotap automatically signs each API request using HMAC-SHA256 with your secret key.

Configuration

Field	Type	Required	Description
Customer Directory	Text	Yes	Your Vizio Ads customer directory identifier, provided by your Vizio representative.

Target Settings

Field	Type	Required	Description
Audience Name	Text	Yes	Name of the audience segment to create or update in Vizio Ads
Audience ID	Text	No	Existing audience segment ID to update. Leave blank to create a new audience.

Supported Operations

Audience Sync Modes

Mode	Supported	Description
Add	Yes	Add users to the Vizio Ads audience segment
Mirror	Yes	Full refresh — adds new users and removes users no longer in the audience
Upsert	Yes	Add or update users in the audience segment (idempotent add)
Remove	—	Not supported. Use Mirror mode to automatically remove users.

Features

Field Mapping: Yes
Schema Introspection: No

Required Mapping Fields

Field	Description	Alternatives
IP Address	Primary match key for Vizio Ads audience segments. Used for household-level matching to Vizio devices.	`email`, `hashed_email`

Default Destination Fields

Field	Type	Description
`ip_address`	String	User IP address for household-level device matching
`email`	String	Email address (hashed automatically before upload)
`hashed_email`	String	Pre-hashed email (SHA-256 hex of lowercase trimmed email)

How It Works

Audience Creation: If no Audience ID is provided, Zeotap creates a new audience segment via the Vizio Ads API using the specified Audience Name.
Identifier Extraction: For each row, Zeotap extracts the IP address and/or email. Emails are automatically normalized (lowercased, trimmed) and hashed with SHA-256 before upload.
Batch Upload: Users are uploaded in batches of up to 50,000 identifiers per API request. Each request includes an action (ADD or REMOVE) and the user identifiers.
Household Matching: Vizio matches uploaded identifiers at the household level. One household may contain multiple Vizio devices, so audience counts reflect matched devices rather than individual users.
Mirror Mode: In mirror mode, Zeotap sends ADD requests for new/existing users and REMOVE requests for users no longer in the audience, ensuring the Vizio segment stays in sync with your warehouse data.

Rate Limits

Maximum sync frequency: once per 24 hours. Syncs should not execute more frequently than daily.
Batch size: up to 50,000 users per API request.
Zeotap processes batches sequentially to stay within Vizio Ads API limits.

Best Practices

Use IP address as the primary identifier for the best match rates on Vizio’s CTV inventory.
Include email as a secondary identifier to improve match rates through cross-device resolution.
Schedule syncs daily rather than more frequently, as Vizio Ads enforces a daily refresh limit.
Use Mirror mode for audience segments that should reflect your warehouse data exactly, automatically adding and removing users as your source data changes.
Pre-hash emails if you want full control over the hashing process. Map to the hashed_email field instead of email.

Troubleshooting

Authentication failed: invalid access key or secret key

Verify your Access Key and Secret Key with your Vizio Ads representative. These credentials are case-sensitive and must be entered exactly as provided.

Customer directory not found

Confirm your Customer Directory identifier with your Vizio Ads representative. This value is assigned during account setup and cannot be changed.

Audience creation failed

Ensure your API credentials have permission to create audience segments. Contact your Vizio Ads representative if you only have read access.

Low match rates

Vizio Ads matches at the household level using IP addresses. Match rates depend on the overlap between your audience’s IP addresses and Vizio’s device graph. Consider adding email as a secondary identifier to improve matching.

Sync frequency exceeded

Vizio Ads limits audience refreshes to once per 24 hours. If your sync schedule is more frequent, reduce it to daily. Zeotap will return errors if the rate limit is exceeded.

Audience counts differ from source

Vizio Ads audience counts reflect matched devices, not individual users. A single household may contain multiple Vizio devices, so the audience count in Vizio Ads may be higher or lower than your source row count.