Skip to main content
Version: v3
POST 
/ad_accounts/:ad_account_id/reports

Generate a metrics report for up to 3 breakdowns (4 with country and region) based on the fields you provide.

Reports provide detailed insights and analytics on ad performance, audience engagement, and other relevant metrics.

Top combinations aren't currently supported. View these metrics in the Ads Manager.

Considerations​

  • Metrics default to Coordinated Universal Time (UTC). Change time zone by setting time_zone_id.
  • Filters can be added to limit entity types or conversion data. Learn about applying filters.
  • Some values are converted in your report. To return the value:

    The asterisk (*) represents any character(s). For example, CONVERSION*TOTAL_VALUE matches any metrics starting with CONVERSION and ending with TOTAL_VALUE.

    • Divide by 100: CONVERSION*TOTAL_VALUE
    • Divide by 1 million: SPEND, CPC, CPV, ECPM, APP_INSTALL*ECPA, APP_INSTALL_SKAN*, APP_INSTALL*REVENUE, and CONVERSION*ECPA
  • We recommend including the ad_id breakdown. Use joins in Get Ad to retrieve IDs.
  • Metrics may take up to 6 hours to stabilize. Conversion data continues updating as events occur.
  • Delivery data goes back by 24 months. Reach and frequency data start June 2024.

Rate Limit​

See the rate limits for Reporting

Policy Slug: ads-reporting
  • Window: 60 seconds
  • Quota: 60 requests

Request​

Responses​

A report.