Freshpaint
HomeLogin
  • Documentation
    • What is Freshpaint?
    • ⚕️HIPAA Mode
    • 🏗️Building Out Your Account
    • 🌐Overview of Features
    • Guides
      • 📡Add Autotrack to your website to collect data from your users
        • Installing the Freshpaint Javascript SDK
        • Installing the Freshpaint SDK with a Content Security Policy (CSP)
        • Installing the Freshpaint Javascript SDK with Server-Side Rendering (SSR) + React
        • Autocapture + React
        • Configuring a Destination
        • Labeling User Actions
        • How do I install Freshpaint with Typescript?
      • 🔁Send historical data to any destination with Time Machine
      • Next.js Quickstart Guide
      • Android Quickstart Guide
        • Installing the Freshpaint Android SDK
        • Configuring a Destination
        • Instrumenting Your App
      • iOS Quickstart Guide
        • Installing the Freshpaint iOS SDK
        • Configuring a Destination
        • Instrumenting Your App
      • React Native Quickstart Guide
        • Installing the Freshpaint React Native SDK
        • Configuring a Destination
        • Labeling User Actions
        • Configuring Property Capture
    • Setting up Properties
    • Setting up Your Destinations
      • Enabling and Disabling a Destination
      • Deleting a Destination
    • Setting up Your Events
    • User Identification
      • Designated Identify Properties
    • Maps
    • Analytics (Beta)
      • Web Analytics Dashboard
      • Campaigns
      • Service Lines
      • Data Glossary
    • Translations
    • Web Tracker Monitoring
      • Tracker Resolution Types
      • Historical Scans
  • Integrations
    • Destinations
      • Demand Side Platforms (DSPs)
        • Basis
          • Basis Quick Start Guide
          • Basis Reference
        • Google Campaign Manager 360
        • StackAdapt
          • StackAdapt Quick Start Guide
          • StackAdapt Reference
        • theTradeDesk
          • theTradeDesk Quick Start Guide
          • theTradeDesk Reference
          • theTradeDesk with CM360 Configuration Guide
        • Viant
          • Viant Quick Start Guide
          • Viant Reference
      • Direct Response Ads
        • Facebook Conversions API
          • Facebook Conversions API Quick Start Guide
          • Facebook Conversions API Reference
        • Google Ads Conversion API
          • Google Ads Conversion API Quick Start Guide
          • Google Ads Conversions API Reference
        • Google Ads
          • Google Ads Quick Start Guide
          • Google Ads Reference
        • LinkedIn Ads
          • LinkedIn Ads Quick Start Guide
          • LinkedIn Ads Reference
        • Microsoft Ads (formerly Bing Ads)
          • Microsoft Ads Quick Start Guide
          • Microsoft Ads Reference
          • Microsoft Ads Multi-Config Reference
        • Pinterest Ads (Beta)
          • Pinterest Ads Quick Start Guide
          • Pinterest Ads Reference
        • Pinterest Tag
        • Reddit Ads
          • Reddit Ads Quick Start Guide
          • Reddit Ads Reference
        • TikTok Ads
        • Twitter Ads
      • Data Activation
        • ActiveCampaign
          • ActiveCampaign Quick Start Guide
          • ActiveCampaign Reference
        • Amplitude
          • Amplitude Quick Start Guide
          • Amplitude Reference
        • Braze (formerly Appboy)
          • Braze Quick Start Guide
          • Braze Reference
        • Customer.io
          • Customer.io Quick Start Guide
          • Customer.io Reference
        • Freshsales
        • Google Analytics 4 Proxy
          • Google Analytics 4 Proxy Quick Start Guide
          • Google Analytics 4 Proxy Reference
          • Google Analytics 4 Proxy Advanced Tracking Configurations
        • Google Analytics 4 Server-Side
          • Google Analytics 4 Server-Side Quick Start Guide
          • Google Analytics 4 Server-Side Reference
        • Heap
        • Hotjar
        • HubSpot Cloud
        • HubSpot Web
        • impact.com
          • Impact.com Quick Start Guide
          • Impact.com Reference
        • Intercom
          • Intercom Quick Start Guide
          • Intercom Reference
        • Iterable
          • Iterable Quick Start Guide
          • Iterable Reference
        • June
        • Klaviyo
        • Mixpanel
          • Mixpanel Quick Start Guide
          • Mixpanel Reference
        • OneSignal
          • OneSignal Quick Start Guide
          • OneSignal Reference
        • Sendinblue
        • Sentry
        • Vero Cloud
        • Webengage
        • Webhooks
        • Woopra
        • Zendesk
      • Data Warehouses
        • Azure Warehouse Setup
        • BigQuery Warehouse Setup
        • Databricks Warehouse Setup
        • Postgres Warehouse Setup
        • Redshift Warehouse Setup
        • S3 Warehouse Setup
        • Snowflake Warehouse Setup
      • Consent Management
        • Osano
        • OneTrust
        • Custom Consent Manager
    • Sources
      • Web
        • Autotrack
        • Precision Tracking
      • CallRail
      • Invoca
      • Customer.io
      • Intercom
      • Mailchimp
      • React Native
      • SendGrid
      • Sendinblue
      • Server-Side
      • iOS
    • 🔷Google Tag Manager integration
      • Google Tag Manager migration
      • Quick Start Guide
    • 📺Freshpaint Video Platform
    • 🖼️Impression Pixel
  • Admin Panel
    • Event Library
      • Event Library Bulk Actions
      • Event Definition Filters
      • Event Tester
      • 🔁Time Machine
      • Visual Tagger
      • Advanced Options
        • Tag Manager
        • Disabling Target Text Capture
        • Cross Domain Tracking
    • Projects & Environments
    • Teams
      • Role-Based Access Control (RBAC)
    • Transformations
      • Standard Events
      • Modify Data
      • Modify User Data
      • SQL Transformations
    • 📈Destination Monitoring
    • 🔎Investigate: Testing and Debugging
      • Live View
      • Event Verification
  • Reference
    • Developer Docs
      • Freshpaint Web SDK Reference
      • Freshpaint Web SDK Options
      • Freshpaint React Native SDK Reference
      • Freshpaint iOS SDK Reference
      • Freshpaint Android SDK Reference
      • HTTP API
    • Frequently Asked Questions
      • How do I circumvent ad blockers?
      • Can Freshpaint track users across domains?
      • Can I install Freshpaint on a Chrome extension?
      • What properties are captured with my events?
      • How Do I Switchover From Segment?
      • How Do I Switch From Native Google Analytics to the Freshpaint Google Analytics Destination?
      • Where do I find my Environment ID?
      • Is Freshpaint GDPR & CCPA Compliant?
      • Can I use transformations to anonymize data for client-side destinations?
      • How do I QA or debug my data?
      • Why Do My Numbers Differ Across Different Tools?
      • Billing: How Does Freshpaint Determine MTUs?
      • Can I Use Freshpaint on Multiple Sites?
      • How Can I Export Data From Freshpaint?
      • How Does Freshpaint Identify Users?
      • How Many Events Should I Create?
      • What Should I Name My Events?
      • How do I track scroll depth?
      • What Data Does Freshpaint Collect?
        • Data Collected on Web
        • Data Collected on React Native
      • Does Freshpaint's Autotrack slow my site down?
      • Running Freshpaint with a Proxy
      • Should my Environment ID be treated as a sensitive key?
      • How Does Freshpaint Determine Session Count?
      • What is the difference between client-side and server-side connection mode?
      • What is a Proxy Integration?
      • Where can I view Freshpaint’s Status?
      • Does Freshpaint provide HIPAA audit logs?
      • Freshpaint Cookie Too Large
      • How does Freshpaint compare to server-side Google Tag Manager?
      • If a user re-installs my app, will Freshpaint generate a new device ID?
      • Why doesn't Freshpaint need a BAA before sending data to Google Ads and Facebook Ads?
      • What Implementation Services Does Freshpaint Offer?
      • Single Sign On (SSO) Setup
Powered by GitBook
On this page
  • Destination Info
  • Events
  • Track Events

Was this helpful?

  1. Integrations
  2. Destinations
  3. Direct Response Ads
  4. Reddit Ads

Reddit Ads Reference

Send advertising events to Reddit Ads via Freshpaint.

PreviousReddit Ads Quick Start GuideNextTikTok Ads

Last updated 6 months ago

Was this helpful?

Destination Info

  • Supports calls

  • Supports

  • Refer to this destination as reddit-ads in the

    • If you've configured multiple Account IDs, you can choose a specific one by suffixing the Account ID, such as: reddit-ads::0123456789012345. You can retrieve this value from the Reddit Ads configuration page for the Account ID of interest.

  • Connection Modes:

Client-side
Server-side

Web

Mobile

Server

This is a reference document for the Reddit Ads destination. For information on how to set up this integration, see the Reddit Ads Quick Start Guide.

Events

When you send an event to the Reddit Ads destination from Freshpaint, Freshpaint will create an event in the Reddit event manager by hitting Reddit Ad's conversions API.

Track Events

When you send an event to the Reddit Ads destination, you can track conversions from your ads based on those events. Please refer to for further details on which properties are relevant.

Below are the Required, Recommended, and Optional properties which are mapped to the Reddit Ads request:

Freshpaint property

Reddit Ads parameter

Type

Requirement

Description

$rdt_cid

click_id

string

Required

A query parameter that connects a page view or conversion event to a specific ad, which Freshpaint captures as $rdt_cid

<event_name>

tracking_type

string

Required (either tracking_type or custom_event_name is always sent)

If event name is one of: - PageVisit - ViewContent - Search - AddToCart - AddToWishlist - Purchase - Lead - SignUp - Custom we will use the event name as the tracking_type. We normalize the value before sending to Reddit (for example, page_visit maps to PageVisit)

<event_name>

custom_event_name

string

Required (either tracking_type or custom_event_name is always sent)

If event name is not one of the standard event names described above, we will set tracking_type to Custom and send the <event_name> as custom_event_name

$time

event_at_ms

number(float)

Required ( always sent)

This uses a built in prop to send the event time.

test_mode

test_mode

boolean

Optional

This test flag is processed by Reddit. It is a flag indicating whether the conversion events should be processed. This can be set to "true" when testing out the API integration and no data will be posted to the account.

item_count

event_metadata[item_count]

number(int)

Optional

The number of items in the event.

value

event_metadata[value_decimal]

number(float)

Optional

Value of the transaction in the base unit of the currency (eg. 30.12)

currency

event_metadata[currency]

string

Optional

Currency for the value provided. Three character ISO 4217 currency code (eg. USD)

products

event_metadata[products]

array

Optional

Array of products associated with the event. Each product must contain at least an id and a category. A name can optionally be included. Example:

[{

"id": "someId",

"category": "someCategory",

"name": "someName"

}]

Any product that doesn't contain at least id and category will be dropped.

conversion_id

event_metadata[conversion_id]

string

Optional

A unique conversion ID corresponds to a distinct conversion event. This field is used for deduplication and should only be used if the Reddit client side Pixel is also running on the website.

reddit_uuid

user[uuid]

string

Optional

The value from the first-party Pixel '_rdt_uuid' cookie on your domain. Note that it is in the '{timestamp}.{uuid}' format. You may use the full value or just the UUID portion. This field may not be relevant if you are not running the Reddit client side Pixel on your website.

email

user[email]

string

Optional

The email address of the user. This value will be cleaned and sha256 hashed before being sent to Reddit. For example, A.b+c@domain -> ab@domain -> sha256(ab@domain)

external_id

user[external_id]

string

Optional

An advertiser-assigned persistent identifier for the user. This value will be whitespace trimmed, lowercased and sha256 hashed before being sent to Reddit.

$screen_height

user[screen_dimensions][height]

number(int)

Optional

The height of the user's screen in pixels. This must be positive and less than 32768.

$screen_width

user[screen_dimensions][width]

number(int)

Optional

The width of the user's screen in pixels. This must be positive and less than 32768.

aaid

user[aaid]

string

Optional

The AAID of the user's device. This value will be sha256 hashed before being sent to Reddit.

idfa

user[idfa]

string

Optional

The IDFA of the user's device. This value will be sha256 hashed before being sent to Reddit.

$ip / ip_address

user[ip_address]

string

Optional

The IP address of the user. This value will be sha256 hashed before being sent to Reddit. You can either allow the Freshpaint collected value or send your own using the ip_address prop.

opt_out

user[opt_out]

boolean

Optional

A flag indicating whether the user has opted out of tracking. This defaults to false unless otherwise specified

$user_agent /user_agent

user[user_agent]

string

Optional

The user agent of the user's browser. You can either allow the Freshpaint collected value or send your own using the user_agent prop.

Track
HIPAA mode
Integrations object
Reddit Ads API Conversions documentation