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.
What You Need
- The Immutable Tracking Pixel or 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, Web SDK, or REST API sending events from your game
- At least one active Conversion Goal for the game
- Admin access to the Reddit Ads account for this game
- Admin access to the game in Audience Hub
Step 1: Get Your Reddit Ads Credentials
Reddit Ads uses a Conversion Access Token (CAT), a long-lived token designed for server-side API use. You’ll need two things from Reddit Ads Manager:- Conversion Access Token: In Reddit Ads Manager, go to Events Manager, select your pixel, then go to Conversions API and click Generate Conversion Access Token. Any administrator for the ad account can generate this.
- Pixel ID: Shown in Reddit Ads Manager next to your pixel name (format:
a2_xxxxxxxx).
The Conversion Access Token doesn’t expire and can be regenerated at any time from Ads Manager without affecting your existing integration until you update it in Hub.
Step 2: Configure in Hub
- In Audience Hub, navigate to Settings then Integrations then Reddit Ads.
- In the Conversion Postbacks section, click + Add postback.
- Enter your Conversion access token and Pixel ID.
- (Optional) Enter a Test ID from Reddit Ads Manager. Hub uses this ID when verifying credentials on save, and routes any events marked
test: trueby the SDK through your test pixel instead of production. Normal events are never affected. - Click Save. Hub validates your credentials against the Reddit Ads API before saving.
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 |
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)
Rotating Credentials
If you generate a new Conversion Access Token in Reddit Ads Manager (for example, if the previous token was compromised), update it in Hub:- Open the postback config menu and click Edit.
- Expand Rotate credentials.
- Enter your new token and click Save.
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.FAQ
My credentials were rejected on save. What went wrong?
My credentials were rejected on save. What went wrong?
Hub calls the Reddit Ads API with a synthetic test event to validate your credentials. Common causes:
- The Pixel ID format should be
a2_xxxxxxxx. Check for leading or trailing spaces. - The token was generated from the wrong ad account.
- For both fields: verify the values are copied without truncation.
Postbacks aren't showing in the delivery log. What should I check?
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 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.
Next Steps
Conversion Goals
Define which player actions count as a conversion and control what triggers postbacks
Tracking Pixel
Make sure Reddit click IDs are being captured on your marketing site
Conversion Postbacks
Overview of all supported networks and event mapping
Attribution
How tracking data powers player attribution and Hub reports