# Basis Reference

This is a reference document for the Basis destination. For information on how to set up this integration, see the [Basis Quick Start Guide](/integrations/destinations/demand-side-platforms-dsps/basis/basis-quick-start-guide.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>

## Click Through Tracking

In order for Freshpaint to be able to automatically capture the click ID auto-generated by the Basis advertisement, [cookieless conversion attribution needs to be enabled](https://help.basis.com/docs/Cookieless_Conversions/Cookieless_Conversions_Guide.htm).&#x20;

Basis will append a `cntr_auctionId` parameter to the landing page URL query string, which works similar to click id's from other advertising platforms. Freshpaint when installed on a page will look for this click id and automatically set the `$cntr_auctionId` event property with the click id.

Assuming you have followed the [Basis Quick Start Guide](/integrations/destinations/demand-side-platforms-dsps/basis/basis-quick-start-guide.md) to set up your Basis destination, you can verify that click through tracking is working by looking for an event in event verification that contains the `$cntr_auctionId` field.

<div align="center" data-full-width="true"><figure><img src="/files/X5LhNAIrCfPHWvV0SdOo" alt=""><figcaption><p>Event Verification</p></figcaption></figure></div>

<div data-full-width="true"><figure><img src="/files/LtepHb8rj16UDJu79VvJ" alt=""><figcaption><p>Click ID being captured</p></figcaption></figure></div>

## View Through Tracking

Freshpaint supports view through tracking by capturing the `cntr_auctionId` passed in by Basis using the Freshpaint Impression Pixel. Assuming you have followed the [Basis Quick Start Guide](/integrations/destinations/demand-side-platforms-dsps/basis/basis-quick-start-guide.md) to set up your Basis destination, you can verify that view through tracking is working by looking for an event in event verification that contains the `$cntr_auctionId` field, similar to how you can verify Click Through Conversion.

You can also look for a transformation that shows that the event data was enriched by the Freshpaint Impression Pixel.

<div data-full-width="true"><figure><img src="/files/euy7R8qDhZDo0ojXGOwu" alt=""><figcaption><p>Transformation applying the Impression Pixel captured impression to an event</p></figcaption></figure></div>

## Relevant Properties

<table data-header-hidden data-full-width="true"><thead><tr><th width="224"></th><th width="269"></th><th width="86"></th><th width="113"></th><th align="center"></th></tr></thead><tbody><tr><td><strong>Freshpaint Property</strong></td><td><strong>Basis Parameter</strong></td><td><strong>Type</strong></td><td><strong>Required?</strong></td><td align="center"><strong>Description</strong></td></tr><tr><td><code>$cntr_auctionId</code></td><td><code>cntr_postbackAuctionId</code></td><td>string</td><td>Required</td><td align="center"><code>cntr_auctionId</code> is  appended to the landing page URL by Basis. <strong>Freshpaint will automatically capture cntr_auctionId for events from your website</strong>. For events from other sources you would need to provide <code>$cntr_auctionId</code> as an event property.<br><br>If the Freshpaint Impression pixel is in use, <code>cntr_auctionId</code> is added automatically as a transformation to the appropriate events if a match is found.</td></tr><tr><td><code>&#x3C;custom_property></code></td><td><code>&#x3C;custom_property></code></td><td>string</td><td>Optional</td><td align="center">Any additional / custom properties on the event and allowed by the HIPAA allow list will be passed to Basis</td></tr></tbody></table>


---

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