Reddit Conversions Connector Setup Guide
This article describes how to set up the Reddit Conversions connector.
API information
This connector uses the following vendor API:
- API Name: Reddit API
- API Version: v2.0
- API Endpoint:
https://ads-api.reddit.com/api/v2.0 - Documentation: Reddit API
Batch limits
This connector uses batched requests to support high-volume data transfers to the vendor. For more information, see Batched Actions. Requests are queued until one of the following thresholds is met or the profile is published:
- Max number of requests: 1000
- Max time since oldest request: 60 minutes
- Max size of requests: 1 MB
Connector Actions
| Action Name | AudienceStream | EventStream |
|---|---|---|
| Send Conversion | ✗ | ✓ |
Configure Settings
Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see About Connectors.
After adding the connector, configure the following settings:
- Account ID
Required. The ID of the Reddit Ad account that the conversion event belongs to. To find the Reddit Ad account ID , go to Conversions Events > Pixel ID in the Reddit Ads UI.
Actions
Enter a name for the action and select the action type from the drop-down menu.
The following section describes how to set up parameters and options for each action.
Send Conversion
We recommend using the Reddit Conversions connector Conversion ID configuration only if you are implementing both the Reddit Pixel tag and the Reddit Conversions connector. Using the Conversion ID configuration prevents the same conversion event from being counted twice if it is sent across both sources. If this value is passed improperly, it will impact attribution and campaign performance.
Parameters
| Parameter | Description |
|---|---|
| Event Name | The type of the conversion tracking event. The event name can be one of the listed values, or it can be a custom string value. |
| Event Time | The RFC3339 timestamp when the conversion event occurred. By default, the connector will send the current time. |
| Conversion ID | The unique conversion ID that corresponds to a distinct conversion event. Conversion ID is used for deduplication and prevents the same conversion event from being processed more than once if it is sent multiple times. |
| Transaction Value (Decimal) | The value of the transaction in the base unit of the currency. |
| Currency | The three-character ISO 4217 currency code for the value provided. |
| Item Count | The number of items in the event. |
| Test Mode | Set to true to test the API integration. No data will be posted to the account. |
| Reddit Click ID | The Reddit-generated ID associated with a single ad click. |
| Email Address (already SHA256 hashed) | Provide an email address which has been already whitespace trimmed, lowercased, and SHA256 hashed. |
| Email Address (apply SHA256 hash) | Provide a plain text email address and the connector will whitespace trim, lowercase, and hash this value using SHA256 hash. |
| IP Address | The connector will SHA256 hash the mapped IP address. |
| User Agent | The user agent of the user’s browser. |
| External ID (already SHA256 hashed) | An advertiser-assigned persistent identifier for the user (must accompany the Reddit Click ID or an additional attribution signal). Provide a value which has been already whitespace trimmed, lowercased, and SHA256 hashed. |
| External ID (apply SHA256 hash) | An advertiser-assigned persistent identifier for the user (must accompany the Reddit Click ID or an additional attribution signal). The connector will whitespace trim, lowercase, and hash this value using SHA256 hash. |
| IDFA (already SHA256 hashed) | The IDFA of the user’s device. Provide a value which has been already whitespace trimmed, lowercased, and SHA256 hashed. |
| IDFA (apply SHA256 hash) | The IDFA of the user’s device. The connector will whitespace trim, lowercase, and hash this value using SHA256 hash. |
| AAID (already SHA256 hashed) | The AAID of the user’s device. Provide a value which has been already whitespace trimmed, lowercased, and SHA256 hashed. |
| AAID (apply SHA256 hash) | The AAID of the user’s device. The connector will whitespace trim, lowercase, and hash this value using SHA256 hash. |
| Opt Out | A flag indicating whether the user has opted out of tracking. |
| Screen Height | The height of the user’s screen in pixels. |
| Screen Width | The width of the user’s screen in pixels. |
This page was last updated: February 7, 2024