Reddit Conversions API
Server-side event delivery to Reddit's Conversions API v2.0 for enhanced conversion tracking, bypassing browser limitations and improving match quality for ad optimization.
Reddit Conversions API is a server destination in the walkerOS flow:
Sends events server-side to Reddit's Conversions API using raw HTTP (no SDK). Identity fields (`email`, `external_id`, `ip_address`, `user_agent`, `idfa`, `aaid`) are SHA-256 hashed before sending. Events include a stable `event_metadata.conversion_id` for deduplication with the Reddit Pixel.
Installation
- Integrated
- Bundled
Configuration
This destination uses the standard destination config wrapper (consent, data, env, id, ...). For the shared fields see destination configuration. Package-specific fields live under config.settings and are listed below.
Settings
| Property | Type | Description | More |
|---|---|---|---|
accessToken | string | Reddit Conversion Access Token for Bearer authentication | |
pixelId | string | Reddit Pixel ID used as the API path parameter | |
action_source | Source of the event (WEBSITE, APP, PHYSICAL_STORE) | ||
doNotHash | Array<string> | Array of user fields that should not be hashed | |
test_mode | boolean | Enable test mode by sending test_mode: true in the request body | |
url | string | Custom URL for Reddit Conversions API endpoint | |
user_data | Record<string, string> | Mapping configuration for user fields |
Mapping
Per-event rules under config.mapping. For the standard rule fields (consent, condition, data, batch, name, policy) see mapping.
| Property | Type | Description | More |
|---|
Examples
add to cart
lead
page visit
purchase
search
sign up
Event mapping
Reddit uses a rigid taxonomy. Map walkerOS events to a standard tracking_type via each rule's name field:
| walkerOS Event | Reddit tracking_type |
|---|---|
page view | PageVisit |
product view | ViewContent |
site search | Search |
product add | AddToCart |
product wishlist | AddToWishlist |
order complete | Purchase |
form submit | Lead |
user signup | SignUp |
Any non-standard name becomes { tracking_type: 'Custom', custom_event_name: '<name>' } automatically. Reddit's AI optimization is trained on the standard events, so prefer them when possible.
event_metadata structure
Unlike Meta's CAPI (which uses custom_data) and Pinterest (which also uses custom_data), Reddit places conversion details under event_metadata. Always map into event_metadata.map. Products belong in event_metadata.products[] with { id, name?, category }.
Payload envelope
Reddit wraps events inside { data: { events: [...] } } (nested), unlike Meta/Pinterest's flat { data: [...] }. The destination handles this automatically.
Hashing
The destination automatically SHA-256 hashes the 6 standard identity fields before sending: email, external_id, ip_address, user_agent, idfa, aaid. Pass raw values and hashing is handled for you.
Reddit hashes ip_address and user_agent, which Meta CAPI and Pinterest CAPI pass through as plaintext. Be sure to pass the raw values, not pre-hashed ones, unless you use doNotHash.
Non-hashable fields pass through as-is: uuid, opt_out, screen_dimensions, data_processing_options.
If a value is already hashed or you want to skip hashing for a specific field, use doNotHash:
Deduplication
Each event is sent with event_metadata.conversion_id set to the walkerOS event id. If you also run the Reddit Pixel in the browser, Reddit deduplicates server and browser events that share the same conversion_id, so conversions are not double-counted.
Test mode
Set test_mode: true in settings to send "test_mode": true as a top-level boolean in the request body (not a query parameter, unlike Pinterest). Useful during development.