Reddit Conversions API

reddit conversions api is reddit's server side conversion endpoint this destination sends events to reddit from chord's servers rather than the browser, so measurement is unaffected by ad blockers and browser tracking restrictions for browser side tracking and click id capture, see the reddit pixel # destination this destination uses conversions api v3 getting started you will need pixel id — the identifier for your reddit pixel, found in the reddit ads dashboard under events manager it starts with t2 use the same pixel id as your reddit pixel destination conversion token — generate it in the reddit ads dashboard under events manager > conversions api treat it as a secret connecting to the reddit conversions api cdp destination warning before connecting destinations in the chord cdp, please verify with all destination owners that all non chord cdp configured destinations are disabled running external destinations alongside configured chord cdp destinations can result in duplicate events downstream log into the chord data platform navigate to the cdp click the "add" button next to destinations select reddit conversions api from the destination catalog enter the destination name, your pixel id , and your conversion token optionally enter a test id to route events to reddit's test view instead of production reporting click "create" to connect using alongside the reddit pixel destination reddit recommends running the pixel and the conversions api together, and this destination is built for that the pixel supplies browser context and the reddit click id; the conversions api reports conversions that never reach the browser or are blocked there configure both destinations with the same pixel id chord sends each event's unique message id as the deduplication key on both surfaces, and reddit deduplicates on the combination of that key and the event name running both does not double count conversions, and no extra configuration is required deduplication every event this destination sends carries chord's unique message id for that event in metadata conversion id the reddit pixel # destination sends the same value in its conversionid field, which is what lets the two run together safely this matters if you send events to reddit from anywhere else as well — your own pixel, another tool, or a platform app reddit deduplicates on the combination of the conversion id and the event name, so to deduplicate against chord's events you must send the same conversion id for the same underlying action if you cannot, expect reddit to count those conversions twice event mapping chord event reddit event page page visit product viewed view content products searched search product added add to cart product added to wishlist add to wishlist order completed purchase email captured lead signed up sign up event types other than page and track — identify , group , screen — are not sent reddit has no equivalent endpoint for them; identity travels on the events themselves identity and matching every event carries whatever identifiers are available, which is what determines how much of your reddit spend can be attributed reddit requires at least one identifier source sent as email event traits or properties sha 256 hash customer id userid sha 256 hash phone number event traits or properties sha 256 hash, normalized to e 164 ip address request ip sha 256 hash user agent event context plain text reddit click id rdt cid from the landing page url, or an rdt cid / click id property plain text mobile advertising id device context sha 256 hash, sent as aaid or idfa by platform all personal data is hashed before it leaves chord values that carry no matching signal — n/a , unknown , null , phone numbers that are too short or all one digit — are dropped rather than hashed, because a hash of a placeholder becomes a permanent false match the reddit click id is the strongest signal it is set on the landing page url when someone clicks a reddit ad, and the reddit pixel # destination stores it in first party storage for up to 30 days running the pixel alongside this destination therefore improves server side attribution as well purchase events order completed sends reddit's purchase event with the order value, currency, item count, and a product list carrying each line item's id, name, category, quantity, and unit price currency values are sent as decimal amounts — 149 50 means $149 50 limited data use reddit supports limited data use (ldu) for privacy restricted regions chord forwards it only when the storefront explicitly asks for it, by including modes \["ldu"] on the event — optionally with a country and region ldu is never inferred, because applying it silently would restrict processing for every event test mode setting a test id attributes events to that reddit test instead of production reporting, so an integration can be verified without polluting campaign data leave it empty for live traffic test mode is a per destination setting, so use a separate destination for testing rather than switching one back and forth click attribution reddit appends its click identifier, rdt cid , to the ad's landing page url it appears there and nowhere else — a visitor who lands on /product?rdt cid= and buys three pages later has no click id in the url by the time the purchase happens chord persists the value when the landing page is tracked and attaches it to every later event in the session, so a conversion reported minutes or days after the click still carries the click id reddit needs to attribute it the stored value lasts 30 days and is cleared after a completed order nothing is required of you for this to work beyond tracking the landing page if the clickid row in reddit's match key coverage reads 0%, the usual explanation is simply that the traffic did not come from a reddit ad — organic and direct visits have no click id to capture gotchas revenue metadata is only sent on revenue events reddit validates event metadata per event type, marks value, currency and item count as applying to revenue related events only, and reports anything else as "unsupported metadata" in events manager product viewed is not a revenue event, so chord sends product details and the deduplication id but no value, currency or item count this matches the reddit pixel # destination exactly — the two surfaces have to agree, or the same conversion reports differently depending on which one reddit kept reddit's event set is fixed reddit recognizes only the eight standard events in the mapping table above chord events with no reddit equivalent — checkout started , product removed , order refunded — are not sent, and the reason is recorded in the destination's logs reddit does support a custom event type, but a custom event is discarded unless its name is registered in your reddit account first, so chord does not send one this matches the reddit pixel destination's behaviour what the pixel skips, the conversions api skips too refunds are not reported reddit has no refund event on either surface search terms are not sent reddit's search event takes no query parameter failures are retried only when retrying can help rate limits and reddit server errors are retried a rejected payload or a bad credential is not — those would fail identically on a second attempt, and the error is recorded in the destination's logs instead both credentials are required a missing pixel id or conversion token fails the event with an explicit error rather than silently dropping it updated 1 september 2026