Viant Quick Start Guide

Send advertising conversion events directly to Viant's DSP.

This is a guide to help you get started on sending your conversion events to Viant via Freshpaint. If you've already completed set up and are looking for more information, see Viant Reference.

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

Getting Started

What You'll Need

1. Your Viant Advertiser ID

2. Advertiser ID configured in Freshpaint

3. [If in HIPAA mode] Allowlist set up to allow Freshpaint to forward viant_clid and viant_impid to Viant

4. Impression pixel enabled to allow Freshpaint to do view through conversion attribution

5. Advertising media configured in your Viant account to specify viant_clid and viant_impid for click through and view through conversions respectively.

To set up Viant with Freshpaint, follow these steps:

1. Make sure you have the appropriate access in both Freshpaint and Viant:

   1. Contact your Freshpaint Account Manager to request access to this destination. Once you have that, we will help you step by step through the configuration process.

   2. Create your conversion funnel, and create events in Freshpaint to track your conversions.

2. Find your Advertiser ID in your Viant account.

Grab your Advertiser ID

1. Set the Advertiser ID in Freshpaint.

Set the Advertiser ID in Freshpaint.

1. [If in HIPAA mode] Set the Freshpaint allowlist for Viant to allow Freshpaint to forward viant_clid and viant_impid to Viant. These are required properties for the destination to be able to forward conversion events to Viant.

Required allowlist settings while in HIPAA mode

1. Enable the impression pixel for Viant. This enables Freshpaint to do view through attribution within Freshpaint and report the conversion event to Viant. We recommend enabling both IP matching and Cookie matching, and setting the Conversion Window to 30 days for the best results. Then copy the Pixel Configuration URL for step 5(b). Click Save once you have set your preferred configuration options and copied the url.

Impression Pixel for Viant

Configuring the impression pixel does not require sharing an IP address or Cookie with Viant. Freshpaint will do the attribution by matching either the IP address or Cookie to an impression that is seen by the Freshpaint Impression Pixel, and if a match is found, will send the impression id to Viant.

1. Configure your media within Viant. This will allow Freshpaint to capture the click and view impression IDs to be able to send Viant conversion events. The parameters added here are also the ones that are required to be allowlisted.

   1. For the Landing Page URL: add a query parameter viant_clid=${ADELPHIC_CLICKID} to your landing page URL to capture the click ID. This is required for click through conversion tracking via Freshpaint. For example, it should look like https://landingpageurl.com/abc?viant_clid=${ADELPHIC_CLICKID}

   2. For the Tracking Pixels (Pixel 1): Set the URL that you copied in step 4. This is required for view through conversion tracking via Freshpaint. The URL that you paste in should look like https://freshpaint-impression.com/pixel.png?env_id=<your-env-id>&dest_id=<your-dest-id>&cke=1&$viant_impid=${ADELPHIC_CLICKID}

Configure your creative in Viant

Set up a test campaign in Viant

1. Set up test campaign with a low budget (1$) to a target ‘Deal ID’ in Viant. You'll be able to obtain this value from your Customer Success Engineer.

   1. Select New Client Deal

   

   b. Fill out highlighted fields then click "Create Client Deal"

   

   c. Assign your creative to the test campaign/order/line (Supported sizes: 300x250, 728x90, 160x600, 300x600) and Target the test deal in your line along with US geo.

   
2. Navigate to page where ad is displayed, click through into your funnel (follow user steps that lead to your conversion event)

3. Verify in Freshpaint that the conversions are triggering in Live View

4. Verify in Freshpaint that conversions are flowing through to Viant via Event Verification and your conversions are displaying on the campaign in Viant as expected (see more on this below)

Verifying conversion reporting

Once you have followed the steps above, there are multiple ways you can verify that conversions are being reported to Viant:

Event Verification

On Freshpaint, you can use the event verification tab to see which events are being successfully sent to Viant. You can also dig into each event to see the data being sent or investigate errors if there are any.

Event Verification

Dashboards and Report Builder

It may take approximately an hour for your Viant dashboards to update.

On Viant, you can either find conversion numbers on various dashboards or you can use the Viant report builder tool to provide a CSV with those details.

Campaign Metrics if you are looking at Campaigns

Order Metrics if you're looking at Orders

You find performance numbers for each level of granularity (advertiser, campaign, order)

Campaign Screen looking at Order Metrics

Viant also has a report builder using which you can export a CSV of this data

Viant's Report Builder Tool

Further reading

Looking for more information? See Viant Reference.