Documentation

Restrictions for off-Facebook Action Metrics

Facebook Off-site action metrics with breakdowns are no longer available, except for metrics for app campaigns exclusively targeting Android or iOS 14.4.

Learn more about restrictions for off-Facebook Action Metrics in the official Facebook documentation.

Leads metric discrepancy

We have several metrics related to leads in almost in all of our reports:

• ```lead``` (```action.offsite_conversion.fb_pixel_lead.value```) - Off-site leads
• ```lead_grouped``` (```actions.onsite_conversion.lead_grouped.value```) - On-Facebook leads
• ```leads``` (```actions.lead.value```) - should be a summary of Off-site leads and On-Facebook leads

Important: For some campaigns, in reports with special breakdowns (```publisher_platform```, ```platform_posintion```, etc.), ```leads``` metric will be 0. Learn more here.

Campaign's daily budget is 100 times greater than in UI

Facebook API returns daily_budget in cents. For example, we retrieve ```daily_budget = 1000``` while the daily budget value in the Facebook UI is 10. You can find a budget value that is the same as in the Facebook UI in the calculated field ```daily_budget_with_offset``` which is calculated as ```daily_budget/100```.

Empty value in video actions in reports with “region” or “dma”

The following actions do not support for dma and region dimensions:

• ```video_p25_watched_actions```
• ```video_p50_watched_actions```
• ```video_p75_watched_actions```
• ```video_p95_watched_actions```
• ```and video_p100_watched_actions```

Learn more in the official Facebook documentation.

Discrepancy in Reach metric

In Facebook Ads Manager, the total reach of your campaigns in a report is calculated as the number of people who saw your ads at least once and not as a sum of every campaign’s reach.

How Reach metric is calculated for a date range

The Reach metric cannot be summarized across all dates within a particular range. For instance, if User A sees an ad on Day 1, Day 2, and Day 3, the total reach for the date range [Day 1 - Day 3] will be counted as ```1``` user.

However, in the daily report with the date breakdown, each day will show a reach of ```1```, resulting in a total of ```3```.

This discrepancy occurs because Reach can only be compared on specific dates and with an exact level of granularity. Even when using Weekly/Monthly reports, this behavior still applies.

How Reach metric is calculated for your campaigns

Similarly, the Reach metric cannot be summarized across all campaigns. Let's consider the example below, where we can see the Reach of seven different campaigns.

If we add them to a single report, we’ll get the following:

After adding up all Reach values, we’ll get a total of ```23```, even though there are just ```17``` users. As we can see, it is possible for a single user to be counted in two or more campaigns.

Missing Facebook destination URLs

Meta API only retrieves ```website_destination_url``` on ```links_url``` with ```ad_formats``` set as ```AUTOMATIC_FORMAT```. For other formats, this field is not populated on API.

Empty values in creative_page_id

```creative_page_id``` property may have empty values for ads created as a promoted post.

Solution

To retrieve the ```page_id```, we recommend calculating the value using the ```effective_object_story_id``` column.

Example for SQL or BI tools:

```creative_page_id = split(effective_object_story_id, '_')[0]```

Missing "Creative Page ID" in "Ads Creative" report type

For the Ads Creative report, the ```creative_page_id``` field has blank values for ads that were created as a promoted post. This is the platform limitation, which makes different field formats for promoted posts and ads.

Custom events are not pulling in

Solution

To start extracting custom events, you need to specify it in your extraction order settings.

1. Go to the Settings tab in your problematic extraction order.
2. Fill in the Facebook App Custom Events to Load or Facebook Pixel Custom Events to Load field with the specific names of the Facebook custom events you want to extract.
3. Don't forget to click the Update button to save your changes.

Inactive campaigns in Facebook

When you review your campaign data, you might notice discrepancies between the data in Improvado and what you see on the Facebook (Meta) UI. This is because we extract and store data for all campaign statuses - ```ACTIVE```, ```PAUSED```, ```ARCHIVED```, ```DELETED```, etc.

Solution

Include archived entities in Facebook reporting:

• Adjust your Facebook reporting settings to include archived entities.

Filter out archived entities from your visualizations:

• Use the ```effective_status``` field to exclude statuses such as ```ARCHIVED``` and ```DELETED```.

Invalid credentials

Expired token

{%docs-informer error%}

You cannot access the app till you login to www.facebook.com and follow the instructions given. Error code: 190.

{%docs-informer-end%}

This error can happen due to one of these two things:

1. The user changed the password, invalidating existing access tokens.
2. ~Common for companies that have password rotations every 30-90 days.
3. Your Access Token has expired due to time constraints set by the Facebook API.
4. ~User Access Tokens - a long-lived token generally lasts for about 60 days.

To fix this issue, re-connect your Facebook account with the current credentials. Learn more.

‍