OpenAI Ads predefined reports
Updated
info
This connector is currently in Early Access. Contact support for details.
The OpenAI Ads source in Data Integration comes with 15 predefined reports covering account and campaign structure, audiences, conversion tracking, and delivery insights. All reports are full refresh.
Account and structure
| Report | Description | Sync type |
|---|---|---|
| Ad accounts | Retrieves the ad accounts accessible to this API key. | Full refresh |
| Campaigns | Retrieves campaigns on the ad account, including status and budget settings. | Full refresh |
| Ad groups | Retrieves ad groups within the selected campaigns. Requires at least one campaign to be selected. | Full refresh |
| Ads | Retrieves individual ads within the selected campaigns. Ad groups are resolved automatically at runtime — no separate ad group selection is required. Requires at least one campaign to be selected. | Full refresh |
Audiences and conversions
| Report | Description | Sync type |
|---|---|---|
| Custom audiences | Retrieves custom audiences on the ad account. Optionally filter by intended use (exclusion, inclusion, or bid multiplier) and control the granularity of matched-user counts. | Full refresh |
| Conversion pixels | Retrieves conversion pixels defined on the ad account. | Full refresh |
| Conversion event settings | Retrieves conversion event configuration settings. | Full refresh |
| Conversions insights | Retrieves click-through and view-through attributed conversions per campaign. Requires at least one campaign to be selected. Optionally scope to a date range. | Full refresh |
Delivery insights
The four insights reports pull delivery metrics from the same endpoint, grouped at different aggregation levels. All support an optional date range to scope the pull, configurable time granularity (hourly, daily, monthly, or none for a single total), optional breakdown by segment (Product, Country, or Device), and a field selection to control which metric and metadata columns are returned.
| Report | Description | Sync type |
|---|---|---|
| Insights — ad account | Retrieves delivery metrics rolled up to the ad account level. Each row represents one time bucket (or the full window if granularity is set to none) optionally split by a breakdown segment. | Full refresh |
| Insights — campaign | Retrieves delivery metrics per campaign. Supports an optional include parameter to also return campaigns with zero impressions. | Full refresh |
| Insights — ad group | Retrieves delivery metrics per ad group. | Full refresh |
| Insights — ad | Retrieves delivery metrics per ad. Highest-cardinality of the four insights reports — use a narrow date range on scheduled syncs to control row volume. | Full refresh |
Account settings
| Report | Description | Sync type |
|---|---|---|
| Spend limit windows | Retrieves spend limit windows configured on the ad account. | Full refresh |
| Lead forms | Retrieves lead generation forms on the ad account. | Full refresh |
| Business agents | Retrieves business agents associated with the ad account. | Full refresh |
