Documentation

Reddit

Suggest Edits

Overview

Reddit is a social network platform that allows users to discuss, vote, and share content. The platform is known for its engaged community and is often used for news aggregation, content rating, and public discussion.

Authorization

If you haven't already done so, you will need to set up a Reddit account before you begin the process described below.

If you are new to creating authorizations in Lytics, see the Authorizations documentation for more information.

  1. Select Reddit from the list of providers.
  2. Select the method for authorization. Note that different methods may support different job types. Reddit supports the following authorization methods:
  3. Enter a Label to identify your authorization.
  4. (Optional) Enter a Description for further context on your authorization.
  5. Complete the configuration steps needed for your authorization. These steps will vary by method.
  6. Click Save Authorization.

Reddit Ads User

Reddit Ads User authorization method is an Oauth2 based authorization for the Reddit Ads platform.

  1. Enter your Reddit login credentials in the login popup.
  2. In the Label text box, enter a name for the authorization
  3. (optional) In the Description text box, enter a description for this authorization

Reddit Conversion API Access Token

This authorization required access token for conversion events. The access token can be generated in Events Manager in Reddit Ads dashboard.

  1. In the Label text box, enter a name for the authorization
  2. (optional) In the Description text box, enter a description for this authorization
  3. In the Access Token text box, enter your conversion api access token.


Reddit: Conversion API Export

Send Lytics user profiles to Reddit using their conversion api. Use these conversion events to improve performance of your ad campaign.

Integration Details

  • Implementation Type:Server-side Integration
  • Implementation Technique: REST API Integration, Audience Trigger Integration
  • Frequency: Real-time Integration
  • Resulting data: A Lytics audience is exported to Reddit conversion api.

This workflow uses the Reddit conversion api to send the Lytics audiences events.

Once the job is created, the job will:

  1. Optionally Scan existing audience, and for each user it will extract the conversion information as events based on the job's configuration.
  2. Add each conversion events in a queue. The queue will be sent to Reddit every minute or until the queue reaches 1,000 users, whichever happens first.
  3. The export job will run continuously. As users enter or exit the Lytics audience, the updates are sent to Reddit conversion api.

Fields

You can send Lytics user fields to Reddit conversion api. The job constructs the payload according to the configuration. But below is the sample of payload:

{
    "events":
    [
        {
            "click_id": "1234567890",
            "event_at": "2024-10-07T23:32:58-07:00",
            "event_at_ms": 1728369178392,
            "event_metadata":
            {
                "conversion_id": "test-conversion-id",
                "currency": "USD",
                "item_count": 5,
                "value": 1099
            },
            "event_type":
            {
                "custom_event_name": "lytics_audiences",
                "tracking_type": "Custom"
            },
            "user":
            {
                "aaid": "cdda802e-fb9c-47ad-9866-0794d394c912",
                "data_processing_options":
                {
                    "country": "US"
                },
                "email": "5aaf4e4a4d5fce68feac226a5160bd1ae12d03eeb64dee7e674d48209cdccee7",
                "external_id": "7c73f2ae-a433-4d7b-9838-abcdefghijkl",
                "idfa": "el123ghi-ayyu-48bc-b806-asdfghjklqwe",
                "ip_address": "192.192.1.1",
                "user_agent": "Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0",
                "uuid": "1684189007728.7c73f2ae-a433-4d7b-9838-f467da98f48e"
            }
        }
    ],
    "test_mode": false
}


Configuration

Follow these steps to set up and configure a Reddit Conversion API export job in the Lytics platform. If you are new to creating jobs in Lytics, see the Destinations documentation for more information.

  1. Select Reddit from the list of providers.

  2. Select the export Reddit: Conversion API Export from the list.

  3. Select the Authorization you would like to use or create a new one.

  4. Enter a Label to identify this job you are creating in Lytics.

  5. (Optional) Enter a Description for further context on your job.

  6. Select the Audiences that contains the users to export.

  7. In the Ad Account text box, enter your Reddit Ad Account ID.

  8. From the Event Type input, select the type of the conversion event. If not selected, the event will be sent with lytics_audiences custom name. You can also enter any other custom event name.

  9. (Optional) From the Event Timestamp input, select the Lytics user field that contains the timestamp for the event. The timestamp must not be older than 7 days. If left empty, current timestamp will be used.

  10. From the Click ID input, select the Lytics user field that contains the Reddit click ID.

  11. From the User Data Mappings input, map Lytics user fields to Reddit User Data. Atleast one user data or click id must be provided.

  12. (Optional) From the Conversion ID input, select the Lytics user field that contains the conversion ID that will be used for de-duplication in Reddit.

  13. (Optional) From the Country Code input, select the 2 letter country code where the users are located. If not provided, US will be used as default.

  14. (Optional) From the Currency Code input, select the currency code, three letter code in ISO-4217 format. If not provided, USD will be used as default.

  15. (Optional) From the Value input, select the Lytics user field that contains monetary value of the event.

  16. (Optional) From the Units Sold input, select the Lytics user field that contains the number of items sold.

  17. Select the Existing Users checkbox to immediately push users who currently exist in the selected Lytics audience. Deselecting will only push users as they enter or leave the audience.

  18. Click the Complete button to start the job.

Updated 1 day ago