Skip to main content
Skip table of contents

Reddit Ads

The Reddit Ads datasource allows you to query performance data from Reddit Ads accounts you have access to.

Vendor/Partner

Reddit

Version

Reddit API (OAuth): v1
Advertising API: v2.0

API Documentation

Reddit API (OAuth), Advertising API, Advertising API v3.0

Sunset Date

v2.0 Allow-list sunset as of 06.06.2024, update to v3.0 – In Progress as of October 2024

Channel(s)

Socialhttps://ads-api.reddit.com/docs/v3/

Refresh Time (CST)

3am / Real Time

Default backfill

7 days

Alli Data Library

(tick)

Getting Started

To be able to utilize the Reddit datasources, both the account and login email you use to authenticate will need Reddit Ads API access (Analyst role) granted from a Reddit representative. Reach out to your social lead if you do not have a Reddit contact.

Required Authorization

Reddit Ads required a Reddit account with access to Reddit Ads Manager. You can see which profiles you have access to by adding your Account ID in the link below and navigating to it:
https://ads.reddit.com/account/{insert your own Account ID here}/accounts

OR:

  1. Login into: https://ads.reddit.com

  2. Select your account name from the top-right corner, a dropdown list will show

  3. Click “View all accounts & invitations”

  4. Then you will be able to see a list of accounts and their Id’s formatted as t2_xyz

Datasource Setup:

  1. Once you have an account with Reddit Ads (analyst access minimum), click the Request Reddit Ads Access button.

  2. Next, copy and paste the Account Ids you would like to create reports for, and include the ‘t2_’ part in the Account Id.

  3. If you’d like to include multiple accounts, add the account Ids separated by a comma as shown in the screenshot above.

  4. Make sure to click the Next/Save button to save your selection.

Limitations

  1. The Reddit API has a request rate limit of 1 request per second. This causes a delay in saving the datasource if you have more than one account saved.

  2. Performance metrics under the Reddit Ads API are shared between all report types.

  3. The Reddit reporting endpoint doesn’t allow fetching more details about entities such as name, modified_at, objective, created_at. These will have to be fetched through the Reddit Ads - Structure datasource.

Account Dimensions

Name

Description

Date

The date

Account ID

The Account ID

Campaign Dimensions

Name

Description

Date

The date

Campaign ID

The Campaign ID

Ad Group Dimensions

Name

Description

Date

The date

Ad Group ID

The Ad Group ID

Ad Dimensions

Name

Description

Date

The date

Ad ID

The Ad ID

Post Dimensions

Name

Description

Date

The date

Post ID

The Post ID

Useful Information

On reddit dashboard , click on the refresh icon and check the timezone and other parameters passing (refer the above image) and compare to ALLI Data - Reddit API call parameters for any data mismatch

Performance Metrics (to be added)

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.