Meta Marketing API

Ads Insights

Ads reporting and analytics with Facebook's Ads Insights APIs.

  • Before you run ads, configure to track conversions. Conversions are events you want to measure such as someone visiting your site or adding an item to a cart.
  • Retrieve metrics using the Ads Insights API.

Before you can get data on your ad's performance, you should set up your ads to track the metrics you are interested in. For that, you can use URL Tags, Facebook Pixel, and the Mobile Conversions Endpoint.

iOS 14.5 Updates

In response to Apple’s new policy, we are announcing breaking changes that will affect Ads Insights endpoints.

To learn more about how Apple’s iOS 14.5 requirements will impact Facebook advertising, visit our Business Help Center aricles and our changelog:

Affected Endpoints

  • GET /{ad-account-id}/insights
  • GET /{ad-id}/insights
  • GET /{ad-set-id}/insights
  • GET /{campaign-id}/insights
  • POST /{ad-account-id}/insights
  • POST /{ad-id}/insights
  • POST /{ad-set-id}/insights
  • POST /{campaign-id}/insights

Measure Your Ad's Performance

Ad Insights API

Provides a single, consistent interface to retrieve statistics about Ads, Ad Sets, and Campaigns.

Offline Conversions API

Send offline conversion events and to see how many customers viewed or clicked Facebook ads before converting.

App Events API

To track events in your mobile app, use Facebook's server-side endpoint. Then, these events can be attributed back to Facebook ads.

Tracking Specs

Define actions you want to track for specific ads. By default, Facebook tracks certain actions based on your objective but you can add custom tracking.

Lift Study

Create and run an experiment to measure your Facebook campaign's efficiency.

Split Testing

Test different advertising strategies on mutually exclusive audiences to see what works.

URL Tags

Append strings to the link URL of an ad. Add to each ad's creative as you set the creative.

Facebook Pixel

Add this to your website to report actions on your site back to Facebook. Then, you can track actions on your site that occurred based on Facebook ads.

More Measurement Tools