# Zeta Quick Start Guide

This is a guide to help you get started on sending your conversion events to Zeta via Freshpaint. If you've already completed set up and are looking for more information, see [zeta-reference](https://documentation.freshpaint.io/integrations/destinations/demand-side-platforms-dsps/zeta-conversions-api-early-access/zeta-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 forwarding from the [Google Tag Manager Integration](https://documentation.freshpaint.io/integrations/google-tag-manager-integration)
* Supports [Freshpaint Impression Pixel](https://documentation.freshpaint.io/integrations/impression-pixel)
* Refer to this destination as **Zeta** 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: **Zeta::123456.** You can retrieve this value from the Zeta 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:

<table><thead><tr><th width="200.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 Freshpaint Environment ID
2. Your Zeta Advertiser ID, Pixel ID, Site ID, and API Key
3. A Zeta Marketing Platform (ZMP) account mapped to your Freshpaint Environment ID (coordinated with your Zeta Account Manager)
4. \[If in HIPAA mode] Allowlist set up to allow Freshpaint to forward properties to Zeta for attribution
5. Impression pixel enabled to allow Freshpaint to do view-through conversion attribution

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

1. **Notify your Zeta Account Manager** before activating the integration. Provide them your Freshpaint Environment ID, which can be found in your Freshpaint dashboard under "Setup".
   1. Your Zeta Account Manager will create and map a ZMP account to your Environment ID. Wait for confirmation from your account team before proceeding.
2. **Make sure you have the appropriate access** in both Freshpaint and Zeta:
   1. Contact your Freshpaint Account Manager to request access to this destination. Once granted, we will help you step by step through the configuration process.
3. **Create** **events in Freshpaint to track your conversions**.
4. **Enter your Zeta credentials in Freshpaint**. You will need your Advertiser ID, Pixel ID, Site ID, and API Key from your Zeta DSP account.

<figure><img src="https://1666823438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MA7aDqsXMFbUsWVqonF%2Fuploads%2FXdDQnTzmWVov544Pa8Ev%2Fimage.png?alt=media&#x26;token=9db798f2-7c13-475d-95fc-1631b5328836" alt=""><figcaption></figcaption></figure>

5. **\[If in HIPAA mode]** It is highly recommended to set the Freshpaint allowlist for Zeta to allow Freshpaint to forward `$zeta_impid` and `$zeta_userid`. These properties enable Freshpaint and Zeta to perform attribution on your conversion events.

<figure><img src="https://1666823438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MA7aDqsXMFbUsWVqonF%2Fuploads%2FFgp5fjjzYUt7jfZhezw7%2Fimage.png?alt=media&#x26;token=8470e459-fad7-4463-8209-bd03e0c6aa13" alt=""><figcaption></figcaption></figure>

6. **Enable the impression pixel for Zeta.** This enables Freshpaint to do view-through attribution and report the conversion event to Zeta. We recommend enabling IP matching and cookie matching, and setting the Conversion Window to at least 30 days for the best results. Then copy the Pixel Configuration URL for the next step. Click Save once you have set your preferred configuration options and copied the URL.

<figure><img src="https://1666823438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MA7aDqsXMFbUsWVqonF%2Fuploads%2FGLsxDnMy8aiWgGfxKKAF%2Fimage.png?alt=media&#x26;token=8f35d325-b381-4613-881c-fd9d0c63134c" alt=""><figcaption></figcaption></figure>

7. **Configure your creatives in ZMP** to include the Freshpaint impression pixel URL copied in the previous step. The URL already contains the `$zeta_impid` and `$zeta_userid` macros — Zeta will substitute the real values automatically when the ad serves. 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>&$zeta_impid={adinstanceid}&$zeta_userid={userid}`

### Verify Your Setup

Once your integration is active and your creatives are running:

1. Verify in Freshpaint that the events are triggering and flowing through successfully to Zeta by using Freshpaint's [Liveview and Event Verification tools](https://documentation.freshpaint.io/admin-panel/investigate-testing-and-debugging).
2. Your Zeta account team will confirm when data is being received on their end, and will reach out if any additional data mapping is needed.