# Viant Quick Start Guide 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](https://documentation.freshpaint.io/integrations/destinations/demand-side-platforms-dsps/viant/viant-reference "mention"). ## Destination Info * Supports [Track](https://documentation.freshpaint.io/reference/developer/freshpaint-sdk-reference#track) calls * Supports [HIPAA mode](https://documentation.freshpaint.io/readme/hipaa-mode) * Supports [Freshpaint Impression Pixel](https://documentation.freshpaint.io/integrations/impression-pixel) * Supports forwarding from the [Google Tag Manager Integration](https://documentation.freshpaint.io/integrations/google-tag-manager-integration) * Supports [Audience retargeting, lookalikes, and exclusions](https://documentation.freshpaint.io/audiences/audience-integrations/viant-audiences) * Refer to this destination as **viant** in the [Integrations object](https://documentation.freshpaint.io/reference/developer/freshpaint-sdk-reference#using-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. {% hint style="info" %} When no suffix is specified, all configured Advertiser IDs are selected for inclusion / exclusion. {% endhint %} * Connection Modes:

	Client-side	Server-side
Web	false	true
Mobile	false	true
Server	false	true

## 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 ](https://documentation.freshpaint.io/integrations/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.

3. Set the Advertiser ID in Freshpaint.

4. \[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

4. Enable the [impression pixel ](https://documentation.freshpaint.io/integrations/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.

{% hint style="info" %} 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. {% endhint %} 5. 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=&dest_id=&cke=1&$viant_impid=${ADELPHIC_CLICKID}`

### 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.

#### Reporting Viant provides conversion event reporting through a dedicated Healthcare Conversions report. Self-service DSP clients can subscribe to the Healthcare Conversions report on the Measurement tab of the Advertiser level. Viant will subscribe managed-service DSP clients.

## Further reading Looking for more information? See [viant-reference](https://documentation.freshpaint.io/integrations/destinations/demand-side-platforms-dsps/viant/viant-reference "mention").