Viant Reference

Send advertising conversion events directly to Viant's DSP.

This is a reference document for the Viant destination. For information on how to set up this integration, see the Viant Quick Start Guide.

Destination Info

• Supports Track calls

• Supports HIPAA mode

• Supports Freshpaint Impression Pixel

• Supports forwarding from the Google Tag Manager Integration

• Refer to this destination as viant in the Integrations object

  • If you've configured multiple Advertiser IDs, you can choose a specific one by suffixing the Advertiser ID, such as: viant::123456. You can retrieve this value from Viant configuration page for the Advertiser ID of interest.

When no suffix is specified, all configured Advertiser IDs are selected for inclusion / exclusion.

• Connection Modes:

	Client-side	Server-side
Web
Mobile
Server

Click Through Tracking

Freshpaint supports click through tracking by capturing the viant_clid query parameter on the landing page configured on your creative. You need to have the Freshpaint javascript snippet installed on the landing page for this to work. Assuming you have followed the Viant Quick Start Guide to set up your Viant destination, you can verify that click through tracking is working by looking for an event in event verification that contains the $viant_clid field.

Event verification

Click ID being captured

View Through Tracking

Freshpaint supports view through tracking by capturing the viant_impid passed in by Viant using the Freshpaint Impression Pixel. Assuming you have followed the Viant Quick Start Guide to set up your Viant destination, you can verify that view through tracking is working by looking for an event in event verification that contains the $viant_impid field, similar to how you can verify Click Through Conversion.

You can also look for a transformation that shows that the event data was enriched by the Freshpaint Impression Pixel.

Transformation applying the Impression Pixel captured impression to an event

Relevant Properties

These are the properties that are sent to Viant. If you've followed the Viant Quick Start Guide correctly, no further action is necessary. This section is just informational.

Freshpaint property	Viant parameter	Type	Description
$viant_clid	xid	string	This is the Viant Click ID that is captured by the Freshpaint tracker on the landing page configured on the creative. This is a required property, but can be empty if it's a view through conversion. This takes priority over the view impression ID.
$viant_impid	imp_id	string	This is the Viant View Impression ID. This property is captured by the Freshpaint Impression Pixel, and is passed to Freshpaint via the tracking pixel configured on the creative. This is a required property, but can be empty if it is a click through conversion.
<event_name>	ci_t_event_name p_event_name	string	Event name property for Viant. Freshpaint automatically sets both Viant parameters to the event name.
<advertiser_id>	c_advertiser_id	numeric string	This is your Viant Advertiser ID that you configure on Freshpaint when setting up the destination. Required.
<event_time>	p_event_time	number	This is the event time represented in ms since epoch. Automatically set by Freshpaint.
-	ci_t_vendor	string	Hardcoded to freshpaint. Automatically set by Freshpaint.
-	ci_t_action	string	Hardcoded to tx_created. Automatically set by Freshpaint.