Reddit Conversions API
Reddit is a social news aggregation, content rating, and forum social network. Reddit Conversions API (CAPI) is a server-side solution 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.
Destination setup
Configuration
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
.
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
add_to_cart
AddToCart
add_to_wishlist
AddToWishlist
generate_lead
Lead
page_view
PageVisit
purchase
Purchase
search
Search
sign_up
SignUp
view_item
ViewContent
[Any Event]
[Any Event]
[1]
Field Mappings
At least one of the following Reddit properties is required:
• click_id
*
• uuid
*
• email
*
• ip_address
+ user_agent
+ width
+ height
*
• idfa
or aaid
• external_id
Sending more properties will improve attribution accuracy and performance.
* Recommended properties.
context.event_timestamp
event_at_ms
Event Mapping
event_type.custom_event_name
partners.reddit.click_id
click_id
[1]
id
conversion_id
[2]
value
value_decimal
[2]
currency
currency
[2]
items
item_count
[2][3]
items.X.id
products.X.id
[2]
items.X.product.name
products.X.name
[2]
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
[2][4]
context.device.advertising_id
idfa
[5][6][7]
aaid
[5][6][7]
user.email
email
[5][7]
user.id
external_id
[5][7]
context.device.ip
ip_address
[5][7]
context.device.user_agent
user_agent
[5]
parters.reddit.uuid
uuid
[5]
context.device.ad_tracking_enabled
opt_out
[5]
user.country
country
[8]
user.region
region
[8]
parters.reddit.data_proc_mode
modes[0]
[8][9]
context.device.screen.width
width
[10]
context.device.screen.height
height
[10]
Test Mode
test_mode
[11]
Last updated
Was this helpful?