Skip to main content
The Reddit Conversion API (CAPI) sends conversion events from Cometly directly to Reddit Ads. An event is a tracked action such as a lead or a purchase. When you set up the Reddit Conversion API, Cometly sends your events to Reddit using the Pixel ID you save for each ad account, and you choose whether to send all events or only events attributed to Reddit. This gives Reddit more complete data about how your ads perform, even when browser-based tracking misses events because of ad blockers, cookie restrictions, or cross-device behavior. Reddit can then report on and optimize your campaigns with the leads and sales Cometly tracked.

Before you begin

You need:
  1. A connected Reddit profile. Sign in with Reddit on Cometly’s Integrations page so Cometly has permission to talk to your Reddit Ads account (Step 1).
  2. A Reddit ad account connected to your space. A space is the Cometly workspace for one business or website. The ad account you want to send conversions to must be connected to your current space (Step 2).
  3. Your Reddit Pixel ID. Each Reddit ad account has a Pixel ID. You find it in Reddit Ads Manager under Events & Pixels.

Step 1: Connect your Reddit profile

If you have not connected your Reddit profile yet:
  1. Click Integrations in the sidebar.
  2. Under Ad Platforms, expand the Reddit Ads row.
  3. Click Sign in with Reddit.
  4. Authorize Cometly in the pop-up window.
  5. If your Reddit account belongs to more than one business, select which one to connect.
Once connected, your Reddit profile appears in the Reddit Ads row.

Step 2: Connect your ad account to your space

  1. On the Integrations page, expand the Reddit Ads row. You see a list of the ad accounts your profile can access.
  2. Click Connect & Sync Data next to the ad account you want to use.
The account is now connected to your current space and ready for CAPI configuration.

Step 3: Turn on and configure the Reddit Conversion API

  1. Click Events Manager in the sidebar, then open the Conversion API tab.
  2. Click the Reddit row to expand it.
  3. Under Master Data Sharing Settings, choose a mode:
    • Turn off data sharing. No events are sent to Reddit.
    • Send only attributed events (recommended). Sends an event to Reddit only when Cometly attributed the conversion to a Reddit ad. This is the most conservative option and avoids inflating your Reddit conversion counts.
    • Send all events. Sends every matching event to Reddit, regardless of which ad platform gets the attribution.
  4. Under Configure default pixels, enter the Pixel ID for each connected Reddit ad account in the Default pixel column. This tells Cometly where to send the conversion data on Reddit’s side.
  5. In the Default account column, select Use this account for unattributed events on one account. This account receives events that are not attributed to a specific Reddit ad. A default account is required when you send all events, either as the master setting or in a custom rule.
  6. Click Save.

Check it worked

After you save, a confirmation message appears and the Reddit row on the Conversion API tab shows an Active badge instead of Inactive. From then on, Cometly sends matching events to Reddit, and they appear in Reddit Ads once Reddit has processed them.

Custom rules (optional)

By default, every event follows the master data sharing mode you selected above. To override the behavior for specific events, expand Custom Rules for Specific Events and click Add custom rule. For example, you might set the master mode to “Send all events” and add a custom rule that sets your “Lead” event to “Only send attributed events”. Each rule can be set to Do not send any events, Only send attributed events, or Send all events. Click Save after you change your rules.

Supported events

Cometly maps your events to Reddit’s conversion types: Every other event, including your custom events, is sent as the CUSTOM type with the event name included. A custom event must be set up in Events Manager (Manage custom events) before it can be sent through CAPI.

What data gets sent to Reddit

When a matching event fires and CAPI is on, Cometly sends this data to Reddit: Cometly normalizes and hashes personal data (email, phone, external ID) with SHA-256 before sending. These are never shared with Reddit in raw form.

How attribution works

Cometly decides where to send each event from the Reddit ad it attributed the conversion to. Add the Cometly URL parameters to your Reddit ads so conversions can be attributed to the right ad (see URL parameters).
  • Attributed events. When the conversion is attributed to a Reddit ad, Cometly finds that ad’s account and sends the event using the Pixel ID you saved for that account.
  • Unattributed events. When the conversion is not attributed to a Reddit ad (and you’ve chosen “Send all events”), Cometly sends the event to your default Reddit ad account using its Pixel ID.
When a Reddit click ID (rdt_cid) was captured for the visitor, it is included with the event.

Turn CAPI off

To disable the Reddit Conversion API:
  1. Click Events Manager in the sidebar and open the Conversion API tab.
  2. Expand the Reddit row.
  3. Select Turn off data sharing.
  4. Click Save.
No events are sent to Reddit while CAPI is off. Your Pixel IDs, default account, and custom rules are kept, so you can turn it back on at any time without reconfiguring.

Troubleshooting

If conversions aren’t appearing in Reddit Ads, check the following:
  • Is CAPI turned on? Make sure the mode is not “Turn off data sharing”.
  • Is the Pixel ID entered? Each connected Reddit ad account needs a valid Pixel ID. Without it, Cometly can’t send events to Reddit.
  • Is the event supported? Standard events are mapped automatically. For custom events, make sure the event is set up in Events Manager.
  • Is the account active? Make sure the Reddit ad account is still connected and active in your space.
  • Are you using “Send only attributed events”? In this mode, an event is not sent when Cometly didn’t attribute the conversion to Reddit. Switch to “Send all events” to test.
  • Is there a connection issue? If the Reddit Ads row on the Integrations page shows “Connection Issue, Resync Required”, your Reddit profile needs to be reconnected. Click Resync, or disconnect and sign in again.

Frequently asked questions

Do I need the Reddit Pixel on my website if I use the Conversion API?

CAPI works independently of the browser-based Reddit Pixel. However, using both together gives Reddit the most complete picture of your conversion data.

Is personal data shared with Reddit through the Conversion API?

Email addresses, phone numbers, and external IDs are normalized and hashed (SHA-256) before being sent. IP addresses and user agents are sent unhashed, because Reddit requires them in their original format for matching.

How long do conversions take to appear in Reddit Ads?

Cometly sends each conversion about 15 minutes after the event is tracked. Reddit may then take some time to process and display it in reporting.

Next steps

Still have questions or need a hand? We’re happy to help. Reach our team at support@cometly.com.