# Reddit Ads Quick Start Guide

## Destination Info

* Supports [Track](https://documentation.freshpaint.io/developer/freshpaint-sdk-reference#track) calls
* Supports [HIPAA mode](https://documentation.freshpaint.io/hipaa-mode)
* Refer to this destination as **reddit-ads** in the [Integrations object](https://documentation.freshpaint.io/reference/developer/freshpaint-sdk-reference#using-the-integrations-object)
  * If you've configured multiple Account IDs, you can choose a specific one by suffixing the Account ID, such as: **`reddit-ads::0123456789012345`.** You can retrieve this value from the Reddit Ads configuration page for the Account ID of interest.  
* 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

This guide enables you to fully enable the Reddit Ads destination for your site.  For simplicity the event used for demonstration purposes is the generic `Page View` event.  For more complex events see[ our additional documentation](https://documentation.freshpaint.io/readme/setting-up-your-events).  Additionally 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).

1. [Find/create your account ID](#account-id)
2. [Give Freshpaint permission to post conversion events on your behalf](#log-into-reddit)
3. [Enable the Freshpaint Reddit Ads destination](https://documentation.freshpaint.io/readme/setting-up-your-destinations/enabling-and-disabling-a-destination)
   * If in HIPAA mode enable the required fields
4. [Enable Reddit Ads destination for the appropriate events](#enable-reddit-a-ds-events)
5. [Confirm and validate events](#confirm-and-validate-conversions-in-linkedin)

### Account ID

To configure your Reddit Ads destination, you'll first need to locate your Account ID. This may also be known as your Pixel ID and it may start with the prefix "t2\_".

1. [Sign in to Reddit Ads](https://ads.reddit.com/)
2. Navigate to the Events Manager page using the menu icon on the top left corner.
3. Copy the Pixel ID value.

<figure><img src="https://1666823438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MA7aDqsXMFbUsWVqonF%2Fuploads%2FX1HAyywcsBuqBFHMLkNy%2FScreenshot%202024-04-18%20at%203.18.04%E2%80%AFPM.jpeg?alt=media&#x26;token=cf08f26c-5dc6-4359-bce6-3ffe7b9d9146" alt=""><figcaption><p>Reddit Ads Event Manager Page</p></figcaption></figure>

### Allow Freshpaint to send conversions on your behalf

In order to send conversion events, Freshpaint needs your Reddit conversions access token.

Generate the conversions access token by following the steps in the [Reddit documentation](https://business.reddithelp.com/s/article/conversion-access-token). Copy this token into a secure location.&#x20;

### Enable the Reddit Ads Destination

To enable the Reddit Ads destination you simply need to enable and configure it just as you would for any other destination.

1. Navigate to Freshpaint [Apps](https://app.freshpaint.io/destinations/apps).
2. Search for the `Reddit Ads` advertising destination.
3. Enable `Reddit Ads.`
4. Paste in your Account ID and Conversions access token in integration settings.
5. Optional: Customers that use HIPAA mode should then configure the `required properties` and enable `$rdt_cid.`

<figure><img src="https://1666823438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MA7aDqsXMFbUsWVqonF%2Fuploads%2F4G0xb0YexSNHxP7esiXF%2FScreenshot%202024-04-18%20at%203.29.13%E2%80%AFPM.png?alt=media&#x26;token=be6b9b2c-3c4a-45e7-aea1-2f4af0eb248a" alt="" width="375"><figcaption><p>Reddit Ads Required Properties on Freshpaint App</p></figcaption></figure>

### Enable Reddit Ads Events

1. Navigate to the [Event Library](https://app.freshpaint.io/events/schema).
2. Select/create the event(s) you want to send to `Reddit Ads`.
3. At the bottom of the event page enable `Reddit Ads.`

<figure><img src="https://1666823438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MA7aDqsXMFbUsWVqonF%2Fuploads%2FYg55jMDK7T2zDx7EJjv4%2FScreenshot%202024-04-18%20at%203.35.28%E2%80%AFPM.png?alt=media&#x26;token=04b56c08-4427-4b68-bd96-16ad03ad7263" alt=""><figcaption><p>Event Destinations Settings on the Event Library</p></figcaption></figure>

### Confirm and Validate Conversions in Reddit

1. Navigate to your site and visit a page that should trigger your event
2. Add a query parameter called `rdt_cid` to the URL (Example: `https://www.example.com/?rdt_cid=TEST`).
3. Trigger your event.
4. Navigate to the [Event Verification tool](https://app.freshpaint.io/event-verification).
5. Select `Reddit Ads` and verify your event went through.
   * This can take up to 90 seconds.
6. Verify the event is marked as `OK` or resolve missing property issues.
7. Confirm receipt of event in Reddit Ads events manager.

<figure><img src="https://1666823438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MA7aDqsXMFbUsWVqonF%2Fuploads%2FtAQpJHRshnjF4bwemjDG%2FScreenshot%202024-04-03%20at%201.33.28%E2%80%AFPM.png?alt=media&#x26;token=781cbce6-554f-41e1-9df9-b0cc7537cdc3" alt=""><figcaption><p>Example of an event being sent successfully</p></figcaption></figure>

<figure><img src="https://1666823438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MA7aDqsXMFbUsWVqonF%2Fuploads%2FU2P4lnTyKi4zVSH58KrR%2FScreenshot%202024-04-18%20at%205.29.09%E2%80%AFPM.png?alt=media&#x26;token=6cf14b0f-b5b0-4120-91d9-e69ebb35877d" alt=""><figcaption><p>Reddit Events Manager can be used to verify receipt of the event</p></figcaption></figure>

## Required Properties

See [here](https://documentation.freshpaint.io/integrations/destinations/direct-response-ads/reddit-ads-reference#track-events) for a complete list of all available properties.

In order for an event to be sent to Reddit, it must have either a click ID (`$rdt_cid`), an email (`email`), or all of the properties `$ip` / `$ip_address`, `$user_agent`, `$screen_width`, and `$screen_height`.

{% hint style="info" %}
The following event properties are **required** in order to attribute events to specific ads, and if in HIPAA mode, must be selected in the Required Properties Allow List.
{% endhint %}

<table data-header-hidden data-full-width="true"><thead><tr><th width="165"></th><th width="164"></th><th width="103"></th><th></th><th></th></tr></thead><tbody><tr><td><strong>Freshpaint property</strong></td><td><strong>Reddit Ads</strong><br><strong>parameter</strong></td><td><strong>Type</strong></td><td><strong>Requirement</strong></td><td><strong>Description</strong></td></tr><tr><td><code>$rdt_cid</code></td><td><code>click_id</code></td><td>string</td><td>Required</td><td>A query parameter that connects a page view or conversion event to a specific ad, which Freshpaint captures as <code>$rdt_cid</code>.<br><br>If not provided, the event will still be attempted to be sent to Reddit if <code>email</code> is allowlisted and present, or if all of <code>$ip</code> / <code>$ip_address</code>, <code>$user_agent</code>, <code>$screen_width</code>, and <code>$screen_height</code> are allowlisted and present.</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/direct-response-ads/reddit-ads/reddit-ads-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.