(Conversion API) Reddit Conversions API

Follow
Avatar
Travis Simpson
Updated
Conversion Postbacks for web, PC, and console events are only available to Singular customers with access to Singular’s Web, PC, and Console game attribution.

Singular’s integration with the Reddit Conversions API allows advertisers to send Singular attributed click conversions to Reddit. This integration is supported for Singular web, PC, and console measurement. For Singular’s mobile measurement integration with Reddit, see our help center article on the topic.

How to Configure the Reddit Conversions API Integration

  1. Ensure you have an integrated web, PC, or console app with Singular
  2. Go to Singular > Attribution > Partner Configuration
  3. Click "Add a Partner", and type and choose "Reddit Conversions API"
  4. In the dialog, choose your App and App site (platform) to configure. Note that only web, PC, and console apps are supported with this integration
  5. Find your Reddit pixel ID. Specify which business account should receive your conversions. You can find your pixel ID in the Events Manager, and it should match the business account's pixel ID found in Accounts.
  6. Generate a conversion api access token. Reddit recommends generating a conversion token so you don’t have to worry about it expiring.
  7. Paste in your app's "Reddit Account ID" and "Reddit Conversion API Token" from steps 5 & 6 above.


  8. Optionally configure any additional events to send to Reddit and map it to a "Reddit Event Name"


  9. Click "Save" to finish.

FAQ

How can I validate Reddit is receiving events from Singular
  1. Navigate to the Reddit Event Manager.
  2. You should see the Reddit events mapped from your Singular partner configuration recorded here

What data does Singular send via API?
Parameter Details
click_id
  • Reddit click ID
  • automatically passed
email
  • Optional
  • Hashed email may be passed as a Singular instrumented event attribute "ehash" (See Singular SDK Documentation for details on sending event attributes)
  • Hashed email value must be normalized and SHA 256 hashed
IP address  
user agent
  • (For web only)The user agent for the browser corresponding to the event
external_id
  • Advertiser defined User ID (custom_user_id)
Reddit uuid
  • Optional
  • Generated by the Reddit pixel
  • Can be retrieved from Reddit's 1st party cookie, and sent on web event Arguments with the key rdt_uuid
  • e.g. {"rdt_uuid":"532ae67f-e9e0-47b8-9d81-b47fdb62f014"}
IDFA / GAID
  • automatically passed
  • mobile device IDs for iOS and Android only
conversion_id
  • Optional
  • If you are using both the Reddit Pixel and Singular Reddit Conversion API integration to send the same event, you will need to leverage the conversion ID
  • Send the conversion ID in your web event Arguments to Singular on the eventId key
  • e.g. {"eventId":"12343abcdkjdf"}
What are the limitations of Reddit's Conversions API?
  • Reddit recommends that the Reddit Conversion API be used to augment an existing Reddit pixel implementation (see Best Practices in Reddit's documentation).
  • Using the Reddit Conversions API integration in Singular, app events can sent and recorded as website events in Reddit for web to app attribution flows. However, for mobile integrations, Reddit and Singular recommend passing mobile conversion data through Singular's dedicated mobile attribution integration with Reddit.