When you connect OpenAI Ads, pick a report type that matches the question you want to answer. Report types are not interchangeable: fields and totals can differ, so compare Funnel to the matching view in OpenAI Ads.
Note: Funnel imports completed days only. Data for the current day is not included until the following day.
Which report type should you choose?
Report type | When to use it |
Insights: Campaign | Use this for daily campaign performance: spend, clicks, impressions, and conversions at the campaign level. Start here if you are unsure. |
Insights: Ad Group | Use this when you need the same daily metrics broken down by ad group, including campaign fields. |
Insights: Ad | Use this when you need daily performance at the individual ad, including campaign, ad group, and creative fields such as ad title, copy, and link. |
Conversions | Use this for daily conversion totals split by click-through and view-through attribution, including attributed sales. Choose Campaign, Ad Group, or Ad, then set the attribution windows. |
Conversion Events | Use this for one row per conversion event, such as |
For every report, choose Campaign, Ad Group, or Ad. Each combination of report and aggregation level is a separate data source.
Campaign Insights
Daily performance data aggregated at the campaign level.
Dimensions
Date: The date the data applies to.
Timezone: The timezone of the ad account.
Currency: The currency of the ad account.
Ad Account ID: The unique identifier for the ad account.
Ad Account Name: The name of the ad account.
Campaign ID: The unique identifier for the campaign.
Campaign Name: The name of the campaign.
Campaign Status: The current status of the campaign.
Campaign Start Time: The date and time the campaign started.
Campaign End Time: The date and time the campaign is scheduled to end.
Campaign Description: The description set on the campaign.
Country: Available when Breakdown is set to Country.
Device: Available when Breakdown is set to Device.
Platform: Available when Breakdown is set to Platform.
Metrics
Impressions: The number of times your ad was displayed.
Clicks: The number of clicks on your ad.
Spend: The amount spent in the account currency.
Conversions: Total conversions. Not available when Breakdown is set to Platform.
CTR: Click-through rate. Funnel calculates this as clicks divided by impressions.
CPC: Cost per click. Funnel calculates this as spend divided by clicks.
CPM: Cost per mille. Funnel calculates this as spend divided by impressions, multiplied by 1000.
Ad Group Insights
Daily performance data aggregated at the ad group level. Includes campaign dimensions plus ad group fields.
Dimensions
Date: The date the data applies to.
Timezone: The timezone of the ad account.
Currency: The currency of the ad account.
Ad Account ID: The unique identifier for the ad account.
Ad Account Name: The name of the ad account.
Campaign ID: The unique identifier for the campaign.
Campaign Name: The name of the campaign.
Campaign Status: The current status of the campaign.
Campaign Start Time: The date and time the campaign started.
Campaign End Time: The date and time the campaign is scheduled to end.
Campaign Description: The description set on the campaign.
Ad Group ID: The unique identifier for the ad group.
Ad Group Name: The name of the ad group.
Ad Group Status: The current status of the ad group.
Ad Group Description: The description set on the ad group.
Country: Available when Breakdown is set to Country.
Device: Available when Breakdown is set to Device.
Platform: Available when Breakdown is set to Platform.
Metrics
Impressions: The number of times your ad was displayed.
Clicks: The number of clicks on your ad.
Spend: The amount spent in the account currency.
Conversions: Total conversions. Not available when Breakdown is set to Platform.
CTR: Click-through rate. Funnel calculates this as clicks divided by impressions.
CPC: Cost per click. Funnel calculates this as spend divided by clicks.
CPM: Cost per mille. Funnel calculates this as spend divided by impressions, multiplied by 1000.
Ad Insights
Daily performance data aggregated at the individual ad. Includes campaign and ad group dimensions plus ad-specific fields.
Dimensions
Date: The date the data applies to.
Timezone: The timezone of the ad account.
Currency: The currency of the ad account.
Ad Account ID: The unique identifier for the ad account.
Ad Account Name: The name of the ad account.
Campaign ID: The unique identifier for the campaign.
Campaign Name: The name of the campaign.
Campaign Status: The current status of the campaign.
Campaign Start Time: The date and time the campaign started.
Campaign End Time: The date and time the campaign is scheduled to end.
Campaign Description: The description set on the campaign.
Ad Group ID: The unique identifier for the ad group.
Ad Group Name: The name of the ad group.
Ad Group Status: The current status of the ad group.
Ad Group Description: The description set on the ad group.
Ad ID: The unique identifier for the ad.
Ad Name: The name of the ad.
Ad Status: The current status of the ad.
Ad Review Status: The review or approval status of the ad.
Ad Copy: The body text of the ad.
Ad Title: The title of the ad.
Ad Link: The destination URL of the ad.
Country: Available when Breakdown is set to Country.
Device: Available when Breakdown is set to Device.
Platform: Available when Breakdown is set to Platform.
Metrics
Impressions: The number of times your ad was displayed.
Clicks: The number of clicks on your ad.
Spend: The amount spent in the account currency.
Conversions: Total conversions. Not available when Breakdown is set to Platform.
CTR: Click-through rate. Funnel calculates this as clicks divided by impressions.
CPC: Cost per click. Funnel calculates this as spend divided by clicks.
CPM: Cost per mille. Funnel calculates this as spend divided by impressions, multiplied by 1000.
Conversions
Dimensions
Campaign ID: The unique identifier for the campaign.
Campaign Name: The name of the campaign.
Campaign Status: The current status of the campaign.
Ad Group ID: The unique identifier for the ad group. Available in the Ad Group and Ad reports.
Ad Group Name: The name of the ad group. Available in the Ad Group and Ad reports.
Ad Group Status: The current status of the ad group. Available in the Ad Group and Ad reports.
Ad ID: The unique identifier for the ad. Available in the Ad report.
Ad Name: The name of the ad. Available in the Ad report.
Ad Status: The current status of the ad. Available in the Ad report.
Date: The reporting date. With Ad event time, this is the date of the ad event. With Conversion time, this is the date of the conversion.
Currency: The currency of the attributed value. Funnel uses the ad account currency when the platform does not send one.
Country: Available when Breakdown is set to Country.
Device: Available when Breakdown is set to Device.
Metrics
Conversions: Total conversions attributed to the selected campaign, ad group, or ad.
Click-through Conversions: Conversions attributed to a click.
View-through Conversions: Conversions attributed to a view.
Attributed Sales: Sales from orders attributed to the selected campaign, ad group, or ad.
Conversion Events
Dimensions
Campaign ID: The unique identifier for the campaign.
Campaign Name: The name of the campaign.
Campaign Status: The current status of the campaign.
Ad Group ID: The unique identifier for the ad group. Available in the Ad Group and Ad reports.
Ad Group Name: The name of the ad group. Available in the Ad Group and Ad reports.
Ad Group Status: The current status of the ad group. Available in the Ad Group and Ad reports.
Ad ID: The unique identifier for the ad. Available in the Ad report.
Ad Name: The name of the ad. Available in the Ad report.
Ad Status: The current status of the ad. Available in the Ad report.
Date: The reporting date. With Ad event time, this is the date of the ad event. With Conversion time, this is the date of the conversion.
Currency: The currency of the event value. Funnel uses the ad account currency when the platform does not send one. Empty when Event Value is empty.
Country: Available when Breakdown is set to Country.
Device: Available when Breakdown is set to Device.
Event Name: The name of the conversion event.
Event Kind: The type or category of the conversion event.
Metrics
Event Count: The number of times the conversion event occurred.
Event Click-through Conversions: Conversions for this event attributed to a click.
Event View-through Conversions: Conversions for this event attributed to a view.
Event Value: The total value attributed to this event.
Event Value Count: The number of attributed event values recorded.
Per-data-source settings
Breakdown
Breakdown applies to Insights, Conversions, and Conversion Events. None is the default.
Breakdown | Reports | Dimension added |
None | All | No extra dimension |
Country | All | Country |
Device | All | Device |
Platform | Insights only | Platform |
Attribution
When you configure a Conversions or Conversion Events data source, set how conversions are dated and which clicks and views count. Each data source uses one combination of these settings.
Setting | Options | Default |
Attribution time basis | Ad event time or Conversion time | Ad event time |
Click attribution window (days) | 7 days, 14 days, or 30 days | 30 days |
View-through attribution window (days) | 0 days (disabled) or 1 day | 1 day |
API documentation
For full field definitions and updates, see the OpenAI Ads API documentation.