Skip to contentSkip to navigationSkip to topbar
On this page
Looking for more inspiration?Visit the
(information)
You're in the right place! Segment documentation is now part of Twilio Docs. The content you are used to is still here—just in a new home with a refreshed look.

Reddit Conversions API


Destination Info
  • Accepts Page, Alias, Group, Identify and Track calls.
  • Refer to it as Reddit Conversions Api, or Reddit Conversions API in the Integrations object
  • This integration is partner owned. Please reach out to the partner's support for any issues.

The Reddit Conversions API(link takes you to an external page) allows advertisers to send conversion events from Segment directly to Reddit, without needing website code. By building a sustainable server-side connection more resilient to signal loss, you can gain stronger campaign performance with improved measurement, targeting, and optimization.


Benefits of Reddit Conversions API

benefits-of-reddit-conversions-api page anchor
  • Clear mapping of data: Actions-based destinations enable you to define the mapping between the data Segment receives from your source and the data Segment sends to Reddit.
  • Prebuilt mappings: Mappings for Reddit Standard Events, like Purchase and AddToCart, are prebuilt with the prescribed parameters and is available for customization.
  • Streamlined stability and security: Integrate and iterate without client-side limitations, like network connectivity or ad blocker issues.
  • Privacy-focused: Stay compliant with rapidly evolving requirements with automatic PII hashing and flexible controls that let you adapt what data you share.
  • Maximum event measurement: Capture more events with improved accuracy across different browsers, apps, and devices to get a unified view of your customer's journey from page view to purchase.
  • Data normalization: Data is normalized before hashing to ensure the hashed value matches across sources and is in line with Reddit data requirements(link takes you to an external page).

This destination is maintained by Reddit. For any issues with the destination, contact the Reddit support team.


  1. From the Segment web app, click Catalog, then click Destinations.
  2. Search for "Reddit Conversions API" in the Destinations Catalog, and select the destination.
  3. Select the source that will send data to the Reddit Conversions API and follow the steps to name your destination.
  4. On the Settings tab, enter in your Reddit Conversion Token(link takes you to an external page) and Pixel ID (You can find your pixel ID in the Events Manager(link takes you to an external page), and it should match the business account's pixel ID found in Accounts(link takes you to an external page)) and click Save.
  5. Follow the steps in the Destinations Actions documentation on Customizing mappings.

Property nameTypeRequiredDescription
Pixel IDstring
required

Unique identifier of an ad account. This can be found in the Reddit UI.


Conversion Tokenpassword
required

The conversion token for your Reddit account. This can be found by following the steps mentioned here(link takes you to an external page).


Test Modeboolean

Optional

Indicates if events should be treated as test events by Reddit.


Reddit Conversions API has the following presets

Preset NameTriggerDefault Action
Add to WishlistEvent type = "track" and event = "Product Added to Wishlist"Send Standard Event
Reddit Browser PluginEvent type = "track", Event type = "identify", Event type = "group", Event type = "page", Event type = "alias"Reddit Browser Plugin
PurchaseEvent type = "track" and event = "Order Completed"Send Standard Event
SearchEvent type = "track" and event = "Products Searched"Send Standard Event
Sign UpEvent type = "track" and event = "Signed Up"Send Standard Event
LeadEvent type = "track" and event = "Lead Generated"Send Standard Event
Add to CartEvent type = "track" and event = "Product Added"Send Standard Event
Page VisitEvent type = "page"Send Standard Event
View ContentEvent type = "track" and event = "Product Viewed"Send Standard Event

Build your own Mappings. Combine supported triggers with the following Reddit Conversions API-supported actions:

(information)

Mapping limits per destination

Individual destination instances have support a maximum of 50 mappings.

Send Custom Event

send-custom-event page anchor

Send a Custom Conversion Event to Reddit

Send Custom Event is a Cloud action.

Property nameTypeRequiredDescription
Event AtDATETIME
required

The RFC3339 timestamp when the conversion event occurred


Custom Event NameSTRING
required

A custom event name that can be passed when tracking_type is set to "Custom". All UTF-8 characters are accepted and custom_event_name must be at most 64 characters long.


Click IDSTRING

Optional

The Reddit-generated id associated with a single ad click.


ProductsOBJECT

Optional

The products associated with the conversion event.


UserOBJECT

Optional

The identifying user parameters associated with the conversion event.


Data Processing OptionsOBJECT

Optional

A structure of data processing options to specify the processing type for the event.


Screen DimensionsOBJECT

Optional

The dimensions of the user's screen.


Event MetadataOBJECT

Optional

The metadata associated with the conversion event.


Conversion IDSTRING

Optional

The unique conversion ID that corresponds to a distinct conversion event. Use this for event deduplication. If not hashed, Segment will hash this value.


Enable Batching?BOOLEAN

Optional

When enabled, Segment will send events in batches.

Send a Standard Conversion Event to Reddit

Send Standard Event is a Cloud action.

Property nameTypeRequiredDescription
Event AtDATETIME
required

The RFC3339 timestamp when the conversion event occurred


Tracking TypeSTRING
required

One of Reddit CAPI's standard conversion event types. To send a Custom event to Reddit use the Custom Event Action instead.


Click IDSTRING

Optional

The Reddit-generated id associated with a single ad click.


ProductsOBJECT

Optional

The products associated with the conversion event.


UserOBJECT

Optional

The identifying user parameters associated with the conversion event.


Data Processing OptionsOBJECT

Optional

A structure of data processing options to specify the processing type for the event.


Screen DimensionsOBJECT

Optional

The dimensions of the user's screen.


Event MetadataOBJECT

Optional

The metadata associated with the conversion event.


Conversion IDSTRING

Optional

The unique conversion ID that corresponds to a distinct conversion event. Use this for event deduplication. If not hashed, Segment will hash this value.


Enable Batching?BOOLEAN

Optional

When enabled, Segment will send events in batches.

Enriches Segment payloads with data from the Reddit Pixel

Reddit Browser Plugin is a Web action. The default Trigger is type = "track" or type = "identify" or type = "page" or type = "group" or type = "alias"

This action does not have any fields.


Attribution signal matching

attribution-signal-matching page anchor

At least one attribution signal is required with each conversion event. Send as many signals as possible to improve attribution accuracy and performance.

  • Recommended Signals:
    • Reddit Click ID
    • Reddit UUID
    • IP Address
    • Email
    • User Agent
    • Screen Dimensions
  • Additional Signals:
    • Mobile Advertising ID
    • External ID

Segment creates a SHA-256 hash of the following fields before sending to Reddit. If you hash the values before sending it to Segment, it must follow the hashing format described in the Reddit Advanced Matching documentation(link takes you to an external page) to properly match.

  • Email
  • Mobile Advertising ID
  • IP Address
  • External ID

Deduplication with the Reddit Pixel

deduplication-with-the-reddit-pixel page anchor

If you implement both the Reddit Pixel(link takes you to an external page) and Conversions API (CAPI)(link takes you to an external page) and the same events are shared across both sources, deduplication is necessary to ensure those events aren't double-counted.

The integration automatically pre-maps the Segment messageId to the Reddit Conversion ID. If you wish to change this, you can pass a unique conversion ID for every distinct event to its corresponding Reddit Pixel and CAPI event. Reddit will determine which events are duplicates based on the conversion ID and the conversion event name. This is the best and most accurate way to ensure proper deduplication, and Reddit recommends this method since there's less risk of incorrect integration, which can impact attribution accuracy.

To ensure your events are deduplicated:

  • Create a unique conversion ID for every distinct event. You can set this as a random number or ID. Similarly, you could set this to the order number when tracking purchase events.
  • Include the event in the Reddit Pixel and CAPI.
  • Ensure the conversion event name and conversion ID for its corresponding events match.

For more information on deduplication, see the Reddit Event Deduplication documentation(link takes you to an external page).


Verify events in the Reddit Events Manager

verify-events-in-the-reddit-events-manager page anchor

After you start sending events, you can navigate to the Reddit Events Manager to see if the events are being received in near real-time. For more information, see the Reddit Events Manager documentation(link takes you to an external page).


You can send computed traits and audiences generated using Engage to this destination as a user property. To learn more about Engage, schedule a demo(link takes you to an external page).

For user-property destinations, an identify call is sent to the destination for each user being added and removed. The property name is the snake_cased version of the audience name, with a true/false value to indicate membership. For example, when a user first completes an order in the last 30 days, Engage sends an Identify call with the property order_completed_last_30days: true. When the user no longer satisfies this condition (for example, it's been more than 30 days since their last order), Engage sets that value to false.

When you first create an audience, Engage sends an Identify call for every user in that audience. Later audience syncs only send updates for users whose membership has changed since the last sync.

(information)

Real-time to batch destination sync frequency

Real-time audience syncs to Reddit Conversions API may take six or more hours for the initial sync to complete. Upon completion, a sync frequency of two to three hours is expected.


Segment lets you change these destination settings from the Segment app without having to touch any code.

Property nameTypeRequiredDescription
Pixel IDstring
required

Unique identifier of an ad account. This can be found in the Reddit UI.


Conversion Tokenpassword
required

The conversion token for your Reddit account. This can be found by following the steps mentioned here(link takes you to an external page).


Test Modeboolean

Optional

Indicates if events should be treated as test events by Reddit.

Default: false