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 Key

Description

Expected Input

event_metadata.conversion_id Required

Type: 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_id

Type: 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.email

Type: String
User's email address.

traits.email

user.phone_number

Type: String
User's phone number.

input.traits.phone

Event Specific

Page

Output Key

Description

Expected Input

event_type.tracking_type

Type: String
Type of event tracking.

Enrichment - "PageVisit"

Products Searched

Output Key

Description

Expected Input

event_type.tracking_type

Type: String
Type of event tracking.

Enrichment - "Search"

Product List Viewed

Output Key

Description

Expected Input

event_type.tracking_type

Type: String
Type of event tracking.

Enrichment - "Custom"

event_type.custom_event_name

Type: String
Name of the custom event.

event

event_metadata.item_count

Type: Integer
Number of items involved in the event.

N/A - Expression

event_metadata.products

Type: Array
Details of the products involved in the event.

N/A - Expression

Product Viewed

Output Key

Description

Expected Input

event_type.tracking_type

Type: String
Type of event tracking.

Enrichment - "ViewContent"

event_metadata.item_count

Type: Integer
Number of items involved in the event.

Enrichment - "1"

event_metadata.products

Type: Array
Details of the product viewed.

N/A - Expression

Product Added

Output Key

Description

Expected Input

event_type.tracking_type

Type: String
Type of event tracking.

Enrichment - "AddToCart"

event_metadata.currency

Type: String
Currency used in the transaction.

properties.currency

event_metadata.item_count

Type: Integer
Number of items involved in the event.

properties.quantity

event_metadata.products

Type: Array
Details of the product added to the cart.

N/A - Expression

event_metadata.value_decimal

Type: Decimal
Total value of the transaction.

N/A - Expression

Cart Viewed

Output Key

Description

Expected Input

event_type.tracking_type

Type: String
Type of event tracking.

Enrichment - "Custom

event_type.custom_event_name

Type: String
Name of the custom event.

event

event_metadata.currency

Type: String
Currency used in the transaction.

properties.currency

event_metadata.item_count

Type: Integer
Number of items involved in the event.

N/A - Expression

event_metadata.products

Type: Array
Details of the products in the cart.

N/A - Expression

event_metadata.value_decimal

Type: Decimal
Total value of the transaction.

N/A - Expression

Order Completed

Output Key

Description

Expected Input

event_type.tracking_type

Type: String
Type of event tracking.

Enrichment - "Purchase"

event_metadata.currency

Type: String
Currency used in the transaction.

properties.currency

event_metadata.item_count

Type: Integer
Number of items involved in the event.

N/A - Expression

event_metadata.products

Type: Array
Details of the products involved in the event.

N/A - Expression

event_metadata.value_decimal

Type: 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.

Attribute

Example

Sync 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