Connect Reddit Ads

Connect one SupremeTracking Property to a Reddit Pixel and Reddit Conversions API (CAPI) v3. With Browser + Server delivery, the browser Pixel and the Node's server request carry the same conversion ID so Reddit can deduplicate the two copies.

Reddit Ads is currently a limited-rollout integration. This guide applies when Reddit Ads appears in the Console catalog with an installable release. A PRIVATE BETA, COMING SOON, or UPDATE NODE badge means that access, a published release, or a compatible Node is still required. The current module implementation is version 1.0.0; package publication and live Reddit delivery are separate release gates.

Prerequisites

Before you start, have:

• A Property in the Console for the website you want to track.
• The SupremeTracking Loader installed on that website and a mapped canonical event reaching the Node.
• A Node version accepted by the Reddit module release. Use Node 3.4.4 or newer when verifying browser/server deduplication; earlier Loader behavior cannot prove the shared conversion-ID path for every browser producer.
• Access to the Reddit ad account and its Events Manager.
• The Reddit Pixel ID for the data source.
• A Reddit Conversion Access Token. Reddit does not let you retrieve this token after it is created, so store it securely before leaving Reddit.
• An optional Test ID from Reddit Events Manager for Event Testing.

The Pixel ID is a browser-safe identifier used by the Pixel and CAPI endpoint. The Conversion Access Token is a secret used only by the Node for CAPI requests. Do not place the token in GTM, website code, screenshots, or public support tickets.

Install the Reddit module

Installation adds module code to this Node. It does not create a Property connection.

1. Open Integrations in the Console.
2. Select Manage Modules, then Install module.
3. Find Reddit Ads under destinations.
4. Select Install Module and confirm the installation.
5. Return to Manage Modules and confirm that Reddit Ads shows Installed with a version.

If the card says PRIVATE BETA, your account does not currently have the required beta access. If it says UPDATE NODE, update the Node to the minimum version shown by the catalog before installing. A catalog entry alone does not prove that module code is installed on this Node.

Create the Property connection

1. Open the Connections tab in Integrations.
2. Select New connection.
3. Choose the target Property.
4. Choose Reddit Ads as the Module.
5. Select Browser and Server to produce Browser + Server delivery.
6. Enter a descriptive Connection name, such as Main Store Reddit Pixel.
7. Enter the Pixel ID.
8. Paste the Conversion Access Token.
9. For the first test, enter the optional Test ID from Reddit Events Manager.
10. Select Connect.

The Pixel ID and Conversion Access Token are required for a configured connection. Test ID is optional. When present, the Node places it in the CAPI v3 request so those server events are routed to Reddit's Event Testing view.

SupremeTracking supports one Reddit connection per Property. If a connection already exists for the same Property and module, the Console routes you to the existing connection so you can use Edit credentials instead of creating a duplicate.

Supported events

The module forwards only these canonical event names:

Events such as refund, initiate_checkout, add_payment_info, subscribe, and start_trial are not mapped in version 1.0.0 and are skipped instead of being sent as Reddit custom events.

How browser and server delivery work

With Browser + Server selected, one canonical event drives two delivery paths:

1. Before ingestion, the Loader's Reddit browser handler initializes https://www.redditstatic.com/ads/pixel.js with the Pixel ID and calls the mapped Pixel event.
2. The event enters the Node's canonical pipeline and is persisted locally.
3. During Forwarding, the Reddit handler sends one event to Reddit CAPI v3 at the Pixel-specific conversion-events endpoint.

The browser metadata uses conversionId; the CAPI payload uses metadata.conversion_id. Both receive the canonical event_id. Reddit uses that shared value and event type to identify duplicate browser and server copies.

The browser handler waits for the _rdt_uuid cookie for up to about two seconds on a first visit, then proceeds even if the cookie is still unavailable. The server request can also use:

• rdt_cid from the landing URL as Reddit's click ID.
• The full _rdt_uuid cookie value as Reddit's UUID.
• The page URL, screen dimensions, canonical STUID, IP address, user agent, email, and phone when those values are present in the canonical event.
• Currency, value, item count, and product details from event parameters.

The Node sends supported Reddit match fields directly from your infrastructure to Reddit. They do not pass through the Supreme System. The module does not add a hashing layer; it trims values and formats phone numbers with a leading +, while already pre-hashed values can pass through.

Test the connection

Use a fresh mapped event and verify each boundary separately.

1. Keep the Reddit Test ID on the connection.
2. Open Reddit Events Manager and its Event Testing view for the same Pixel ID.
3. Visit the tracked website through the normal Loader path. For attribution testing, preserve any rdt_cid query parameter through redirects.
4. Trigger one supported event, such as page_view, lead, or a controlled purchase.
5. Confirm that the event appears in the Console for the selected Property.
6. Check Node logs for the Reddit forwarding result.
7. Confirm the server event in Reddit's Event Testing view and inspect its event type, conversion ID, match keys, value, and currency.
8. If using Browser + Server, confirm that Reddit receives the corresponding Pixel event with the same conversion ID.
9. After testing, open the connection's Edit credentials, clear Test ID, and select Save before sending production traffic.

These checks prove different things:

• An event in the Console proves Node ingestion and local persistence. It does not prove Reddit delivery.
• A browser_sent diagnostic proves that SupremeTracking called Reddit's browser queue. It does not prove that the Pixel script completed its network request or that Reddit attributed the event.
• A successful Node forwarding log proves that the CAPI request completed without a transport or HTTP error recognized by the handler. It does not prove campaign attribution or reporting.
• An event in Reddit Event Testing proves receipt by the selected Reddit data source. Deduplication and reporting are later Reddit-side processing steps.

Troubleshooting

Reddit Ads is unavailable to install

Read the catalog badge first. PRIVATE BETA requires beta access, COMING SOON means no installable release is available, and UPDATE NODE means the release requires a newer Node. Do not manually copy module files around the catalog installer.

The connection stays in Pending configuration

Open Edit credentials and confirm that both Pixel ID and Conversion Access Token contain non-empty values. Confirm that you edited the connection for the intended Property.

The event reaches the Console but not Reddit

Confirm that:

• The event name is one of the eight mapped events above.
• The Reddit module is installed and the Property connection exists.
• The connection's delivery mode includes Server for CAPI and Browser for the Pixel path you are testing.
• The Pixel ID and token belong to the same Reddit data source and account context.
• The Test ID and Event Testing view belong to that same data source.
• Node logs do not report a Reddit API error.

An HTTP 401 usually points to a missing or invalid bearer token. An HTTP 403 can indicate the wrong Pixel ID or insufficient authorization for that Pixel. The module sends a descriptive User-Agent; if Reddit reports automated User-Agent throttling, confirm that the current packaged module is installed rather than an older or modified client.

The Pixel path is missing

Confirm that the connection includes Browser, the Loader is active on the page, and the Reddit Pixel script is not blocked by browser privacy controls, consent rules, a content blocker, or network policy. Server delivery may still work when the browser Pixel is blocked.

Match quality is lower than expected

Confirm that landing-page redirects preserve rdt_cid, the Loader can read the _rdt_uuid cookie after the Pixel initializes, and the canonical event contains the available user and context fields. Missing match keys do not mean the Console lost the event; they affect what the Reddit handler can send for matching.

Browser and server copies are not deduplicated

Use Browser + Server, test on Node 3.4.4 or newer, and confirm that both copies are the same mapped event type with the same canonical event_id. Do not fire a separate manual Reddit Pixel event for the same action unless it uses the same conversion ID. Reddit performs deduplication asynchronously, so two newly received test records do not by themselves prove a permanent duplicate.

Limitations and removal

Version 1.0.0 is website-focused: CAPI events use WEBSITE as the action source, one event is sent per request, and the client performs no automatic retry after a failed request. Mobile advertising identifiers, offline action-source mapping, custom Reddit events, and the unmapped canonical events listed above are not supported by this version.

To stop Reddit delivery for one Property, open its connection and select Disconnect. The Console warns that this stops delivery for that Property until it is reconnected. Disconnecting the Property connection is narrower than uninstalling the module.

To remove the module code from the Node, use Uninstall in Manage Modules after disconnecting the affected Property connections. The uninstall confirmation states that saved module settings remain on the Node and are restored if the module is reinstalled. Uninstalling a Node module does not remove Reddit-side events, pixels, audiences, or campaign configuration.

For the general catalog and runtime model, read Integrations overview.