DocumentationExperience PlatformTags

Reddit Conversions API extension overview

Last update: Wed May 07 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Developer

Reddit is a social media platform with a diverse user base, making it ideal for advertisers targeting specific audiences.

Use the Reddit Conversions API extension to send user interaction events captured in the Adobe Experience Platform Edge Network to Reddit Ads. Use this extension to help your brand reach an audience of over 379 million weekly active users, and better understand user behavior and run targeted advertisements.

Read this guide to learn how to install, configure, and use the Reddit Conversions API extension in your event forwarding rules.

Key benefits benefits

Use the Reddit Conversions API extension to:

  • Reach your audience: Engage with over 379 million weekly active users on Reddit.
  • Analyze user behavior: Leverage user interaction data to understand behavior and optimize campaigns.
  • Deliver targeted ads: Run personalized advertisements based on user interactions captured in Adobe Experience Platform.

Prerequisites prerequisites

You must have a valid Reddit Ads account to use this extension. Go to Reddit Ads registration page to register and create an account if you do not have one already. Once you have your account set up, request access to the Ads API.

Gather required configuration details configuration-details

To connect the Experience Platform to Reddit, the following inputs are required:

Credential
Description
Example
Pixel ID
The Pixel ID is a unique identifier associated with your Reddit Ads account. It is used to track user interactions and conversion events on your website or app. You can find your Pixel ID in your Reddit Ads account.
123456789012
Conversion Access Token
Your Reddit Conversion Access Token. Refer to the Reddit Conversions API document for guidance.
You are only required to go through this process once as this token does not expire.

Install and configure the Reddit extension install-configure

Follow these steps to install and configure the Reddit Conversions API extension:

  1. In the Experience Platform Data Collection UI, select Extensions from the left navigation to access the Extensions catalog. Then Create a new event forwarding property or select an existing property.

  2. Navigate to Extensions in the left navigation panel. Select Catalog and then select the Reddit extension.
    The Adobe Experience Platform Extensions catalog with the Reddit extension highlighted.

  3. Provide the following configuration details:

    • Pixel ID: Enter your Reddit Ads Pixel ID.
    • Conversion Access Token: Enter the token generated in your Reddit Ads account and select Save when finished.
      Configuration details for the Reddit Conversions API extension, including fields for Pixel ID and Conversion Access Token.

Configure an event forwarding rule config-rule

After you set up your data elements, create event forwarding rules to determine when and how events are sent to Reddit Ads.

  1. Navigate to Rules in your event forwarding property and create a new rule.

  2. Under Actions, add a new action and set the extension to Reddit CAPI.

  3. Set the Action Type to Send Event.
    Event forwarding rule configuration interface for the Reddit Conversions API extension, with the extension and action type fields highlighted.

  4. Configure the additional controls for your event as shown in the table below:

    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 11-row-3
    Field name Description Example
    Event Name Specify the name of the conversion event. Purchase
    Event Type Define the type of event that can be a supported Reddit conversion event or a custom one. SignUp, MyCustomEvent
    Timestamp Provide the event time in ISO format or epoch time. 2025-04-15T16:01:00.000Z, 1744742460000
    Client Dedupe ID Add a unique ID for deduplication. abc123
    Match Keys Include user and device identifiers for attribution. {"email":"hashed_email@example.com", "phone":"hashed_phone"}
    Value Specify the monetary value of the event. 99.99
    Currency Code Use ISO-4217 format for the currency. USD
    Units Sold Enter the quantity of items purchased. 3
    Country Code Specify the country where the event occurred. US
    Data Processing Options Add privacy flags, such as LDU (Limited Data Usage). {"modes":["LDU"],"country":"US","region":"US-NY"}
    Consent Indicate user consent for advertising data usage. true

  5. Select Keep Changes to save the rule.

Event metadata event-metadata

Read this section for a detailed breakdown of the event metadata and user data fields, ensuring you understand the required and optional parameters for configuring your events. The fields shown may vary depending on the event type selected.

NOTE
To get the best results from your conversion events, make sure to fill in all the fields when setting up dynamic product ads.

Event metadata fields

Configuration details for the Reddit Conversions API extension, including fields for Pixel ID and Conversion Access Token.

Field Name
Description
Example
Conversion ID (required)
The unique ID for the conversion event, used for deduplication.
abc123
Item Count
The total number of items for the conversion event.
6
Currency
The currency for the value is provided, in ISO-4217 format.
USD
Value
The total monetary value of the conversion event, including decimals.
1.23
Products
A JSON array of objects with details about the products associated with the event. Each object must include an id at a minimum.
[{"id":"SKU123","name":"ProductName","category":"CategoryName"},{"id":"SKU456","name":"ProductName","category":"CategoryName"}]

User data fields

The following parameters are optional but recommended:

Field Name
Description
Example
Email (strongly recommended)
A hashed or unhashed user email.
example@email.com
External ID
A hashed or unhashed advertiser-assigned user ID.
customer12345
UUID (strongly recommended)
The ID generated by the Reddit Pixel on your website.
1677712978045.b8f7eb7d-b357-437b-8bd3-e1c8166c7132
IP Address (strongly recommended)
The user’s device IP address.
192.168.0.1
User Agent (strongly recommended)
The browser or app used by the user.
Chrome/98.0.4758.102
IDFA
A hashed or unhashed Apple Identifier for Advertisers.
8A2E4F6D-0852-4B2A-B9D5-79334DE14B16
AAID
A hashed or unhashed Android Advertising ID.
38400000-8cf0-11bd-b23e-10b96e40000d
Screen Width
The width of the user’s display.
1920
Screen Height
The height of the user’s display.
1080
Data Processing Options (JSON format)
The user privacy settings. Only supports LDU (Limited Data Usage).
{"modes":["LDU"],"country":"US","region":"US-NY"}

Important considerations

Before sending data to Reddit Ads, the extension hashes and normalizes the values of the following fields: Email, External ID, IDFA, and AAID. The extension does not re-hash these values if they have already been hashed in SHA-256.

Validate and deploy validate-deploy

After configuring the extension and rules, validate the integration by checking event data in the Reddit Ads Events Manager. Use the Match Quality Score (MQS) to evaluate the accuracy and reliability of your signal integrations.

For additional details on Reddit Ads, visit the Reddit Ads documentation.

Next steps next-steps

After reading this document, you should now understand how to configure and use the Reddit Conversions API extension. For more information on event forwarding capabilities in Adobe Experience Platform, refer to the event forwarding overview or to the following resources:

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743