# Reddit Ads

> Reddit Ads is an online advertising platform where advertisers bid to display promoted Reddit posts.

Reddit Ads shows you campaign impressions and clicks, but connecting ad spend to actual revenue and customer behavior means juggling Google Analytics, your CRM, and payment data.

Filament links Reddit Ads to your other tools and answers questions about campaign ROI, conversion paths, and customer acquisition costs in plain English.

## Data we sync

- **Account Metadata**: Track account structure and permissions with account_id, advertiser_name, currency, timezone, and user_roles. (`account_id`, `advertiser_name`, `currency`, `timezone`, `user_roles`)
- **Campaign Performance**: Monitor campaign metrics with campaign_id, campaign_name, status, daily_budget, lifetime_budget, and objective_type. (`campaign_id`, `campaign_name`, `status`, `daily_budget`, `lifetime_budget`, `objective_type`)
- **Ad Group Statistics**: Analyze ad group performance with ad_group_id, ad_group_name, bid_amount, targeting_type, and optimization_goal. (`ad_group_id`, `ad_group_name`, `bid_amount`, `targeting_type`, `optimization_goal`)
- **Impression and Click Data**: Track engagement metrics with impressions, clicks, click_through_rate, spend, and effective_cost_per_click. (`impressions`, `clicks`, `click_through_rate`, `spend`, `effective_cost_per_click`)
- **Conversion Events**: Measure conversion performance with conversion_event_name, conversion_count, conversion_value, cost_per_conversion, and conversion_rate. (`conversion_event_name`, `conversion_count`, `conversion_value`, `cost_per_conversion`, `conversion_rate`)
- **Promoted Post Details**: Review creative performance with post_id, post_title, post_url, subreddit_targeting, and creative_type. (`post_id`, `post_title`, `post_url`, `subreddit_targeting`, `creative_type`)
- **Audience Targeting**: Understand targeting parameters with interest_categories, location_targeting, device_types, age_range, and gender. (`interest_categories`, `location_targeting`, `device_types`, `age_range`, `gender`)
- **Daily Performance Reports**: Track daily trends with date, campaign_id, impressions, clicks, spend, conversions, and revenue. (`date`, `campaign_id`, `impressions`, `clicks`, `spend`, `conversions`, `revenue`)

## How do I connect Reddit Ads?

You need an active Reddit Ads account. Authorisation requests `adsread` for advertising data and `identity` for your Reddit identity.

1. Open [Apps](https://filamentanalytics.com/apps) in Filament and add **Reddit Ads**.
2. Select **Authorize**, sign in to Reddit and approve access.
3. Choose all accounts, or specific accounts and select those to include.
4. Set the reporting history to import. Reddit provides up to two years of reporting data.

### Optional custom reports

Select **+ Add report** and give it a unique name. Choose up to two breakdowns and either the account’s time zone or a custom time zone. The `REGION` breakdown automatically includes `COUNTRY` without using another breakdown slot.

Choose the fields to include; leaving the selection empty includes all available fields. Enable **Include event conversions data** for conversions, select events if needed, and enable **Include custom events** to include those too. Repeat for additional reports.

Select **Save & Test**, then return to Filament and complete setup.
