Reddit Conversions API

• 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.

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

To connect the Reddit Conversions API destination, follow these steps:

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 and Pixel ID (You can find your pixel ID in the Events Manager, and it should match the business account's pixel ID found in Accounts) and click Save.
5. Follow the steps in the Destinations Actions documentation on Customizing mappings.

The Send Standard Event and Send Custom Event actions support Reddit Conversions API V3, which is currently in beta. V2 remains the default: existing mappings and the prebuilt mappings continue to send to V2, and nothing changes unless you opt a mapping in to V3.

V3 is Reddit's latest Conversions API. It adds omnichannel attribution, so you can tell Reddit whether a conversion happened on your website, in your app, in a physical store, or somewhere else. For website conversions, V3 also sends the URL of the page where the event occurred, which Reddit uses to improve attribution. V3 also supports Reddit Event Testing, so you can check test events before you send production traffic.

To send a mapping's events to V3:

1. Open the Send Standard Event or Send Custom Event mapping and set API Version to V3 (Beta).
2. Set Action Source to the channel where the conversion occurred: Website, App, Other, or Offline (Physical Store). Action Source is required for V3.
3. Make sure Conversion ID is mapped. Conversion ID is required for V3, and it's mapped to the Segment messageId by default.
4. If Action Source is Website, check that Event Source URL is mapped. It defaults to context.page.url.
5. Save the mapping.

To test V3 events before you send production traffic:

1. In Reddit's Events Manager, open Event Testing and copy your test ID.
2. On the destination's Settings tab, paste the ID into Test ID and click Save. Reddit routes V3 events to Event Testing instead of production while this setting is populated.
3. Send some test events, then confirm they appear in Reddit Event Testing.
4. Clear the Test ID setting when you're done, so that events go to production.

Reddit Conversions API has the following presets

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

• Send Custom Event
• Send Standard Event
• Reddit Browser Plugin

Send a Custom Conversion Event to Reddit

Send Custom Event is a Cloud action.

Send a Standard Conversion Event to Reddit

Send Standard Event is a Cloud action.

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.

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 to properly match.

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

If you implement both the Reddit Pixel and Conversions API (CAPI) 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.

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.

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.

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.

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