Reddit Conversions Connector Setup Guide

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

Configuration

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.
• Conversion Access Token
  • A conversion access token is a non-expiring secure key that lets you send conversion event data to Reddit’s Conversions API.
  • This easily generated, shareable, long-lived access token can be used by any administrator for any ad account within your business.
  • Reddit recommends using a conversion access token over a developer access token / OAuth for Conversions API.
  • For more information, see Reddit: Conversion Access Token.
  • If you aren’t using a conversion access token, use the Establish Connection button to initiate the OAuth authentication workflow.
  • To migrate from OAuth to conversion access token, enter the token in the conversion access token field and the connector uses that token instead of the OAuth token.

Deduplication for web events

To configure this connector to deduplicate events from the Reddit Pixel tag, use the event IDs sent as event attributes with the following naming convention:

reddit_pixel_event_id_{REDDIT_EVENT}_{TAG_UID}

You can find your tag’s UID in the Tealium iQ Tags table or the tag details screen:

For example, a Purchase event from a tag with a UID of 168 would send the following attribute value:

{
  "reddit_pixel_event_id_Purchase_168": "028b2ade7478..."
}

An Add To Cart event from the same tag would send the following attribute value:

{
  "reddit_pixel_event_id_AddToCart_168": "084b1cda7461..."
}

Use a separate action for each type of event. Map the event-specific event ID attribute to Event ID with the matching event name mapped to Event Name. For example:

If you’re only receiving event ID attributes using the naming format reddit_pixel_event_id_{REDDIT_EVENT} (without the tag UID), we recommend updating your tag. For more information, see Reddit Pixel Tag Setup Guide.

Automatic deduplication

When the Automatic Deduplication value is populated, the connector looks for the corresponding event ID attribute. You are no longer required to add an Event ID if this section is populated and you are using Tealium iQ. However, the following approach may still be needed when using EventStream without Tealium iQ.

The connector follows this order of operations:

• If Automatic Deduplication is populated and the value is found in the data layer, this value supersedes anything mapped in Event ID. For example, reddit_pixel_event_id_Purchase_30.
• If Automatic Deduplication is populated, but it cannot find the tag ID version, but it can find the legacy version (with no ID attached), that value is used. For example, reddit_pixel_event_id_Purchase.
• If Automatic Deduplication is populated, but the value isn’t found, the mapped Event ID is used, if it is populated.

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 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 impacts attribution and campaign performance.

Parameters

Products Data

Processing Data

Automatic Deduplication