Reddit Conversions API

Reddit is a social news aggregation, content rating, and forum social network. Using this destination you can leverage Reddit Conversions API (CAPI) to share your web conversion data directly with Reddit so you can measure and optimize your performance campaigns.

Key features

The Reddit Conversions API destination provides the following key features:

• Events structure: our Events reference model covers Reddit's event types and custom events, meaning that your data is properly bridged to the expected fields in an optimized way.

• Prebuilt mappings: data mapping for event-based destinations happens automatically, which simplifies user inputs.

• Automatic hashing: information is automatically hashed matching partner specifications.

• Smart mapping: data mapping can be readjusted using your datalayer defined fields.

• Event mapping: change standard mapping between Reddit events and yours or add new mappings.

• Support for multi-item data: information included in the item array is dispatched to Reddit.

• Support batch mode: see Enable batch mode in Configuration for mode details.

Destination setup

Before configuring this destination, you need access to Reddit Ads Manager. Event deduplication is required if you use the Reddit pixel together with this destination. Reddit recommends to pass unique conversion identifiers through its pixel and this destination for all events. More details on Reddit deduplication are available following this LINK.

Configuration

Settings	Description
Access Token	Required Input your access token. You can find it in Reddit Ads by following this LINK and, from the left menu, select Event Manager → Conversions API and click Generate Access Token .
Pixel Id	Required Input your pixel identifier. You can find it in Reddit Ads by following this LINK and, from the left menu, select Event Manager .
Enable batch mode	When checked, multiple records are sent, with a single request, instead of one at a time.
Event Mapping	Change the standard mapping between Reddit events and yours or add new mappings.
Test Mode	Enable this only while testing your settings. Disable in production!

Quick reference

Commanders Act Events	Reddit Events
add_to_cart	ADD_TO_CART
add_to_wishlist	ADD_TO_WISHLIST
generate_lead	LEAD
page_view	PAGE_VISIT
purchase	PURCHASE
search	SEARCH
sign_up	SIGN_UP
view_item	VIEW_CONTENT
[Any Event]	[Any Event] [1]

[1] See Event Mapping in Configuration for more details.

Field mappings

Most properties can be remapped using our "Smart Mapping" feature. All Reddit properties are set in the path data.events.X .

Reddit recommends enabling auto-advanced matching and sending as many identifiers/match keys as possible to help improve attribution accuracy and improve performance. More details are available following this LINK .

Commanders Act Properties	Reddit Properties
context.event_timestamp	event_at
event_name	type.tracking_type [1]
Event Mapping	type.custom_event_name [2]
partners.reddit.click_id	click_id [3]
id	conversion_id [4]
value	value [4]
currency	currency [4]
items	item_count [4][5]
items.X.id	products.X.id [4]
items.X.product.name	products.X.name [4]
items.X.product.category_1 items.X.product.category_2 items.X.product.category_3 items.X.product.category_4 items.X.product.category_5	products.X.category [4][6]
context.device.advertising_id	idfa [7][8][9] aaid [7][8][9]
user.email	email [7][9]
user.id	external_id [7][9]
user.phone	phone_number [7][9]
context.device.ip	ip_address [7][9]
context.device.user_agent	user_agent [7]
parters.reddit.uuid	uuid [7]
user.country	country [10]
user.region	region [10]
parters.reddit.data_proc_mode	modes[0] [10][11]
context.device.screen.width	width [12]
context.device.screen.height	height [12]
Test Mode	test_mode [13]

[1] See Quick reference for more details on the standard mapping. [2] See Reddit event name in Event Mapping . [3] If a value is not provided, this is retrieved from the page URL by parsing the parameter rdt_cid . [4] Set in the metadata field. [5] Based on the length of the provided "Smart Mapping" field Item List . [6] All provided categories are separated by the "greater than" character ( > ). [7] Set in the user field. [8] These properties require a proper value, iOS or Android , for the "Smart Mapping" field Device Platform . [9] Automatically hashed via SHA256 when provided in clear text. [10] Set in the user.data_processing_options field. [11] Supported value: LDU . [12] Set in the user.screen_dimensions field. [13] Set in the base path.