Track CTV app campaigns on Vizio
With Adjust's Vizio SAN integration, you can measure the impact of campaigns you run on Vizio inventory and the number of installs of your connected TV (CTV) app.
Here, you can find information about how to connect Adjust to Vizio in the Adjust dashboard, and send Adjust data server-to-server (S2S).
Before you begin
Here's what you need to know before getting started.
Requirements
- A Vizio Product
- Product is a unique value that Vizio generates to identify your app. It uses the following syntax:
&vzapppartnername.
- Product is a unique value that Vizio generates to identify your app. It uses the following syntax:
Integration details
Adjust's S2S integration with Vizio cannot be used in conjunction with the Adjust SDK.
Vizio is a self-attributing network. This means that Adjust sends Vizio data for all of your app's installs and Vizio self-attributes using their own engagement data. Adjust then checks this data to confirm the source of the last engagement.
Vizio reporting structure
Here's how Vizio campaign data is reported in Adjust:
- Network =
Vizio - Campaign =
campaign_id - Adgroup =
line_item_id - Creative =
creative_id
Supported device identifiers
| ID | ID Type | Format |
|---|---|---|
| IDFA | Raw Apple advertising ID | Uppercase, with hyphens |
| GPS_ADID | Raw Google advertising ID | Lowercase, with hyphens |
| FIRE_ADID | Raw Amazon Fire advertising ID | Lowercase, with hyphens |
| WIN_ADID | Raw Windows advertising ID | Without hyphens |
| VIDA | Raw Vizio advertising ID | Lowercase, with hyphens |
| OAID | Raw Huawei advertising ID | Lowercase, with hyphens |
Vizio has their own device identifier called VIDA. Users on Vizio devices can reset it at any time or disable it to avoid targeted advertising.
Dashboard setup
When you activate the Vizio module integration, Adjust immediately begins to forward activity data to Vizio for attribution.
To activate the module, follow these steps in the Adjust dashboard:
- Find your app and select your app options caret (^)
- Select Partner Setup
- Select ADD PARTNERS and select Add (+ icon) beside Vizio
- Enter your Vizio Product
- Select SAVE
Manage event linking
To link events to Vizio, follow these steps.
- Find your app and select your app options caret (^)
- Select Partner Setup
- Enter Vizio
- Select Event Linking
Under each Adjust-tracked in-app event you will see a field with a drop-down menu. Use the dropdown menu to select a predefined Vizio event that maps to your Adjust-tracked event. Custom events cannot be sent to Vizio.
| Vizio Event Name | Description |
|---|---|
trial | Device initiated a trial period of an app. |
sign_up | Device signed up for a product or service. |
subscription | The ongoing event that signifies a device’s subscription status. |
QSS | Trigger QSS on Video Views exceeding 5 minutes of contiguous video playback time. A single video view of 60 minutes, for example, will result in a single QSS event. |
text_search | Text Search Initiated. |
voice_search | Voice Search initiated. |
video_stream | Video Playback Initiation (Request for Video Stream). |
est_transaction | EST Transaction (Entertainment Sell Thru) - a one time purchase. |
first_video_view | Video View - First time video view will map to Vizio FTV. |
video_view | Video Metadata (Detailed Content View - Content BOB Info in terms of - Network, Title, Genre, Type, Rating). |
Ad_initiated | CSAI or SSAI In-Stream Ad Initiated. |
Server-to-server integration
With the Vizio module enabled in the Adjust dashboard, you can now set up server-to server integration with Adjust. This means you only send Adjust in-app session and event data through S2S API calls.
Requirements
- For details on the requirements for your in-app solution, refer to Adjust's server-to-server attribution checklist.
- All requests to Adjust servers must be made in the same sequential order they occur on the device.
- Always include the
os_namein your request. This can be:androidiosfire-tvrokuvizio
Send sessions
Sessions are the base of all attribution and tracking in Adjust. They trigger when a user resumes using an app from the background or when they open the app.
To send Adjust sessions, use our S2S sessions API.
Endpoint: https://s2s.adjust.com/session
Send in-app events
To send Adjust in-app event data, use our S2S events API.
Endpoint: https://s2s.adjust.com/event
Export your data
Placeholders
You can use the following placeholders to get specific Vizio datapoints in your raw data exports.
| Placeholder | Description |
|---|---|
{VIDA} | Vizio's device ID |
{vizio_content_id} | Content or Ad Unit ID displayed |
{vizio_placement_type} | Shows the value of the ad slot where the ad is being run on Vizio's own platform. |