This document contains frequently asked questions that arise when using the Facebook Ads data source. You can quickly navigate to a particular FAQ by using the table of contents below.
Can I get my Instagram Ads data through the Facebook Ads connector?
Why is Reach so inflated in TapClicks?
What is the Lifetime Reach metric?
How does Reach MTD in Facebook Ads differ from Reach?
What permissions are needed for Facebook Ads?
What are Facebook metrics naming conventions?
What fields (metrics) are available?
What data can I assign to my Tap Client from this data source?
Can I get my Instagram Ads data through the Facebook Ads connector?
You can see your Instagram Ads data in the “Platform” data view, which is a child of the Ads data view. This should allow you to build the visualizations you’re looking for.
Why is Reach so inflated in TapClicks?
The "Reach" and "Frequency" fields are stored on a daily basis. When looking at a range, this value may differ from the source and in some cases be very inflated.
Example :
Day 1 : Reach = 50
Day 2 : Reach = 150
Day 3 : Reach = 0
Day 4 : Reach = 75
In our system, we store Reach value daily.
Total Daily Reach = sum of those values: 50+150+0+75=275
Avg. Daily Reach = (sum of non-0 value) / (count of non-0 days) = (50+150+75) / 3 = 92
What is the Lifetime Reach metric?
The Facebook UI and API gives users the option to pull Reach data “lifetime” for an object (Ad, Campaign etc.), where you don’t have to pass in a date range. TapClicks created the Lifetime Reach metric as an alternative to the other Reach options in the platform like Avg. Daily Ad Reach (which averages the reach value that is stored by day); Total Ad Reach (which sums the reach value that is stored by day); and Reach MTD (which shows you the monthly reach to date for the month in the end date of your date range selector). We created Lifetime Reach to provide you with more options for reporting.
When working in TapClicks, the value for Lifetime Reach is based on the end date in the date range you select within the dashboard. If you specify a date range from Jan 1 to Dec 31, then the Lifetime Reach from Dec 31 will be displayed. If you choose Jan 1 to Jun 1, then the value from Jun 1 will be displayed. Lifetime Reach is an optional turn-on because it does require additional API calls to Facebook, which increases fetch time. Once enabled, the lifetime metrics will be stored in the database for your reference. Based on the nature of the way this data is returned by Facebook, there is no way to get the lifetime values for days before the metric was enabled.
How does Reach MTD in Facebook Ads differ from Reach?
The Reach MTD field is the month-to-date value for the given day within a single month. So, when looking in TapClicks, the date at the end of your date range within a given month will reflect the Reach to date when summing the values for each day up to that day. Whereas Reach is a value we store on a daily basis and is summed across any date range, rather than being limited to a monthly cycle.
Example:
You are looking at the date range of December 1st - 15th in TapClicks. The Reach MTD field will show you the Reach value that is stored on the 15th.
So if you had the follow Reach values in Facebook Ads:
Dec. 1 - 10
Dec. 2 - 10
Dec. 3 - 10
Dec. 4 - 10
Dec. 5 - 5
Dec. 6 - 5
Dec. 7 - 5
Dec. 8 - 5
Dec. 9 - 10
Dec. 10 - 10
Dec. 11 - 10
Dec. 12 - 10
Dec. 13 - 5
Dec. 14 - 5
Dec. 15 - 5
Reach MTD value in TapClicks would be 115.
Good to note though is that this value will only work correctly when looking within a single month.
What permissions are needed for Facebook Ads
When you connect credentials for Facebook Ads, the system will go through the normal oAuth process. When the native platform loads and asks you to select permissions, we require the below permissions to be selected in order to get the data to flow into the dashboard.
- Public Profile
- Read Insights
- Manage Pages
- Ads Management
What are Facebook metrics naming conventions?
Periodically, data sources will change or update the names of the metrics. This is a list of legacy and new metric naming conventions used by Facebook.
Old Name |
New Name |
Account |
Account Name |
Ad Set |
Ad Set Name |
Campaign |
Campaign Name |
Starts |
Campaign Starts |
Ends |
Campaign Ends |
Cost |
Cost per Result |
Spent Today |
Amount Spent Today |
Cost per All Actions |
Cost per Any Action |
Unique Clicks to Link |
Unique Link Clicks |
CPC (Link) |
CPC (Cost per Link Click) |
Cost per Unique Click to Link |
Cost per Unique Link Click |
CTR (Link) |
CTR (Link Click-Through Rate) |
Unique CTR (Link) |
Unique CTR (Link Click-Through Rate) |
Canvas View Duration |
Canvas View Time |
Canvas Component Duration Percentage |
Canvas Component Time Percentage |
Mobile App Starts |
Mobile App Sessions |
Mobile App Payment Details |
Mobile App Adds of Payment Info |
Mobile App Registrations |
Mobile App Registrations Completed |
Mobile App Checkouts |
Mobile App Checkouts Initiated |
Mobile App Feature Unlocks |
Mobile App Achievements Unlocked |
Mobile App Level Achievements |
Mobile App Levels Completed |
Mobile App Ratings |
Mobile App Ratings Submitted |
Mobile App Credit Spends |
Mobile App Credits Spent |
Mobile App Tutorial Completions |
Mobile App Tutorials Completed |
Unique Mobile App Starts |
Unique Mobile App Sessions |
Unique Mobile App Payment Details |
Unique Mobile App Adds of Payment Info |
Unique Mobile App Registrations |
Unique Mobile App Registrations Completed |
Unique Mobile App Checkouts |
Unique Mobile App Checkouts Initiated |
Unique Mobile App Feature Unlocks |
Unique Mobile App Achievements Unlocked |
Unique Mobile App Level Achievements |
Unique Mobile App Levels Completed |
Unique Mobile App Ratings |
Unique Mobile App Ratings Submitted |
Unique Mobile App Credit Spends |
Unique Mobile App Credits Spent |
Unique Mobile App Tutorial Completions |
Unique Mobile App Tutorials Completed |
Mobile App Starts Conversion Value |
Mobile App Sessions Conversion Value |
Mobile App Payment Details Conversion Value |
Mobile App Adds of Payment Info Conversion Value |
Mobile App Registrations Conversion Value |
Mobile App Registrations Completed Conversion Value |
Mobile App Checkouts Conversion Value |
Mobile App Checkouts Initiated Conversion Value |
Mobile App Achievement Unlocks Conversion Value |
Mobile App Achievements Unlocked Conversion Value |
Mobile App Level Achievements Conversion Value |
Mobile App Levels Completed Conversion Value |
Mobile App Ratings Conversion Value |
Mobile App Ratings Submitted Conversion Value |
Mobile App Credit Spends Conversion Value |
Mobile App Credits Spent Conversion Value |
Mobile App Tutorial Completions Conversion Value |
Mobile App Tutorials Completed Conversion Value |
Cost per Mobile App Start |
Cost per Mobile App Session |
Cost per Mobile App Payment Detail |
Cost per Mobile App Add of Payment Info |
Cost per Mobile App Add to Cart |
Cost per Mobile App Add to Cart |
Cost per Mobile App Add to Wishlist |
Cost per Mobile App Add to Wishlist |
Cost per Mobile App Registration |
Cost per Mobile App Registration Completed |
Cost per Mobile App Checkout |
Cost per Mobile App Checkout Initiated |
Cost per Mobile App Feature Unlock |
Cost per Mobile App Achievement Unlocked |
Cost per Mobile App Level Achievement |
Cost per Mobile App Level Completed |
Cost per Mobile App Rating |
Cost per Mobile App Rating Submitted |
Cost per Mobile App Credit Spend |
Cost per Mobile App Credit Spent |
Cost per Mobile App Tutorial Completion |
Cost per Mobile App Tutorial Completed |
Cost per Unique Mobile App Start |
Cost per Unique Mobile App Session |
Cost per Unique Mobile App Payment Detail |
Cost per Unique Mobile App Add of Payment Info |
Cost per Unique Mobile App Add to Cart |
Cost per Unique Mobile App Add to Cart |
Cost per Unique Mobile App Add to Wishlist |
Cost per Unique Mobile App Add to Wishlist |
Cost per Unique Mobile App Registration |
Cost per Unique Mobile App Registration Completed |
Cost per Unique Mobile App Checkout |
Cost per Unique Mobile App Checkout Initiated |
Cost per Unique Mobile App Feature Unlock |
Cost per Unique Mobile App Achievement Unlocked |
Cost per Unique Mobile App Level Achievement |
Cost per Unique Mobile App Level Completed |
Cost per Unique Mobile App Rating |
Cost per Unique Mobile App Rating Submitted |
Cost per Unique Mobile App Credit Spend |
Cost per Unique Mobile App Credit Spent |
Cost per Unique Mobile App Tutorial Completion |
Cost per Unique Mobile App Tutorial Completed |
Website Actions (All) |
Website Conversions |
Add Payment Info (Facebook Pixel) |
Website Adds of Payment Info |
Add to Cart (Facebook Pixel) |
Website Adds to Cart |
Add to Wishlist (Facebook Pixel) |
Website Adds to Wishlist |
Complete Registration (Facebook Pixel) |
Website Registrations Completed |
Initiate Checkout (Facebook Pixel) |
Website Checkouts Initiated |
Lead (Facebook Pixel) |
Website Leads |
Purchase (Facebook Pixel) |
Website Purchases |
Search (Facebook Pixel) |
Website Searches |
View Content (Facebook Pixel) |
Website Content Views |
Adds To Cart (Conversion Tracking Pixel) |
Website Adds to Cart (Conversion Tracking Pixel) |
Checkouts (Conversion Tracking Pixel) |
Website Checkouts (Conversion Tracking Pixel) |
Key Web Page Views (Conversion Tracking Pixel) |
Website Key Page Views (Conversion Tracking Pixel) |
Leads (Conversion Tracking Pixel) |
Website Leads (Conversion Tracking Pixel) |
Registrations (Conversion Tracking Pixel) |
Website Registrations (Conversion Tracking Pixel) |
Website Action Conversion Value (All) |
Website Conversion Value |
Add Payment Info Conversion Value (Facebook Pixel) |
Website Adds of Payment Info Conversion Value |
Add To Cart Conversion Value (Facebook Pixel) |
Website Adds to Cart Conversion Value |
Add To Wishlist Conversion Value (Facebook Pixel) |
Website Adds to Wishlist Conversion Value |
Complete Registration Conversion Value (Facebook Pixel) |
Website Registrations Completed Conversion Value |
Initiate Checkout Conversion Value (Facebook Pixel) |
Website Checkouts Initiated Conversion Value |
Lead Conversion Value (Facebook Pixel) |
Website Leads Conversion Value |
Purchase Conversion Value (Facebook Pixel) |
Website Purchases Conversion Value |
Search Conversion Value (Facebook Pixel) |
Website Searches Conversion Value |
View Content Conversion Value (Facebook Pixel) |
Website Content Views Conversion Value |
Adds To Cart Conversion Value (Conversion Tracking Pixel) |
Website Adds to Cart Conversion Value (Conversion Tracking Pixel) |
Checkouts Conversion Value (Conversion Tracking Pixel) |
Website Checkouts Conversion Value (Conversion Tracking Pixel) |
Key Web Page Views Conversion Value (Conversion Tracking Pixel) |
Website Key Page Views Conversion Value (Conversion Tracking Pixel) |
Leads Conversion Value (Conversion Tracking Pixel) |
Website Leads Conversion Value (Conversion Tracking Pixel) |
Registrations Conversion Value (Conversion Tracking Pixel) |
Website Registrations Conversion Value (Conversion Tracking Pixel) |
Cost per Website Action (All) |
Cost per Website Conversion |
Cost per Add Payment Info (Facebook Pixel) |
Cost per Website Add of Payment Info |
Cost per Add To Cart (Facebook Pixel) |
Cost per Website Add to Cart |
Cost per Add To Wishlist (Facebook Pixel) |
Cost per Website Add to Wishlist |
Cost per Complete Registration (Facebook Pixel) |
Cost per Website Registration Completed |
Cost per Initiate Checkout (Facebook Pixel) |
Cost per Website Checkout Initiated |
Cost per Lead (Facebook Pixel) |
Cost per Website Lead |
Cost per Purchase (Facebook Pixel) |
Cost per Website Purchase |
Cost per Search (Facebook Pixel) |
Cost per Website Search |
Cost per View Content (Facebook Pixel) |
Cost per Website Content Views |
Cost per Add To Cart (Conversion Tracking Pixel) |
Cost per Website Add to Cart (Conversion Tracking Pixel) |
Cost per Checkout (Conversion Tracking Pixel) |
Cost per Website Checkout (Conversion Tracking Pixel) |
Cost per Key Web Page View (Conversion Tracking Pixel) |
Cost per Website Key Page View (Conversion Tracking Pixel) |
Cost per Lead (Conversion Tracking Pixel) |
Cost per Website Lead (Conversion Tracking Pixel) |
Cost per Registration (Conversion Tracking Pixel) |
Cost per Website Registration (Conversion Tracking Pixel) |
Add Payment Info (Offline Conversion) |
Offline Adds of Payment Info |
Add To Cart (Offline Conversion) |
Offline Adds to Cart |
Add To Wishlist (Offline Conversion) |
Offline Adds to Wishlist |
Complete Registration (Offline Conversion) |
Offline Registrations Completed |
Initiate Checkout (Offline Conversion) |
Offline Checkouts Initiated |
Lead (Offline Conversion) |
Offline Leads |
Other (Offline Conversion) |
Offline Other Conversions |
Purchase (Offline Conversion) |
Offline Purchases |
Search (Offline Conversion) |
Offline Searches |
View Content (Offline Conversion) |
Offline Content Views |
Add Payment Info Conversion Value (Offline Conversion) |
Offline Adds of Payment Info Conversion Value |
Add To Cart Conversion Value (Offline Conversion) |
Offline Adds to Cart Conversion Value |
Add To Wishlist Conversion Value (Offline Conversion) |
Offline Adds to Wishlist Conversion Value |
Complete Registration Conversion Value (Offline Conversion) |
Offline Registrations Completed Conversion Value |
Initiate Checkout Conversion Value (Offline Conversion) |
Offline Checkouts Initiated Conversion Value |
Lead Conversion Value (Offline Conversion) |
Offline Leads Conversion Value |
Other Conversion Value (Offline Conversion) |
Offline Other Conversion Value |
Purchase Conversion Value (Offline Conversion) |
Offline Purchases Conversion Value |
Search Conversion Value (Offline Conversion) |
Offline Searches Conversion Value |
View Content Conversion Value (Offline Conversion) |
Offline Content Views Conversion Value |
Cost Per Add Payment Info (Offline Conversion) |
Cost per Offline Add of Payment Info |
Cost Per Add To Cart (Offline Conversion) |
Cost per Offline Add to Cart |
Cost Per Add To Wishlist (Offline Conversion) |
Cost per Offline Add to Wishlist |
Cost Per Complete Registration (Offline Conversion) |
Cost per Offline Registration Completed |
Cost Per Initiate Checkout (Offline Conversion) |
Cost per Offline Checkout Initiated |
Cost Per Lead (Offline Conversion) |
Cost per Offline Lead |
Cost Per Other (Offline Conversion) |
Cost per Offline Other Conversion |
Cost Per Purchase (Offline Conversion) |
Cost per Offline Purchase |
Cost Per Search (Offline Conversion) |
Cost per Offline Search |
Cost Per Content View (Offline Conversion) |
Cost per Offline Content Views |
App Uses |
Desktop App Uses |
App Story Engagement |
Desktop App Story Engagement |
App Installs |
Desktop App Installs |
App Engagement |
Desktop App Engagement |
Cost per App Use |
Cost per Desktop App Use |
Cost per App Story Engagement |
Cost per Desktop App Story Engagement |
Cost per App Install |
Cost per Desktop App Install |
Cost per App Engagement |
Cost per Desktop App Engagement |
What fields (metrics) are available?
After you connect a data source to TapClicks, you can use that data in your reports. These fields are organized into groups of similar types of data called Data Views. You can view all fields and data views for a given data source in the Connector Marketplace. For Facebook Ads, you will find a list of all dimensions and metrics available for use in TapClicks, organized by data view, here: Facebook Ads metrics in the Connector Marketplace.
What data can I assign to my Tap Client from this data source?
Level 1 - Account
Level 2 - Campaign