Conversions API
Send server-to-server event data to Reddit for more accurate tracking, especially in cookie-restricted environments.
Considerations
- CAPI supports a variety of sources, including web, app, and offline events.
- There’s a rate limit of 1,000 requests/second, 10,000 events/second, and 1,000 events/request.
- We recommend sending conversions via CAPI as close to real-time as possible, but events must be sent within seven days after they occur.
- We require event deduplication if you use the Reddit Pixel and Conversions API together (which we recommend for best performance). The event with more event metadata and match keys will be prioritized. Deduplication is not required when the event is only sent through one integration type. Learn more about event deduplication.
- Some match keys (unique event and user identifiers) are required for each conversion event to ensure accurate matching and attribution. We recommend sending as many identifiers as possible to help improve attribution accuracy and fuel performance.
- Your use of CAPI is subject to the agreements in the Ads API and Reddit Business Tool terms.
Guides
Direct Integration
Send conversion events directly with our Conversions API. This guide explains setup, match keys, and event deduplication for accurate measurement.
Implement Click ID Persistence
The click ID (rdt_cid) is a match key that helps attribute click conversions more accurately. It’s appended to the landing page URL when a user clicks through an ad from Reddit. We recommend sharing it for all available conversion events.
Verify Conversion Events
Verify your Reddit Conversions API integration to ensure accurate tracking and ad performance. Use the Events Manager to test events and troubleshoot issues.
Error Handling
Troubleshoot and resolve common errors for the Reddit Conversions API. This guide explains error codes for bad requests, authorization issues, and rate limits.
CAPI v2 to v3 Migration
Update your Conversions API integration to v3 to access new features and ongoing support. Our guide explains changes to payloads, parameters, and endpoints.
Best Practices
Get accurate conversion data for your Reddit ads. This guide covers best practices for the Conversions API, including event deduplication and signal sharing.