Skip to main content

The Reddit Conversions API Program for Offline Conversions

LiveRamp's integration with the Reddit Conversions API allows clients to enable attribution analysis of offline conversion data for ad campaigns run on Reddit. You can measure how much your ads on Reddit lead to real-world outcomes, such as in-store purchases, that the Reddit Pixel cannot capture on its own. Reddit matches these offline outcomes with people who saw or clicked on your ads to help you understand the true effectiveness of your campaigns.

When you send LiveRamp offline conversion data, LiveRamp matches the records to Reddit users in its Identity Graph through LiveRamp RampIDs and delivers the conversion event data to Reddit. This attribution analysis is performed by Reddit and is available in Reddit Ads Manager. Ad exposure data does not leave the Reddit platform.

Caution

The Reddit Conversions API Program for Offline Conversions is in limited availability and is by invitation only. Contact your LiveRamp or Reddit rep to find out about getting approved for this program.

Program Benefits

Use the Reddit Conversions API Program to:

  • Measure offline outcomes, such as in-store purchases, that occur beyond what the Reddit Pixel can track.

  • Track CRM stage progressions to optimize toward downstream business outcomes.

  • Improve signal quality and attribution reliability as third-party cookie deprecation and ad blockers limit the data available through the Reddit Pixel alone.

Overview of Steps Involved

The following steps need to be performed to enable attribution analysis with Reddit:

  1. You obtain your Reddit pixel ID and generate a conversion access token in Reddit’s Events Manager.

  2. Before your campaign starts, you send LiveRamp a sample conversion data file so we can test the integration with Reddit.

  3. You activate your campaign on Reddit.

  4. You activate a Reddit Conversions API destination account in Connect, granting LiveRamp the ability to deliver data to your Reddit Ads account.

  5. You upload offline conversion data from the past 30 days with PII to LiveRamp.

  6. LiveRamp matches the data and delivers it to the appropriate destination account in Reddit.

  7. You view the attribution analysis in Reddit Ads Manager.

See the appropriate sections below for more information on performing these steps.

Generate a Conversion Access Token

Reddit’s conversion access token is a non-expiring secure key that allows LiveRamp to send conversion event data to Reddit’s Conversions API on your behalf. You are required to provide this token when you are activating Reddit’s destination account in Connect.

To generate an access token, you must be an administrator of your team’s ad account in Reddit.

  1. Log in to Reddit Events Manager and select Conversions API in the navigation sidebar.

    Reddit_CAPI_Nav.png

  2. Click Generate Access Token.

    Reddit_CAPI_GenerateToken.png

  3. Provide a descriptive name for your token and click Generate.

  4. Copy the token to your clipboard and paste it to a secure location. You won’t be able to retrieve it after closing the dialog.

    Reddit_CAPI_SaveToken.png

Activate a Reddit Conversions API Destination Account

To distribute offline conversion data, you will need to activate a "Reddit Offline Conversions API" destination account in Connect.

Reddit_CAPI_DA.png

Follow the general instructions in "Activate a New Destination Account", performing these additional steps:

  1. Remove the end date to leave the end date open-ended.

  2. Enter the conversion access token you've generated in Reddit Events Manager.

  3. Enter the Pixel ID associated with your account in Reddit.

  4. In the Destination Account Name field, pick a unique and memorable name for this account. We'll suggest one for you but you can use any name you wish as long as it is less than 50 characters in length.

Format the File

This program utilizes the universal file format, which can be used across multiple Conversions API programs. For information on formatting guidelines, see "Using a Universal File for Multiple Conversions API Programs".

Using the Universal File Template

To make things easier for you, we've created a downloadable universal file template that you can use.

Note

The template contains formatting instructions in the second row of the file, along with info on whether a column is required and whether values are required, depending on which conversions programs you're using.

  1. Download the file template by clicking here.

  2. If desired, you can remove any non-required columns that aren't utilized by one of your conversions programs, but you can also leave those columns in the file and not populate them with values.

  3. Transfer your data into the template.

  4. After transferring your data into the file template, delete the second row with the formatting instructions.

  5. Save the file in one of our allowed file types (.csv, .tsv, .psv, or .txt).

  6. Upload the file to LiveRamp.

Once the file has been formatted correctly, upload the file to LiveRamp. See the “Upload the File” section below for more information.

Note

Once you set up the file format for an existing conversions program feed, try to keep the file format (such as the column headers or the column order) the same for all subsequent files. If you change the file format for an existing feed, create a support case before uploading the new file to ensure your existing feeds are not impacted. For more information, see "Changing the Format of an Existing File".

Header Row Example

first_name|last_name|address_1|address_2|city|state|zip|email_1|email_2|email_3|email_4|event_name|transaction_category|transaction_timestamp|transaction_amount|phone_1|phone_2|order_id| data_processing_options

Conversion Data Examples

Alex|Chen|44 Main Street|#12|San Francisco|CA|94100|alex@gmail.com|ac@ymail.com|||Purchase|In-store|2014-03-31|99.99|4157892314|4156438224|58239|LDU

Julian|Roodiger|55 Mission Street||San Francisco|CA|94500|julian@gmail.com||||Purchase|Offline|2014-03-30|55.55|4159032427|4157823435|67324|non-ldu

Send Conversion Data to LiveRamp

If you’re not currently using another LiveRamp Conversions API program (such as Bing or Yelp), we will need you to send us sample conversion data to set up the integration.

Caution

Most platforms require that at least 1,000 unique transaction events be uploaded over a 28-day period.

Conversion Data Guidelines

Each conversion data record must include at least one PII identifier (name and postal address, email, or phone) and the required conversion data:

  • Transaction category

  • Transaction timestamp

  • Transaction amount

  • Order ID

  • Event name

Conversion data should be uploaded within 7 days of the conversion. Data older than 7 days is accepted for measurement but excluded from campaign optimization.

Upload the File

Upload conversion data files using LiveRamp’s SFTP server or your SFTP server.

You can also have us pull files from an AWS S3 bucket or GCS bucket. See “Getting Your Data Into LiveRamp” for more information.

Caution

Files for this conversions program cannot be uploaded via Connect.

Note

For future uploads, you do not have to email LiveRamp to confirm that you have uploaded data assuming headers have not changed or additional columns have not been added.

Once the file is uploaded, information on file processing status can be viewed in LiveRamp Connect (see "Check File Processing Status" below for more information).

After Reddit has ingested the conversion data, you will see your attribution report within Reddit Ads Manager.

Check File Processing Status

You can check the status of the files you've uploaded on the Files page in Connect. See "Check the Status of an Uploaded File" for complete instructions.

Note

  • Once you've uploaded a file, it can take up to 20 minutes before it appears associated with the appropriate audience(s) on the Files page. If the file does not appear after at least 20 minutes, create a support case.

  • Files for this program use our Measurement Enablement workflow, so the column headings that display on the Files page will look different from the ones that display for files that use our Activation workflow.

FAQs

At what cadence should I send my conversion data files?

To support Reddit’s 14-day attribution window, we recommend sending conversion data files to LiveRamp daily or at the latest every 3 days.

What conversion data should I include in my conversion data file?

  • Include all traceable offline transactions in your delivery. Do not include online transaction data.

  • Avoid sending duplicate transactions (transactions already sent to LiveRamp). If you send daily files, only include transactions that occurred on that day. If you send weekly or monthly files, only send transactions that occurred since the previous file was sent.

  • Do not include transactions with a transaction date in the future.

In this section: