Supermetrics Support Forum

Facebook Ads Field Deprecations - March 25th, 2020

**Update March 25th, 17:30 EEST - the fields have been deployed and should be generally available now. Due to caching, it may take 1-2 hours for them to appear. Please retry later if you are unable to see them immediately.**


In preparation for the sunset of Marketing Graph API v4.0 at the end of March, we will be deprecating fields that are no longer available in API version 5.0 and adding new fields that replace those being removed.


This will take effect on March 25th, 2020. 


The affected fields will be moved to the group "Deprecated". The fields will work as before until the 25th of March, 2020. After that the deprecated fields will return empty (NULL) values for all queries.


Here's a list of field names to be deprecated and their replacement field. Note that "Quality ranking" is already available in the connector and could be swapped before the deprecation date. The others will be added on March 25th.


Deprecated Field NameUse Instead...
Relevance score
Use "Quality ranking"
Relevance score status
Use "Quality ranking"
Leads (form)
Use "On-Facebook leads"
Cost per lead (form)
Use "Cost per on-Facebook lead"



When the changes take place on March 25th, 2020, please make sure you update your queries and formulas to remove the deprecated fields or use their replacements instead. For Data Studio, you will need to refresh your data source field list per How do I Refresh Fields/Update a Connector?


For BigQuery users - We will notify you about changes to the schemas in support of this field deprecation separately.


Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.