Viant Quick Start Guide
Send advertising conversion events directly to Viant's DSP.
Last updated
Send advertising conversion events directly to Viant's DSP.
Last updated
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.
Supports Track calls
Supports HIPAA mode
Supports Freshpaint Impression Pixel
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 | |
|---|---|---|
Your Viant Advertiser ID
Advertiser ID configured in Freshpaint
[If in HIPAA mode] Allowlist set up to allow Freshpaint to forward viant_clid and viant_impid to Viant
Impression pixel enabled to allow Freshpaint to do view through conversion attribution
Advertising media configured in your Viant account to specify viant_clid and viant_impid for click through and view through conversions respectively.
Find your Advertiser ID in your Viant account.
Set the Advertiser ID in Freshpaint.
[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.
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.
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.
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.
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}
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}
Once you have followed the steps above, there are multiple ways you can verify that conversions are being reported to Viant:
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.
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.
You find performance numbers for each level of granularity (advertiser, campaign, order)
Viant also has a report builder using which you can export a CSV of this data
Looking for more information? See Viant Reference.
Web
Mobile
Server
