> For the complete documentation index, see [llms.txt](https://documentation.freshpaint.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.freshpaint.io/integrations/destinations/direct-response-ads/admedia-early-access/admedia-quick-start-guide.md).

# AdMedia Quick Start Guide

{% hint style="warning" %}
The AdMedia destination is currently in Early Access. Please contact <support@freshpaint.io> for more information about this integration.
{% endhint %}

## Destination Info

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

<table><thead><tr><th 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

This guide enables you to fully enable the AdMedia destination for your site. This guide assumes you have the Freshpaint snippet installed on your site — if you do not, please follow [this guide](https://documentation.freshpaint.io/readme/guides/quickstart/installing-freshpaint).

### Enable the AdMedia Integration

1. Navigate to the [Freshpaint Destinations page](https://app.freshpaint.io/destinations/catalog).
2. Search for the **AdMedia** destination.
3. Select **Configure**.
4. Enter the Advertiser ID provided by AdMedia.
5. Customers that use HIPAA mode should then configure the required and recommended properties. You can find [all properties that the AdMedia integration supports here.](https://documentation.freshpaint.io/integrations/destinations/direct-response-ads/miscrosoft-ads-conversions-api-early-access/miscrosoft-ads-conversions-api-reference)
6. Select Save.
7. Enable the AdMedia integration.

<figure><img src="/files/JD16tnHQFSoGTaZ1yfZl" alt="Freshpaint AdMedia integration configuration page, with Advertiser ID field selected. "><figcaption></figcaption></figure>

### If you are a HIPAA account, you will need to add event properties to the allowlist. If you are not a HIPAA account, you can skip this step.

1. Go to the **AdMedia** configuration page in Freshpaint.
2. Click "Configure" next to "Required Properties" and "Recommended Properties".
3. If you're using the Freshpaint/AdMedia integration for ad attribution purposes, we recommend you send the `$click_id` property. This property is required in order to see ad attribution data in AdMedia. You can do so by checking the box in the popup.
4. Next, add any other properties you'd like to send to AdMedia to the Advanced: HIPAA Allow List.

Once you've followed these steps, you're ready to start sending events to AdMedia.

<figure><img src="/files/5jFCrfP2ZQjUOoXZpChY" alt="AdMedia integration page with recommended properties selected"><figcaption></figcaption></figure>

## Confirm and Validate Events

### Confirm and Validate Conversions in Freshpaint

1. Navigate to your site and visit a page that should trigger your event..
2. Trigger the event.
3. Navigate to the [Event Verification tool](https://app.freshpaint.io/event-verification).
4. Select **AdMedia** and verify your event went through.
   1. This can take up to 90 seconds.
5. Verify the event is marked as `OK` or resolve any missing property issues.

<figure><img src="/files/W7GPrwnJvhenic4ACao4" alt="AdMedia Event Verification example with OK status"><figcaption></figcaption></figure>