Reddit Destination

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 Information
Status: Generally Available Supported sources: Android (Java) , Android (Kotlin) , iOS (Obj-C) , iOS (Swift) , Web, Unity, AMP , Cloud, Warehouse, React Native , Flutter, Cordova, Shopify Refer to it as Reddit in the Integrations object.

Connection Modes
Source	Cloud mode	Device mode	Hybrid mode
AMP
Android (Java)
Android (Kotlin)
Cloud
Cordova
Flutter
iOS (Obj-C)
iOS (Swift)
React Native
Shopify
Unity
Warehouse
Web

Supported Message Types
Source	Identify	Page	Track	Screen	Group	Alias	Record	AudienceList
Cloud mode
Supported sources

Setup

1. In your RudderStack dashboard, set up a source.
2. Go to the Overview tab of your source and select Add Destination > Create new destination.

3. Select Reddit from the list of destinations. Then, click Continue.

Connection settings

Configuration settings

Event mapping settings

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

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"
  }
});

Standard event mappings

You can use the Event mapping settings in the dashboard to map your events to the below Reddit standard events:

• AddToCart
• AddToWishlist
• Lead
• PageVisit
• Purchase
• Search
• SignUp
• ViewContent

Note that RudderStack automatically maps the following standard ecommerce events to Reddit’s standard tracking_type events:

If you do not map your events in the RudderStack dashboard and they do not match the above standard ecommerce events, then RudderStack automatically sends them as custom events and maps them to Reddit’s Custom tracking type.

Supported mappings

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

Override action source

RudderStack sets action_source on API v3 events using the following precedence:

To override action_source, include it in the integrations.REDDIT object, as shown:

rudderanalytics.track("Order Completed", {
  revenue: 500,
  currency: "USD"
}, {
  integrations: {
    REDDIT: {
      action_source: "PHYSICAL_STORE"
    }
  }
});

Event source URL

RudderStack maps context.page.url to event_source_url, with properties.url as a fallback.

It sends event_source_url only when action_source is WEBSITE, per Reddit’s API requirements.

Product price and quantity

For API v3 events with product metadata, RudderStack maps per-product item_price and quantity from standard ecommerce properties. Both fields are optional — events without price or quantity data continue to transform as before.

When present, item_price must be a non-negative number and quantity must be a non-negative integer.

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.

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