Event

This integration supports forwarding events to the Reddit Conversions API (CAPI). By activating this integration, you’ll be able to track conversions and measure the performance of your advertising campaigns on Reddit.

Prerequisites

To take advantage of the Reddit CAPI integration, you’ll need to:

1. Create a Reddit Ads account
2. Set up and authenticate a Reddit application

Supported Platforms

The mParticle integration with CAPI can support iOS, Android, and Web events; however, all events are ingested as Web events for now.

Supported Identifiers

Events are matched to redditors using matching parameters. Hashes of the following user identifiers are used, if available:

• Customer ID
• Email address

Consent State

Note: mParticle will forward to Reddit the current consent state of the user at the time of the event. Learn more about the consent state object

Event Data Mapping

mParticle Commerce Event	Reddit EventType Value
Page Visit	PageVisit
View Content	ViewContent
Add to Cart	AddToCart
Add to Wishlist	AddToWishList
Purchase	Purchase

All mParticle events will be forwarded to Reddit as custom events using the event name passed. Additionally, specific mapping exists for the following mParticle configured custom events.

mParticle Custom Event	Reddit EventType Value
Lead	Lead
Signup	SignUp
Search	Search

Event Metadata

When mParticle maps a commerce event, mParticle will send the following event metadata, if available:

• Currency code
• Item count
• Value

Custom Flags

Reddit.ClickURL

Note: Important: Don’t hash this value! Hashing can obscure its uniqueness, making it difficult to accurately attribute conversions back to the original click. This can lead to discrepancies in conversion tracking and misallocation of credit for conversions.

You can specify an optional Custom Flag on each valid incoming event. This parameter represents the web page where the event took place and must be a complete URL, including its protocol (for example, https://).

• The flag should be specified with the Reddit.ClickURL key.
• We recommend explicitly retaining rdt_cid with a redirect to ensure this parameter appears to aid with increasing match rates. mParticle will look for the value of Reddit.ClickURL and forward it to Reddit.

Reddit.ConversionsId

The Reddit.ConversionsId custom flag links to a specific conversion event. Setting this flag can help prevent conversion events from being double-counted when they’re sent across both signal sources. You should pass a unique value per event to avoid impacting attribution and campaign performance

If the Reddit.ConversionsId is unhashed, Reddit will use SHA-256 to hash it before storing it in its system.

Reddit.UUID

Note: Important: Don’t hash this value! Hashing can obscure its uniqueness, making it difficult to accurately attribute conversions back to the original click. This can lead to discrepancies in conversion tracking and misallocation of credit for conversions.

An optional Reddit.UUID Custom Flag can be specified to pass the unique user ID from the _rdt_uuid cookie on your domain to Reddit. You can use the full value or the UUID portion when sending the value.

Reddit strongly recommends passing this information to help with attribution coverage and deduplication. If this isn’t done, Reddit can’t deduplicate events against corresponding matching Reddit Pixel and CAPI events.

Deduplication

The Reddit CAPI includes deduplication support through the Reddit.ConversionsId Custom Flag. This flag can be used to account for both single and multichannel redundancy.

Multichannel Deduplication

You can pass a unique Reddit.ConversionsId for every distinct event to its corresponding CAPI event. Reddit will determine which events are duplicates based on the Reddit.ConversionsId and the conversion event name. This is the best and most accurate way to ensure proper deduplication, and we recommend this method since there’s less risk of incorrect integration, which can impact our attribution accuracy.

To ensure your events are deduplicated:

• Create a unique Reddit.ConversionsId 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 CAPI.
• Ensure the conversion event name and Reddit.ConversionsId for its corresponding events match. Note: Important: If the Reddit.ConversionsId is improperly passed to too many multiple events, those events will be marked as duplicates and will not be attributed, impacting campaign performance.

Single Channel Deduplication

If the Reddit.ConversionsId isn’t specified for multichannel redundancy, Reddit the integration will set the field on outgoing events to facilitate single-channel deduplication. If so, the Reddit.ConversionsId field is set according to the given unique mParticle Event Identity field.

Configuration Settings

Setting Name	Data Type	Default Value	Description
Advertiser ID	string		Your Advertiser ID, which you can find by navigating to Business > Users on Reddit Ads
Client ID	string		The Client ID found in your Reddit application’s settings in your application preferences
App Secret	string		The App Secret found in your Reddit application’s settings in your application preferences
Refresh Token	string		The Refresh Token found from the Reddit API authentication flow