Reddit Ads

What Is Reddit Ads?

Reddit is a popular social media platform where users can engage in discussions, share content, and participate in communities called subreddits. Reddit ads are a form of native advertising that blends into the platform's feed, appearing as promoted posts. These ads can include text, images, videos, or a combination, and are often targeted based on user interests and subreddits they frequent. Advertisers can choose between different formats like banner ads, video ads, and carousel ads, allowing for diverse creative strategies. The interactive nature of Reddit encourages user engagement, making it a unique platform for brands to foster community-driven discussions and feedback. Additionally, Reddit's ad platform provides robust analytics to track performance and optimize campaigns.

What are the benefits of integrating MetaRouter with Reddit Ads?

  • Up to 30% more data tracked compared to third-party tags, enhancing personalization data & opportunities
  • All customer data events and attributes unlocked for custom event mapping and transformation
  • No effect on website load latency

Getting Started - From Your Reddit Ads Account

You will need the to retrieve the following:

  • Account ID - Please find instructions here.
  • Refresh Token - Please find instructions here.
  • Basic Auth
    • Combine your client ID and client secret with a colon (:) and encode this string in base64.
    • Please find more information here.

Getting Started - From Your MetaRouter Account

Adding a Reddit integration.

From the integration library, add a Reddit Ads integration. Then, fill out the Connection Parameters:

Connection ParameterDescription
ACCOUNT_IDUnique identifier for managing Reddit Ads account settings and campaigns.
REFRESH_TOKENCredential to obtain new access tokens without re-authentication, maintaining API access.
BASIC_AUTHCombine client ID and secret, encode in base64, and use in the HTTP header for API requests.

Adding a Reddit Sync

To gather the rdt_cid (Reddit click ID) value, you must add a Reddit Ads sync.

  1. From the Pipelines page, find the pipeline associated with the web property you’d like to add a sync to. Hover over the three dot dropdown and select “Build AJS File.”
  2. In the Identity Syncs section, select the Reddit Ads sync.
  3. Fill out the following fields:
    1. Consent Type - We recommend that you consult with your legal team when determining your consent requirements.
    2. Cookie Lifetime (in days) - 30 days default
  4. Scroll down and click the Save and Build File button.
  5. Deploy your AJS file to propagate changes to your web property.

Event Mappings

MetaRouter provides all of the event mappings that Reddit Ads integrations typically require. You may add custom events, parameters or mappings in accordance with Reddit Ad’s API documentation.

Global

Global mappings will be applied to all events. If your parameter names do not match the Expected Inputs provided, you will need to overwrite the Inputs provided with your own.

Output KeyDescriptionExpected Input
event_metadata.conversion_id RequiredType: String
Unique ID for the conversion event.
messageId
click_id
Required
Type: String
ID of the click that led to the conversion.
context.providers.redditAds.rdt_cid
event_at
Required
Type: String
Timestamp of the event.
N/A - Expression
user.external_idType: String
External user ID.
anonymousId
user.ip_address
Required
Type: String
IP address of the user.
context.ip
user.user_agent
Required
Type: String
User's browser user agent.
context.userAgent
user.emailType: String
User's email address.
context.traits.email

Event Specific

Page

Output KeyDescriptionExpected Input
event_type.tracking_typeType: String
Type of event tracking.
Enrichment - "PageVisit"

Products Searched

Output KeyDescriptionExpected Input
event_type.tracking_typeType: String
Type of event tracking.
Enrichment - "Search"

Product List Viewed

Output KeyDescriptionExpected Input
event_type.tracking_typeType: String
Type of event tracking.
Enrichment - "Custom"
event_type.custom_event_nameType: String
Name of the custom event.
event
event_metadata.item_countType: Integer
Number of items involved in the event.
N/A - Expression
event_metadata.productsType: Array
Details of the products involved in the event.
N/A - Expression

Product Viewed

Output KeyDescriptionExpected Input
event_type.tracking_typeType: String
Type of event tracking.
Enrichment - "ViewContent"
event_metadata.item_countType: Integer
Number of items involved in the event.
Enrichment - "1"
event_metadata.productsType: Array
Details of the product viewed.
N/A - Expression

Product Added

Output KeyDescriptionExpected Input
event_type.tracking_typeType: String
Type of event tracking.
Enrichment - "AddToCart"
event_metadata.currencyType: String
Currency used in the transaction.
properties.currency
event_metadata.item_countType: Integer
Number of items involved in the event.
properties.quantity
event_metadata.productsType: Array
Details of the product added to the cart.
N/A - Expression
event_metadata.value_decimalType: Decimal
Total value of the transaction.
N/A - Expression

Cart Viewed

Output KeyDescriptionExpected Input
event_type.tracking_typeType: String
Type of event tracking.
Enrichment - "Custom
event_type.custom_event_nameType: String
Name of the custom event.
event
event_metadata.currencyType: String
Currency used in the transaction.
properties.currency
event_metadata.item_countType: Integer
Number of items involved in the event.
N/A - Expression
event_metadata.productsType: Array
Details of the products in the cart.
N/A - Expression
event_metadata.value_decimalType: Decimal
Total value of the transaction.
N/A - Expression

Order Completed

Output KeyDescriptionExpected Input
event_type.tracking_typeType: String
Type of event tracking.
Enrichment - "Purchase"
event_metadata.currencyType: String
Currency used in the transaction.
properties.currency
event_metadata.item_countType: Integer
Number of items involved in the event.
N/A - Expression
event_metadata.productsType: Array
Details of the products involved in the event.
N/A - Expression
event_metadata.value_decimalType: Decimal
Total value of the transaction.
properties.total


Required & Recommended Identifiers

These identifiers must be mapped to Reddit Ads in order for successful user matching to occur. Without these IDs, any events sent to Reddit Ads may not be properly reflected in reporting. For your convenience, required and recommended IDs are mapped as Global parameters to ensure they are added to every event.

AttributeExampleSync Injector Required?
event_metadata.conversion_id
Required
"conv12345"
click_id
Required
"abcde12345"Yes
event_at
Required
"2023-05-10T14:48:00Z"
user.ip_address
Required
"192.168.1.1"
user.user_agent
Required
"Mozilla/5.0 (Windows NT 10.0; Win64; x64)"
user.external_id
Recommended
"user123"
user.email
Recommended
"[email protected]"


Additional Reddit Ads Documentation

Reddit Conversion API

OAuth2