Skip to main content

Viant

This guide explains how to configure Viant as a data source and understand how account, campaign, ad group, ad and conversion names are structured.

What is Viant?

Viant is a demand-side platform (DSP) used to plan, buy and measure programmatic display, video, CTV and audio campaigns. You connect it to spyne with your Viant login, then select the Advertisers you want to bring into your workspace.

Field Mapping Reference

spyne level

spyne field

Viant field

Partner (Agency)

source_partner_id

agency_id

Partner (Agency) name

source_partner_name

agency_name

Account

source_account_id

advertiser_id + location_country_code

Account name

source_account_name

advertiser_name (falls back to advertiser_id when empty)

Campaign

source_campaign_id

campaign_id + order_id

Campaign name

source_campaign_name

campaign_name + order_name

Ad Group

source_adgroup_id

line_id

Ad Group name

source_adgroup_name

line_name

Ad

source_ad_id

creative_id

Ad name

source_ad_name

creative_name

📌 Keep in mind

Your Account ID combines the Viant advertiser with its country, so the same advertiser running campaigns in several countries appears as one distinct account per country in spyne. Likewise, a Campaign combines Viant's Campaign and Order levels, so what you see as one campaign in spyne always corresponds to one Campaign/Order pair in Viant.

Conversions from Viant

You can use these conversion names to build a Custom Conversion to extract Viant conversions and retrieve them in spyne.

Conversion name (displayed value)

Source (Viant report)

Raw metric (volume)

Raw metric (value)

Granularity level

{pixel_name}

conversion (pixel)

conversions

revenue

Ads + Campaigns

{pixel_name} (Unique)

conversion (pixel)

conversion_up

—

Ads + Campaigns

{pixel_name} - Post Click

conversion (pixel)

post_click_conversions

post_click_revenue

Ads + Campaigns

{pixel_name} - Post Click (Unique)

conversion (pixel)

post_click_conversion_up

—

Ads + Campaigns

{pixel_name} - Post View

conversion (pixel)

post_view_conversions

post_view_revenue

Ads + Campaigns

{pixel_name} - Post View (Unique)

conversion (pixel)

post_view_conversion_up

—

Ads + Campaigns

{pixel_name} - Item View

conversion (pixel)

item_view

—

Ads + Campaigns

{pixel_name} - Other

conversion (pixel)

other_conversions

—

Ads + Campaigns

Viant - Landing Page

conversion (action type)

landing_page

—

Ads + Campaigns

Viant - Page View

conversion (action type)

page_view

—

Ads + Campaigns

Viant - Lead

conversion (action type)

lead (→ lead_conversions)

—

Ads + Campaigns

Viant - Purchase

conversion (action type)

purchase

—

Ads + Campaigns

Viant - Add To Cart

conversion (action type)

add_to_cart

—

Ads + Campaigns

Viant - Add Payment Info

conversion (action type)

add_payment_info

—

Ads + Campaigns

Viant - Initiate Checkout

conversion (action type)

initiate_checkout

—

Ads + Campaigns

Viant - Standard Conversion

performance_age_gender (aggregated)

source_conversions

source_conversions_value

Ads + Campaigns

Viant - Offline Purchases

performance_age_gender (aggregated)

source_offline_purchases

source_offline_sales

Ads + Campaigns

Viant - Click Conversions

performance_age_gender (aggregated)

source_click_conversions

—

Ads + Campaigns

Viant - Click Conversions (Unique)

performance_age_gender (aggregated)

source_click_conversions_up

—

Ads + Campaigns

Viant - View Conversions

performance_age_gender (aggregated)

source_view_conversions

—

Ads + Campaigns

Viant - View Conversions (Unique)

performance_age_gender (aggregated)

source_view_conversions_up

—

Ads + Campaigns

Viant - Conversions (Unique)

performance_age_gender (aggregated)

source_conversion_up

—

Ads + Campaigns

Related articles

Did this answer your question?