> ## Documentation Index
> Fetch the complete documentation index at: https://docs.northbeam.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Reddit Ads Setup

> Connect your Reddit Ads account and add the Northbeam parameter to each ad for click-based attribution.

When you're done, Northbeam shows your Reddit Ads spend, platform-reported clicks, and click-based attribution on the same campaigns, ad groups, and ads.

<span id="before-you-start" style={{ display: "block", scrollMarginTop: "7rem" }} />

<Info>
  **Before you start**, make sure you have:

  * Access to the correct Reddit Ads account
  * Permission to authorize the Reddit Ads connection in Northbeam
  * Permission to edit ads and destination URLs in **Reddit Ads Manager**
  * Access to the correct Northbeam dashboard
</Info>

<span id="setup" style={{ display: "block", scrollMarginTop: "7rem" }} />

<CardGroup cols={3}>
  <Card title="1. Connect the account" icon="plug" href="#connect-your-reddit-ads-account">
    Sync spend and platform-reported clicks from Reddit Ads.
  </Card>

  <Card title="2. Add Northbeam parameters" icon="link" href="#add-northbeam-parameters-to-your-ads">
    Add `nbt` to the Destination URL of every ad.
  </Card>

  <Card title="3. Confirm tracking" icon="circle-check" href="#confirm-tracking">
    Check the connection, the parameter, and incoming data.
  </Card>
</CardGroup>

<Steps titleSize="h2">
  <Step title="Connect your Reddit Ads account">
    <span id="step-1-connect-your-reddit-ads-account" style={{ display: "block", scrollMarginTop: "7rem" }} />

    1. Open [Connections](https://dashboard.northbeam.io/settings/connections) and find **Reddit Ads**. If you're still in onboarding, go to [**Integrations and UTMs > Reddit Ads**](https://dashboard.northbeam.io/onboarding?step=configure-platforms) instead.
    2. Click **Connect** on the Reddit Ads card.
    3. Sign in to Reddit Ads if prompted, approve the requested permissions, and select the correct ad account if asked.
    4. Back in Northbeam, confirm the correct account is linked.

    <Frame caption="Settings > Connections > Reddit Ads">
      <img src="https://mintcdn.com/northbeam/2WFDmMEgiT5tNzbL/images/readme/37c91641-reddit-settings-connections.png?fit=max&auto=format&n=2WFDmMEgiT5tNzbL&q=85&s=9790429a2ccbb06cc53d0839593b6ab1" alt="Reddit Ads integration card on the Connections page" style={{ maxWidth: "560px", maxHeight: "440px", width: "auto", height: "auto", margin: "0 auto" }} width="1919" height="797" data-path="images/readme/37c91641-reddit-settings-connections.png" />
    </Frame>

    <AccordionGroup>
      <Accordion title="See screenshots">
        <Frame caption="Onboarding > Integrations and UTMs > Reddit Ads">
          <img src="https://mintcdn.com/northbeam/2WFDmMEgiT5tNzbL/images/readme/b58c170e-reddit-onboarding-integrations.png?fit=max&auto=format&n=2WFDmMEgiT5tNzbL&q=85&s=1084d8eb976e2f0d105ff0843f2b25ed" alt="Reddit Ads integration card in the Northbeam onboarding flow" style={{ maxWidth: "560px", maxHeight: "440px", width: "auto", height: "auto", margin: "0 auto" }} width="1918" height="677" data-path="images/readme/b58c170e-reddit-onboarding-integrations.png" />
        </Frame>
      </Accordion>
    </AccordionGroup>

    The connection pulls Reddit Ads spend, platform-reported clicks, and the campaign, ad group, and ad identifiers Northbeam uses for reconciliation and attribution.

    **If you skip this step:** Reddit Ads data doesn't appear in Northbeam.
  </Step>

  <Step title="Add Northbeam parameters to your ads">
    <span id="step-2-add-the-northbeam-tracking-parameter" style={{ display: "block", scrollMarginTop: "7rem" }} />

    <span id="add-the-parameter-to-an-ad" style={{ display: "block", scrollMarginTop: "7rem" }} />

    Add this parameter to the **Destination URL** of every Reddit ad:

    ```text theme={null}
    ?nbt=nb:reddit_ads:reddit_ads:{{CAMPAIGN_ID}}:{{ADGROUP_ID}}:{{AD_ID}}
    ```

    Reddit fills in the campaign, ad group, and ad IDs when the ad is served.

    1. Sign in to [Reddit Ads Manager](https://ads.reddit.com/).
    2. Open the campaign, then the ad group, then the individual ad.
    3. Find the **Destination URL** field and add the parameter.
    4. Review the destination URL and click **Save**.

    <Frame caption="Reddit Ads Manager > Ad > Destination URL">
      <img src="https://mintcdn.com/northbeam/2WFDmMEgiT5tNzbL/images/readme/f97a7750-reddit-destination-url.png?fit=max&auto=format&n=2WFDmMEgiT5tNzbL&q=85&s=20f1fa353e0170483cd93cefd3798b41" alt="Destination URL field in Reddit Ads Manager" style={{ maxWidth: "560px", maxHeight: "440px", width: "auto", height: "auto", margin: "0 auto" }} width="1903" height="913" data-path="images/readme/f97a7750-reddit-destination-url.png" />
    </Frame>

    <span id="ad-level-requirement" style={{ display: "block", scrollMarginTop: "7rem" }} />

    <Info>
      **Add it to every individual ad.** Adding it only at the campaign or ad group level isn't enough for Reddit Ads tracking.
    </Info>

    <span id="use-the-correct-url-separator" style={{ display: "block", scrollMarginTop: "7rem" }} />

    **Use the right separator.** If the destination URL has no query parameters yet, start with `?`:

    ```text theme={null}
    https://www.example.com/product?nbt=nb:reddit_ads:reddit_ads:{{CAMPAIGN_ID}}:{{ADGROUP_ID}}:{{AD_ID}}
    ```

    If it already has a `?` and other parameters, join with `&`:

    ```text theme={null}
    https://www.example.com/product?utm_source=reddit&utm_medium=paid&nbt=nb:reddit_ads:reddit_ads:{{CAMPAIGN_ID}}:{{ADGROUP_ID}}:{{AD_ID}}
    ```

    <span id="copy-the-parameter-exactly" style={{ display: "block", scrollMarginTop: "7rem" }} />

    **Copy the parameter exactly.** A missing colon, underscore, brace, or ID can stop Northbeam from matching visits correctly.

    <Warning>
      Reddit warns that editing a live ad's creative may reset its votes, comments, and awards. Review the warning in Reddit Ads Manager before you save changes to a live ad. When you can, add the parameter before the ad launches.
    </Warning>

    **If you skip this step:** visits and attributed results may be missing or assigned to the wrong campaign, ad group, or ad.
  </Step>

  <Step title="Confirm tracking">
    <span id="step-3-verify-the-integration" style={{ display: "block", scrollMarginTop: "7rem" }} />

    Check these in order:

    1. In **Settings > Connections**, the Reddit Ads connection shows no authorization error, and the correct account is linked.
    2. Every active Reddit ad has the exact Northbeam parameter.
    3. Opening an ad's preview or destination URL loads the landing page, and the final URL still has `nbt` after any redirects.
    4. Reddit Ads spend and platform-reported clicks start showing up in Northbeam.
    5. Reddit visits land on the expected campaign, ad group, and ad.

    <Frame caption="A connected Reddit Ads account on the Connections page">
      <img src="https://mintcdn.com/northbeam/2WFDmMEgiT5tNzbL/images/readme/677df82f-reddit-connected-account.png?fit=max&auto=format&n=2WFDmMEgiT5tNzbL&q=85&s=0e1f5b42ce38f77e79096fd9cbae8823" alt="Connected Reddit Ads account on the Connections page" style={{ maxWidth: "560px", maxHeight: "440px", width: "auto", height: "auto", margin: "0 auto" }} width="1282" height="469" data-path="images/readme/677df82f-reddit-connected-account.png" />
    </Frame>

    When you first connect, Northbeam can backfill up to one year of Reddit Ads spend. Attribution for that history still depends on whether the ads had valid tracking parameters at the time.

    For a full check:

    * **Parameters captured:** follow [Checking UTM tracking](/docs/checking-utm-tracking) to confirm the Northbeam parameter reaches your landing pages.
    * **Connection syncing:** follow [Checking platform connections](/docs/checking-api-connections) to confirm the account shows as connected and data is arriving.

    If a check fails, see [Troubleshooting Northbeam data](/docs/troubleshooting-tracking-issues).
  </Step>
</Steps>

## Supported attribution models

Reddit Ads supports these Northbeam attribution models:

* Clicks Only
* Last Click
* First Click
* Linear

Clicks + Modeled Views and Clicks + Deterministic Views aren't currently supported for Reddit Ads.

## Need help?

<CardGroup cols={2}>
  <Card title="Reddit Ads FAQ" icon="circle-question" href="/docs/channels/reddit/faq">
    Attribution, backfill, reporting differences, and missing data.
  </Card>

  <Card title="Troubleshooting Northbeam data" icon="wrench" href="/docs/troubleshooting-tracking-issues">
    Start here if a check above fails.
  </Card>
</CardGroup>
