Viant Quick Start Guide
Send advertising conversion events directly to Viant's DSP.
Last updated
Was this helpful?
Send advertising conversion events directly to Viant's DSP.
Last updated
Was this helpful?
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 calls
Supports
Supports
Supports forwarding from the
Refer to this destination as viant in the
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.
Connection Modes:
Web
Mobile
Server
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
Advertising media configured in your Viant account to specify viant_clid
and viant_impid
for click through and view through conversions respectively.
Make sure you have the appropriate access in both Freshpaint and Viant:
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.
Create your conversion funnel, and create events in Freshpaint to track your conversions.
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.
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}
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.
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.
Navigate to page where ad is displayed, click through into your funnel (follow user steps that lead to your conversion event)
Verify in Freshpaint that the conversions are triggering in Live View
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)
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.
enabled to allow Freshpaint to do view through conversion attribution
Enable the 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.