> For the complete documentation index, see [llms.txt](https://docs.coupler.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coupler.io/sources/category/ppc/reddit-ads/data-overview.md).

# Data Overview

Reddit Ads in Coupler.io surfaces four entities covering everything from campaign configuration to day-by-day performance. Here's what each one contains.

## Entities

| Entity                       | Best for                                                   |
| ---------------------------- | ---------------------------------------------------------- |
| Campaign performance (daily) | Trend analysis, spend tracking, and optimization decisions |
| Campaigns                    | Budget management, objective tracking, campaign status     |
| Ad groups                    | Audience targeting review, bid strategy audits             |
| Ads                          | Creative performance, ad format analysis                   |

## Campaign performance (daily)

#### Performance metrics

| Metric          | Description                                   |
| --------------- | --------------------------------------------- |
| Impressions     | Number of times ads were shown                |
| Clicks          | Total clicks on ads                           |
| CTR             | Click-through rate (clicks ÷ impressions)     |
| Spend           | Total amount spent for the day                |
| CPM             | Cost per thousand impressions                 |
| CPC             | Cost per click                                |
| Conversions     | Total tracked conversion events               |
| Conversion rate | Share of clicks that resulted in a conversion |
| Video views     | Number of times video ads were viewed         |
| Date            | The calendar day the metrics apply to         |

#### Dimensions

| Dimension     | Description                            |
| ------------- | -------------------------------------- |
| Campaign ID   | Unique identifier for the campaign     |
| Campaign name | Human-readable campaign label          |
| Account ID    | The ad account the campaign belongs to |

## Campaigns

#### Campaign fields

| Field         | Description                                           |
| ------------- | ----------------------------------------------------- |
| Campaign ID   | Unique identifier                                     |
| Campaign name | Name of the campaign                                  |
| Status        | Active, paused, or archived                           |
| Objective     | Campaign goal (e.g., awareness, traffic, conversions) |
| Total budget  | Lifetime budget cap                                   |
| Daily budget  | Maximum daily spend                                   |
| Start date    | When the campaign is set to begin                     |
| End date      | When the campaign is set to end                       |

## Ad groups

#### Ad group fields

| Field              | Description                                                  |
| ------------------ | ------------------------------------------------------------ |
| Ad group ID        | Unique identifier                                            |
| Ad group name      | Name of the ad group                                         |
| Campaign ID        | Parent campaign                                              |
| Status             | Active, paused, or archived                                  |
| Bid strategy       | How bids are managed (manual, auto)                          |
| Targeting criteria | Subreddit, interest, keyword, and location targeting details |
| Daily budget       | Ad group-level spend cap                                     |

## Ads

#### Ad fields

| Field        | Description                             |
| ------------ | --------------------------------------- |
| Ad ID        | Unique identifier                       |
| Ad name      | Name of the ad                          |
| Ad group ID  | Parent ad group                         |
| Status       | Active, paused, or archived             |
| Ad format    | Promoted post, video, carousel, etc.    |
| Creative URL | Link to the ad creative or landing page |
| Headline     | Ad headline text                        |

## Common metric combinations

* **Spend + Impressions + CTR by date** — track daily efficiency trends over a campaign flight
* **Campaign budget vs. spend** — join Campaigns with Campaign performance (daily) to see pacing
* **Ad format vs. conversion rate** — compare performance across creative formats in the Ads entity
* **Ad group targeting + spend** — understand which audience segments are driving cost

## Use cases by role

{% tabs %}
{% tab title="Performance marketers" %}

* Export Campaign performance (daily) into Looker Studio to build a Reddit Ads performance dashboard
* Use Append in Coupler.io to combine Reddit Ads spend data with Google Ads and Meta Ads for a unified cross-channel view
* Monitor CTR and CPC trends day-over-day to catch underperforming campaigns early
  {% endtab %}

{% tab title="Media planners" %}

* Pull campaign budgets and objectives into a spreadsheet to track planned vs. actual spend
* Join the Campaigns entity with Campaign performance (daily) to see how each campaign is pacing against its budget
* Use the Ads entity to maintain a creative inventory and track which formats are active
  {% endtab %}

{% tab title="Analysts" %}

* Send daily performance data to BigQuery for long-term trend analysis and custom attribution modeling
* Pipe Reddit Ads metrics into ChatGPT or Claude to generate automated performance summaries
* Aggregate spend and conversions across multiple ad accounts using Coupler.io's Aggregate transformation
  {% endtab %}
  {% endtabs %}

## Platform-specific notes

* **CTR, CPM, CPC, and Conversion rate are not summable** — these are ratio metrics. Summing or averaging them across dates or campaigns produces incorrect results. To aggregate accurately, sum the underlying counts first (e.g., total clicks ÷ total impressions for CTR) and recalculate the ratio at the aggregation level.
* Date range parameters only apply to the **Campaign performance (daily)** entity — the other entities return current configuration data, not historical records
* If you manage multiple Reddit Ads accounts, you can specify all of them in the **Ad accounts** parameter to pull data from each in a single data flow
* Reddit Ads reporting data can have a delay of up to 24 hours, so very recent days may show incomplete numbers
* Reddit does not support breakdown dimensions (e.g., by device or placement) in the current Coupler.io integration — daily campaign-level data is the most granular available


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.coupler.io/sources/category/ppc/reddit-ads/data-overview.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.