> ## Documentation Index
> Fetch the complete documentation index at: https://data-foundation.rockerbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Reddit

> Learn how to set up Reddit integration with Rockerbox

## Overview

Rockerbox integrates with Reddit to track click and view-based touchpoints and ingest daily spend via API. View-based touchpoints are provided directly to Rockerbox by the Reddit team with no additional implementation required.

## Setup Process

1. Request API access from your Reddit representative (see API Access section below)
2. Once access is confirmed, authenticate your Reddit account(s) on the [Advertising Platforms](https://app.rockerbox.com/v3/data/marketing/advertising_platforms/connect) page. This allows Rockerbox to ingest daily spend
3. Append click tracking parameters to your landing page URLs (see Click Tracking below)
4. Contact [support@rockerbox.com](mailto:support@rockerbox.com) with the launch date and the [tier structure](https://help.rockerbox.com/article/obce43haen-1-hierarchy-mappings) you'd like applied. If you want view-based tracking, the team can help with setup
5. The day after launch, confirm tracking is applied on the [Advertising Platforms](https://app.rockerbox.com/v3/data/marketing/advertising_platforms/main) page

**Managed Service accounts:** If your Reddit instance is Managed Service (not self-serve), email [rockerbox@reddit.com](mailto:rockerbox@reddit.com) and Reddit will assist with adding tracking.

## Requesting API Access

Before authenticating in Rockerbox, you must have Reddit whitelist your account for API access. Send the following to your Reddit point of contact:

> We need Rockerbox, our marketing attribution platform, to access the Reddit API on our behalf in order to report on Reddit spend in their platform. Can you please whitelist our account:
>
> * username: \[your username]
> * email: \[your email]

**Important:** Do not connect your Reddit account in Rockerbox until Reddit confirms API access has been granted.

### Connecting Your Account

1. Go to **Data > Integrations**
2. Click **Connect New Account**
3. Find **Reddit** and click **Connect**
4. Authenticate through Reddit using your username and password
5. Verify the username shown is the correct account, then click **Allow**

## Click Tracking

These parameter values use macros and do not need to be manually replaced. Their values will be dynamically filled by the platform when the ad is served.

### Example Parameter String

```text wrap theme={null}
rd_campaignid={{CAMPAIGN_ID}}&rd_adgroupid={{ADGROUP_ID}}&rd_adid={{AD_ID}}&rd_maid={{ADVERTISING_ID}}&rd_adgroup={{ADGROUP_NAME}}&rd_ad={{AD_NAME}}
```

<Accordion title="Parameter Details">
  | Parameter       | Macro                | Description                      |
  | --------------- | -------------------- | -------------------------------- |
  | `rd_campaignid` | `{{CAMPAIGN_ID}}`    | Campaign ID (required)           |
  | `rd_adgroupid`  | `{{ADGROUP_ID}}`     | Ad group ID (required)           |
  | `rd_adid`       | `{{AD_ID}}`          | Ad ID (required)                 |
  | `rd_maid`       | `{{ADVERTISING_ID}}` | Mobile advertising ID (required) |
  | `rd_adgroup`    | `{{ADGROUP_NAME}}`   | Ad group name (required)         |
  | `rd_ad`         | `{{AD_NAME}}`        | Ad name (required)               |
</Accordion>

Append the parameters to your landing page URLs.

## View-Based Tracking

View-based touchpoints are provided directly to Rockerbox by the Reddit team. No additional implementation steps are required beyond standard setup.

### Requirements

* Minimum spend of **\$50,000 over 12 months** on Reddit advertising
* Contact your Reddit account representative to confirm eligibility

## Spend

Spend is ingested automatically via API after authentication. Spend data refreshes daily.

## Verification

After setup:

1. Confirm tracking is applied on the [Advertising Platforms](https://app.rockerbox.com/v3/data/marketing/advertising_platforms/main) page
2. Verify spend data appears in Rockerbox dashboard
3. Contact [support@rockerbox.com](mailto:support@rockerbox.com) for QA assistance