Available Data

1. Key Performance Indicators - including reach, spend, impressions, and clicks
2. Amount Spent - breakouts by age, gender, and location
3. Purchases - by Impressions, clicks, and spend
4. Campaign performance - by KPIs
   
5. Engagement metrics - ads, videos, and apps
   
6. Pixel Events - lead generation and live
7. Ad Set Performance - by KPI
   
8. Ad Engagement - broken down by likes, clicks, reacts, comments, saves, and shares
   
9. Video Engagement - broken down by plays, cost, and portion viewed
   
10. App Engagement - with cost per mobile and desktop install
    
11. Pixel Event Data - eCommerce and lead generation
    
12. Hourly data - pixels, impressions, and amount spent
    
13. Revenue by region - when UTM parameters are applied and data is exported to Google Analytics
    
14. Spend vs. revenue - when UTM parameters are applied and data is exported to Google Analytics
    
15. Complete List of Fields.
    

API Limitations

1. Purchase breakouts - by device and publisher platform
2. Offsite metrics
   
3. Daily sums for Reach and other "unique" metrics - reach and other metrics beginning with the prefix "unique" are live metrics and cannot be used in daily sums
   
4. Conversions by Country - no longer available following the iOS14 update
   
5. 37 month lifetime limit - Lifetime metrics reflect only 37 months of data. 
   
6. Custom fields - Custom fields are not available.
   

Connection Requirements

Your Facebook account must have Ad Analyst access for a successful connection.

Connector Configuration

In the connector configuration screen for Instagram Ads, you are able to select several different attribution options. 

You can choose between Ad Set (Default) or Account. Account refers to outdated settings that were removed as of January 19, 2022. However, some of our customers still use this setting to bypass the Ad Set attribution settings and default all Ad Sets to 7 day click, 1 day view. This can be a useful setting to use if you are having difficulty with Zero or Null Values in Instagram Ads Reports.

Your next option is "Is Campaign using SKAd Network?" SKAd Network is the default type of attribution that Facebook uses following the iOS14 update that occurred on April 26, 2021. This defaults to Get All Campaigns. You can also choose Yes and get only campaigns that use SKAd Network or No and get only campaigns that do not. 

Finally, you may also choose whether to allow Action Attribution Setting to be modified and whether campaign is using SKAd network to be modified. Choosing these options will allow for more flexibility within your report. However, if you are blending data with several sources, it will not work. Whatever settings you have chosen in the configuration screen will apply regardless of selecting these options when blending.

Backfilling

Get the most from your Facebook Ads connector

Use our free template

Create breakdowns by Objective

This feature is available in Facebook Ads Manager but not in the API. Here is a workaround that you can use.

Create a filter on your table. Choose Include > Campaign ID (ad sets, campaign insights, campaigns, insights) > RegExp Match.

Get more geo and cost data with Google Analytics

1. Use utm_source and utm_medium to report at the account level.
   
2. Use utm_campaign to get campaign-level reporting by region.
   
3. Use utm_content to report at the Ad Set level by region.