# Basis Quick Start Guide

This is a guide to help you get started on sending your conversion events to Basis via Freshpaint. If you've already completed set up and are looking for more information, see [Basis Reference](/integrations/destinations/demand-side-platforms-dsps/basis/basis-reference.md).

## Destination Info

* Supports [Track](/reference/developer/freshpaint-sdk-reference.md#track) calls
* Supports [HIPAA mode](/readme/hipaa-mode.md)
* Supports [Freshpaint Impression Pixel](/integrations/impression-pixel.md)
* Supports forwarding from the [Google Tag Manager Integration](/integrations/google-tag-manager-integration.md)
* Refer to this destination as **Basis** in the [Integrations object](/reference/developer/freshpaint-sdk-reference.md#using-the-integrations-object)
  * If you've configured multiple Pixel IDs, you can choose a specific one by suffixing the Pixel ID, such as: **Basis::123456.** You can retrieve this value from Basis configuration page for the Pixel ID of interest.
* Connection Modes:

<table><thead><tr><th width="249.33333333333331" align="right"> </th><th data-type="checkbox">Client-side</th><th data-type="checkbox">Server-side</th></tr></thead><tbody><tr><td align="right">Web</td><td>false</td><td>true</td></tr><tr><td align="right">Mobile</td><td>false</td><td>true</td></tr><tr><td align="right">Server</td><td>false</td><td>true</td></tr></tbody></table>

## Getting Started

### What you'll need

1. Your Universal Pixel ID from Basis
   1. Select the appropriate Brand
   2. Navigate to the Universal Pixel screen
   3. Either create a new pixel, or if one already exists, click on Action > Get Tags
   4. Ensure that the `Enable cookieless conversion` checkbox is checked.
   5. Copy your Universal Pixel ID from the line `cntrUpTag.track('cntrData', '<universal-pixel-id>');`
2. Universal ID configured in Freshpaint
3. \[If in HIPAA mode] Allowlist setup to forward the `$cntr_auctionId` prop to Basis
4. Freshpaint[ Impression Pixel ](https://documentation.freshpaint.io/integrations/impression-pixel)enabled
5. Conversion tracking enabled in Basis
   1. Add (or identify an existing) relevant conversion under the appropriate Brand in Basis
   2. Ensure this conversion is added to the appropriate Universal Pixel as a rule set in Basis
   3. On the campaign, ensure conversion tracking is set to ON and the conversion is being Tracked
6. Freshpaint[ Impression Pixel](https://documentation.freshpaint.io/integrations/impression-pixel) URL added to your creatives in Basis

### To set up Basis with Freshpaint, follow these steps:

1. Make sure you have the appropriate access in both Freshpaint and Basis:
   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. Set up your Universal Pixel, and copy your Universal Pixel ID

<figure><img src="/files/UFZZnCz1OKnceJd36MSa" alt=""><figcaption><p>Select your Brand</p></figcaption></figure>

<figure><img src="/files/0gEAN2veBPn0k7r90LXQ" alt=""><figcaption><p>Get Tags for the relevant Universal Pixel associated to the Brand</p></figcaption></figure>

<figure><img src="/files/u4iKFZxQ8s0jElXS6se5" alt=""><figcaption><p>Ensure cookieless conversion is enabled, and copy your Universal Pixel ID</p></figcaption></figure>

3. Configure the Universal Pixel ID you copied in step 1 in Freshpaint

<figure><img src="/files/soTMwBvvgq1xxmFcdR17" alt="" width="563"><figcaption><p>Set your Universal Pixel ID in Freshpaint</p></figcaption></figure>

4. Allowlist the `$cntr_auctionId` property. This property is required to support conversion reporting to Basis.

<figure><img src="/files/vQyT3I2aUCREeZqQxPRc" alt="" width="563"><figcaption><p>Basis Allowlist set up in Freshpaint</p></figcaption></figure>

5. Enable the [Freshpaint Impression Pixel](https://documentation.freshpaint.io/integrations/impression-pixel). This enables Freshpaint to do view through attribution within Freshpaint and report the conversion event to Basis. 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 8. Click `Save` once you have set your preferred configuration options and copied the url.

<figure><img src="/files/90MvozL0GLLZcUb84hVV" alt="" width="563"><figcaption><p>Impression Pixel set up in Freshpaint</p></figcaption></figure>

{% hint style="info" %}
Configuring the impression pixel does not require sharing an IP address or Cookie with Basis. 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 Basis.
{% endhint %}

6. Enable Conversion Tracking in Basis

<figure><img src="/files/QdcedNFoivz0qjEa95L4" alt=""><figcaption><p>Create or validate conversion in Basis</p></figcaption></figure>

<figure><img src="/files/wxx0lTYAdOUrNV4IYoLe" alt=""><figcaption><p>Add Conversion to the Universal Pixel as a rule set</p></figcaption></figure>

<figure><img src="/files/30HNRDV4iumkSfN4cHkv" alt=""><figcaption><p>Enable Track Conversions for Campaign in Basis</p></figcaption></figure>

7. Add Freshpaint Impression Pixel URL to your ads. **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&$cntr_auctionId={auctionId}`

<div data-full-width="true"><figure><img src="/files/JwWOoMdLFHBHEuKEaZ35" alt=""><figcaption><p>Set Impression Pixel URL on the relevant ads in Basis</p></figcaption></figure></div>

### To send an event to Basis, you'll need to enable the destination for the event:

If you'd like to send an autotrack event from your event library to Basis, navigate to your Freshpaint event definition and toggle the destination on to enable the event to be sent to Basis.

If you've configured multiple Pixel IDs, you'll need to toggle each pixel individually for each Freshpaint event.

If you're using Google Tag Manager to send data to Basis, you'd simply create a tag with the Freshpaint tag template in Google Tag Manager and select the tag type "Basis". If you have multiple Pixel IDs enabled for Basis, you'll need to specify which ID(s) you'd like to enable the event for in the event tag.

### Set up a test campaign in Basis

1. Set up a test campaign that targets a small audiences and set a low budget ($10-50)
2. Attach a creative that has the Frespaint Impression Pixel
3. Verify impressions and clicks are flowing into Freshpaint correctly by working with your Customer Success Engineer
4. Verify in Freshpaint that the events triggering and flowing through to successfully to Basis by using Freshpaint's [Liveview and Event Verification tools](https://documentation.freshpaint.io/admin-panel/investigate-testing-and-debugging)

### Confirm and Validate Conversions in Basis <a href="#confirm-and-validate-conversions-in-thetradedesk" id="confirm-and-validate-conversions-in-thetradedesk"></a>

Congratulations! Once you have confirmed conversions in Basis, you have finished setting up this integration.&#x20;

Looking for more information? See [Basis Reference](/integrations/destinations/demand-side-platforms-dsps/basis/basis-reference.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.freshpaint.io/integrations/destinations/demand-side-platforms-dsps/basis/basis-quick-start-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
