Reddit Destination

Send your event data from RudderStack to Reddit.

3 minute read

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.

Setup

In your RudderStack dashboard, go to Directory > Destinations > Cloud Destinations and search for Reddit.
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 ID of your Reddit Ads account that the conversion events belong to. To get this ID, go to Profile > Ad Accounts in your Reddit Ads Manager account.
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.

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:

OneTrust Cookie Categories: This setting lets you associate the OneTrust cookie consent groups to 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.

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 event	Reddit `tracking_type` event
`Product Viewed` `Product List Viewed`	`ViewContent`
`Product Added`	`AddToCart`
`Product Added to Wishlist`	`AddToWishlist`
`Order Completed`	`Purchase`
`Products Searched`	`Search`

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

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 property	Reddit 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.clickId`	`click_id`
`traits.email` `context.traits.email`	`user.email`
`context.ip` `request_ip`	`user.ip_address`
`context.userAgent`	`user.user_agent`
`context.device.advertisingId`	`user.idfa` OR `user.aaid`
`properties.optOut`	`opt_out`
`properties.conversionId` `messageId`	`event_metadata.conversion_id`
`properties.currency`	`event_metadata.currency`
`properties.products.$.category`	`event_metadata.products.$.category`
`properties.products.$.product_id`	`event_metadata.products.$.id`
`properties.products.$.name`	`event_metadata.products.$.name`
`properties.revenue`	`event_metadata.value`
`properties.products.$.quantity` `properties.quantity` `properties.item_count`	`event_metadata.item_count`
`context. traits.userId`	user.external_id
`properties.uuid`	`user.uuid`
`context.screen.height`	`user.screen_dimensions.height`
`context.screen.width`	`user.screen_dimensions.width`

Was this page helpful?

Glad to hear it! Please tell us how we can improve.

Sorry to hear that. Please tell us how we can improve.

Questions? Contact us by email or on Slack