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

# Reddit Ads Postbacks

> Connect Reddit Ads via OAuth to automatically forward attributed conversions to Reddit Conversions API

<Warning>
  Conversion Postbacks are currently in **alpha**. Behavior and supported networks may change between releases.
</Warning>

<Info>
  **Who is this for?** Marketers running paid acquisition on Reddit Ads who want to feed conversion data back to the platform to improve campaign optimisation.
</Info>

Reddit Ads postbacks connect your Immutable game to the Reddit Conversions API v3. When a player clicks your Reddit Ads campaign, installs the game, and completes a [Conversion Goal](/docs/products/audience/conversion-goals), Immutable sends a server-to-server postback to Reddit automatically.

## What You Need

* The Immutable [Tracking Pixel](/docs/products/audience/tracking-pixel) or [Web SDK](/docs/products/audience/web-sdk) installed on your marketing site, so Reddit click IDs are captured. Without a click ID, Reddit requires a hashed email address to match conversions to users (see below).
* The [Unity SDK](/docs/products/audience/unity-sdk), [Web SDK](/docs/products/audience/web-sdk), or [REST API](/docs/products/audience/rest-api) sending events from your game
* At least one active [Conversion Goal](/docs/products/audience/conversion-goals) for the game
* A Reddit Ads account with at least one pixel in Reddit Ads Manager
* Admin access to the game in [Audience Hub](https://hub.immutable.com)

## Connect Reddit Ads

1. In [Audience Hub](https://hub.immutable.com), navigate to **Settings** then **Integrations** then **Reddit Ads**.
2. In the **Conversion Postbacks** section, click **Connect**.
3. A Reddit authorization popup opens. Sign in to your Reddit Ads account and grant the requested permissions.
4. Once authorized, Hub shows an account and pixel picker. If your Reddit Ads account has multiple pixels, select the one you want to send postbacks for.
5. Click **Connect**. Hub creates the postback configuration and the popup closes.

<Note>
  You can only have one Reddit Ads postback configuration per game. If you need to switch accounts or pixels, disconnect the existing configuration first, then reconnect with the new selection.
</Note>

## Event Mapping

Immutable maps Conversion Goal events to Reddit standard tracking types as follows:

| Goal event        | Reddit type                      |
| ----------------- | -------------------------------- |
| `purchase`        | `Purchase`                       |
| `wishlist_add`    | `AddToWishlist`                  |
| `wishlist_remove` | `Custom` named `wishlist_remove` |
| `email_acquired`  | `SignUp`                         |

For `purchase` conversions, Immutable forwards `value` and `currency` when both are present so Reddit can optimise for revenue (ROAS) rather than conversion count alone.

Reddit has no standard tracking type for `wishlist_remove`. It is forwarded as a `Custom` event with the name `wishlist_remove`.

## Identifier Requirements

Reddit requires at least one of the following to match a conversion to a user:

* **Click ID**: captured by the Tracking Pixel from a Reddit Ads campaign click
* **Hashed email**: collected by your game via the Unity SDK, Web SDK, or REST API and forwarded by Immutable (SHA-256 hashed)

If neither is present on an attributed event, Immutable will not forward the conversion to Reddit. Make sure your Tracking Pixel is correctly installed on any pages you're running Reddit Ads campaigns against, and that your game collects player email where you need email-based matching.

## Test Events

If you want to route test conversions to Reddit's test environment rather than live reporting, open the postback config and set a **Test ID** from Reddit Ads Manager. Test events are only routed this way when the SDK or Pixel sends them with `test: true`. Normal production conversions are never affected.

## Verify Delivery

Once a real attributed conversion arrives (a player who clicked your Reddit Ads campaign and then matched an active Goal), it appears in the **Delivery logs** section on the Reddit Ads integration page. You can also check **Reddit Ads Manager** under Events Manager on your pixel's activity page.

For a description of log columns and status values, see [Monitoring Postback Delivery](/docs/products/audience/conversion-postbacks#monitoring-postback-delivery).

## Reconnecting

If your Reddit authorization expires or is revoked, Hub shows a credential warning on the postback config. Open the config menu and click **Reconnect** to re-authorize without losing your existing configuration.

***

## FAQ

<AccordionGroup>
  <Accordion title="Postbacks aren't showing in the delivery log. What should I check?">
    Check the following:

    * Is the postback config **enabled**?
    * Is there at least one active [Conversion Goal](/docs/products/audience/conversion-goals) matching the events you're sending?
    * Is the Tracking Pixel capturing Reddit click IDs on your marketing site?
    * Is your game sending the expected events? Without a click ID or hashed email, Reddit postbacks cannot be sent.
  </Accordion>

  <Accordion title="I previously configured Reddit Ads with a Conversion Access Token. What happens to that?">
    Existing token-based configurations keep working and continue forwarding conversions. To move to the OAuth flow, delete the existing configuration and click **Connect** to set it up again.
  </Accordion>
</AccordionGroup>

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Conversion Goals" icon="bullseye-arrow" href="/docs/products/audience/conversion-goals">
    Define which player actions count as a conversion and control what triggers postbacks
  </Card>

  <Card title="Tracking Pixel" icon="crosshairs" href="/docs/products/audience/tracking-pixel">
    Make sure Reddit click IDs are being captured on your marketing site
  </Card>

  <Card title="Conversion Postbacks" icon="arrow-right-arrow-left" href="/docs/products/audience/conversion-postbacks">
    Overview of all supported networks and event mapping
  </Card>

  <Card title="Attribution" icon="route" href="/docs/products/audience/attribution">
    How tracking data powers player attribution and Hub reports
  </Card>
</CardGroup>