Ads Insights API Unique Metric Updates

We will be deprecating 100+ unique metrics from the Ads Insights API, impacting the API’s unique_actions and cost_per_unique_action_type fields, on October 30, 2024. Below, we will include the details that are relevant to the developer community, including a notification about deprecations that may be relevant to your application(s)’ integration with our platform.

For a complete list of all changes and their details, please visit our changelog.

Deprecations & Changes

Ads Insights API – Unique metrics deprecation

We will be deprecating a number of unique metrics from the Ads Insights API on Oct 30, 2024, after which the API’s unique_actions and cost_per_unique_action_type fields will no longer return several action_type breakdowns. Fields counting total actions, like actions and cost_per_action_type, are unaffected and will continue to support existing action_type breakdowns.

We are providing a 90-day notice to developers that these deprecations will be implemented on October 30, 2024, to give ample time to make any changes that may be necessary. To avoid disruption to your business, please review the list of deprecated metrics and ensure your business transitions away from using them.

With these updates, we aim to improve the quality and consistency of metrics we are providing for Meta ads. For continued insight into customer conversions, please see our recent updates to Attribution Windows, including first conversion attribution, available via the Ads Insights API’s action_attribution_window parameter.