Configure Reddit Ads as a Source in your Pipeline

Perform the following steps to configure your Reddit Ads Source:

1. Click Pipelines in the Navigation Bar.

2. Click + Create Pipeline in the Pipelines List View.

3. On the Select Source Type page, select Reddit Ads.

4. On the Select Destination Type page, select the type of Destination you want to use.

5. In the Configure Source screen, specify the following:

   

   • Source Name: A unique name for your Source, not exceeding 255 characters. For example, Reddit Ads Source.

   • In the Connect to Reddit Ads section:

     1. Click Authorize Reddit Ads.

     2. Log in to Reddit as a user who has access to your ad accounts.

     3. Click Allow to grant Hevo permission to read your advertising data and your Reddit username.

        

   • In the Select Account section, select the Sync Mode:

     • Sync All Accounts (default): Hevo ingests data from all the ad accounts that the Reddit user can access, including the ad accounts added later.

     • Sync Specific Accounts: Hevo ingests data only from the ad accounts that you select. In the Select Ad Accounts section, select the ad accounts from which you want to ingest data.

   • (Optional) In the Custom Reports section, click Add Report to create a custom report, and click Save after you configure it. You can add up to 25 custom reports.

   • In the Historical Sync section, select the Historical Sync Time Frame: The period for which the first run of the Pipeline ingests the data of the report objects. Select one of the following: 3 months, 6 months (default), 12 months, 24 months, or All available history. If you select All available history, Hevo ingests the report data from November 4, 2024. You cannot change this value after you create the Pipeline.

6. Click Test & Continue to test the connection to your Reddit Ads Source. Once the test is successful, you can proceed to set up your Destination.

---

Data Replication

Hevo replicates data for all the objects selected on the Configure Objects page during Pipeline creation. By default, all supported objects and their available fields are selected. However, you can modify this selection while creating or editing the Pipeline. To ingest a child object, you must also select its parent object. The Data Model lists the child objects of each parent object.

Hevo ingests the objects as follows:

Reddit limits the number of API requests that an application can make. If a limit is exceeded, Hevo waits and retries the request. To understand how Hevo handles such scenarios, read Handling Rate Limit Exceptions.

Hevo supports the Merge and History Tracking load modes for this Source. The History Tracking mode is available only for the Business Account object. All other objects support only the Merge mode.

Custom Reports

A custom report contains the performance metrics of your ad accounts, broken down by the dimensions that you choose. Hevo creates a table for each custom report, named after the report, and ingests it in the same way as the other report objects. If you add or edit a custom report after you create the Pipeline, resync the corresponding object to apply the changes. To create a custom report, click Add Report in the Configure Source screen, specify the following, and click Save:

• Report name: A unique name for the report. You cannot change it after you add the report.

• Breakdowns: One or two dimensions by which Reddit breaks down the metrics, such as CAMPAIGN_ID, COUNTRY, COMMUNITY, or PLACEMENT. If you select REGION, Reddit also includes COUNTRY, which does not count toward the limit.

• Report data time zone: The time zone in which Reddit returns the report data: the time zone of each ad account, or a time zone that you select.

• Fields: The metrics to ingest. If you do not select any field, Hevo ingests all the available fields.

• Include event conversion data: Turn this on to also ingest the conversion metrics of the report into an additional table.

---

Schema and Primary Keys

Hevo uses the following schema to upload the records in the Destination. For a detailed view of the objects, fields, and relationships, click the ERD.

---

Data Model

The following is the list of tables (objects) that are created at the Destination when you run the Pipeline:

Hevo also creates a table for each custom report that you add, and an additional table for its conversion metrics if you turn on Include event conversion data.

---