Reddit Conversions Connector Setup Guide | Server-Side Connectors

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. The Reddit Ad account must have the following permissions: adsread, history, adsconversions, and adsleadgendownloader. For more information, see Reddit: Authentication.

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. If you do not set Screen Height, `events.user.screen_dimensions` is populated from the Tealium Collect event data. For example, from `data.com.viewport_height`.
Screen Width	The width of the user’s screen in pixels. If you do not set Screen Width, `events.user.screen_dimensions` is populated from the Tealium Collect event data. For example, from `data.com.viewport_width`.