Reddit Destination

Send your event data from RudderStack to Reddit.

Reddit’s Conversions API is a server-to-server solution for tracking and sharing your web conversion data with Reddit.

Find the open source transformer code for this destination in the GitHub repository.

Connection compatibility

Destination info
  • Status: Generally Available
  • Supported sources: Android, iOS , Web, Unity, AMP , Cloud, Warehouse, React Native , Flutter, Cordova, Shopify
  • Refer to it as REDDIT in the Integrations object.

Connection modes
SourceCloud modeDevice modeHybrid mode
AMPsupportednot supportednot supported
Androidsupportednot supportednot supported
Cloudsupportednot supportednot supported
Cordovasupportednot supportednot supported
Fluttersupportednot supportednot supported
iOSsupportednot supportednot supported
React Nativesupportednot supportednot supported
Shopifysupportednot supportednot supported
Unitysupportednot supportednot supported
Warehousesupportednot supportednot supported
Websupportednot supportednot supported
Supported message types
SourceIdentifyPageTrackScreenGroupAlias
Cloud mode
Supported sourcesnot supportednot supportedsupportednot supportednot supportednot supported

Setup

  1. In your RudderStack dashboard, go to Directory > Destinations > Cloud Destinations and search for Reddit.
  2. Connect your source and click Continue.

Connection settings

Configure the following settings to set up Reddit as a destination in RudderStack:

  • Name: Assign a name to uniquely identify the destination.
  • Under Account Settings, click Create Account > Connect with Reddit. Give RudderStack the necessary permissions to access your Reddit account.
  • Account ID: Enter the Pixel ID of your Reddit Ads account that the conversion events belong to.
  • Hash Data: This setting is turned on by default. RudderStack hash encrypts the event properties (for example, email, userId, ip, etc.) before sending them to Reddit.
warning
If you are already hashing this data before sending it to RudderStack, make sure to turn off this setting.

Configuration settings

After completing the initial setup, configure the following settings to correctly receive your data in Reddit:

Event mapping settings

  • RudderStack to Reddit event mappings: Click Set up mapping to map your RudderStack events to specific Reddit events. You can also use the JSON mapper to set these mappings.
Reddit event mapping setting

Track

You can use the track call to record and send conversion events along with any associated properties to Reddit for processing.

A sample track event sent to Reddit:

rudderanalytics.track("Order Completed", {
  revenue: 500,
  currency: "INR",
  conversionId: "G53B1A44XQ",
  clickId: "4583752045291814500",
  products: [{
    product_id: "item1",
    sku: "9472-775-0112",
    name: "Sample Item",
    price: 30,
    position: 1,
    category: "Sample Items"
    url: "https://www.website.com/sample-product/",
    image_url: "https://www.website.com/product/path.jpg",
  }]
}, {
  traits: {
    email: "alex@example.com",
    userId: "1hKOmRA4GRlm",
    firstName: "Alex",
    lastName: "Keener"
  }
});

By default, RudderStack maps the following standard ecommerce events to Reddit’s tracking_type events:

RudderStack eventReddit tracking_type event
Product Viewed
Product List Viewed
ViewContent
Product AddedAddToCart
Product Added to WishlistAddToWishlist
Order CompletedPurchase
Products SearchedSearch

You can also use the Event mapping settings in the RudderStack dashboard to map your events to specific Reddit events.

warning
Note that if your events are not mapped and do not belong to the above standard RudderStack ecommerce events, RudderStack automatically sends it as a custom event and maps it to Reddit’s Custom tracking type.

Supported mappings

RudderStack maps the following event properties in the track events to the corresponding Reddit fields:

RudderStack propertyReddit property
event
Required
tracking_type as set in the dashboard or as per the above standard mapping.
event
Required
custom_event_name with tracking_type set to Custom
originalTimestamp
Required
event_at
properties.clickIdclick_id
traits.email
context.traits.email
user.email
context.ip
request_ip
user.ip_address
context.userAgentuser.user_agent
context.device.advertisingIduser.idfa OR user.aaid
properties.optOutopt_out
properties.conversionId
messageId
event_metadata.conversion_id
properties.currencyevent_metadata.currency
properties.products.$.categoryevent_metadata.products.$.category
properties.products.$.product_idevent_metadata.products.$.id
properties.products.$.nameevent_metadata.products.$.name
properties.revenueevent_metadata.value
properties.products.$.quantity
properties.quantity
properties.item_count
event_metadata.item_count
context. traits.userIduser.external_id
properties.uuiduser.uuid
context.screen.heightuser.screen_dimensions.height
context.screen.widthuser.screen_dimensions.width

FAQ

Where can I find the Pixel ID?

  1. Log in to the Reddit Ads Manager account.
  2. Select Events Manager from the drop-down menu in the top-left corner.
  1. Select Set Up Reddit Pixel and choose from one of the below options according to your requirement:

Based on the selected option, you will find your Pixel ID on the next screen.

See Reddit Pixel documentation for more information on setting up the Reddit Pixel.


Questions? Contact us by email or on Slack