We have upgraded our Facebook Ad Insights connector from version 10.0 to 11.0 of the Facebook Marketing API. Learn more about the changes in the Facebook Marketing API v11.0 changelog.
We sunset our Facebook Ad Insights connector and replaced it with the new Facebook Ads connector that allows to sync reporting data as well as metadata. We will continue to support existing Facebook Ad Insights connectors by gradually migrating them to the new Facebook Ads connector.
We have upgraded our Facebook Ad Insights connector from version 9.0 to 10.0 of the Facebook Marketing API. Learn more about the changes in the Facebook Marketing API v10.0 changelog.
We have changed the data type of the
instant_experience_outbound_clicks field from
List<AdsActionStats> to support the new Facebook API version. Now, the field provides detailed information about the number of clicks on links in an Instant Experience that take users off Facebook-owned properties. To ensure data integrity, re-sync any reports where you have used this field.
We have upgraded our Facebook Ad Insights connector from version 7.0 to 9.0 of the Facebook Marketing API and handled deprecations and updates. Learn more about the deprecations and changes in the Facebook Marketing API v8.0 changelog and Facebook Marketing API v9.0 changelog.
We have deprecated the 28 days click and view attribution windows to support Facebook API changes.
We have updated the default click attribution window to 7 days and the view attribution window to 1 day to support Facebook API changes.
You can now opt to specify no attribution window or select a single attribution window when you configure the connector. Depending on your requirements, set both or either of the Click Attribution Window and View Attribution Window fields to NONE in the connector setup form.
We have added support for the
We have added a new table,
IMAGE_CROPS. This table stores the
image_crops values that are part of the
image_asset breakdown response.
Note: Fivetran only syncs the
IMAGE_CROPStable if you have selected the
We now support the
conversion value of the
action_report_time parameter. Previously, we retrieved your data using the default value
impression. In the connector setup form, set the Show Advanced Options toggle to ON and then select the value you want to use.
We have changed the data type of the following fields from LONG to DOUBLE:
We have made the
account_id field mandatory for all levels.
We have removed support for the following fields because Facebook has deprecated them:
We have replaced the
video_10_sec_watched_actions field with
video_thruplay_watched_actions in the
ACTION_VIDEO_VIEW_TYPE tables per Facebook’s replacement guidelines.
For more information, see the Facebook Changelog.
We have added support for following fields and action_breakdowns:
We now sync ads with the
WITH_ISSUES Facebook status. Previously we omitted ads with either of these statuses.
You can now select how many months of reporting data you’d like to include in your initial sync. Choose from the following options:
- 3 months
- 6 months (default)
- 12 months
- 24 months
- All time
We have upgraded both the Facebook Graph API and the Facebook Marketing API to version 4.0. For more details, see Facebook’s API documentation.
We have added a new prebuilt report,
We have deprecated two prebuilt reports,
We no longer support the following fields because Facebook has deprecated them:
We have removed the deprecated fields (
video_avg_percent_watched_actions) from two prebuilt reports,
We will sunset service versions 3, 4, and 5 of our Facebook Ad Insights on October 1, 2019.
You need to upgrade to our newest version, service version 6, by October 1, 2019. To upgrade, create a new Facebook Ad Insights connector and sync into a new schema.
The newest version of the Facebook Ad Insights connector supports daily, weekly and monthly aggregation with prebuilt reports. This new implementation generates a new schema. You can review the schema information in our docs.
- You can now configure your Facebook Ad Insights connector through the Fivetran REST API. This feature is in BETA and available only for Standard and Enterprise accounts.
We have added an option to select your report configuration type in our setup form. You can use it to sync standard prebuilt reports.
Now supports week and month aggregations.
Now supports multiple accounts with the same name.
We have removed the following tables from Facebook Ad Insights. They are now included in the Facebook Ad Account connector with much more detail:
We have upgraded the Facebook Marketing API to version 3.2.
As Facebook has deprecated the
total_action_value field, we will no longer support it. (https://developers.facebook.com/docs/graph-api/changelog/version3.2#marketing-api)
Facebook has deprecated a number of fields, so we will no longer support them. You can find a complete list of deprecated fields in Facebook’s API Changelog.
We have added additional information about the following features to our Facebook Ad Insights documentation:
- Prebuilt reports
- Generic, hourly, and action breakdowns
- Possible combinations of generic, hourly, and action breakdowns
Occasionally, export jobs submitted to the Facebook API will fail randomly. We now re-try failed jobs three times.
We will no longer sync the
video_15_sec_watched_actions field, because Facebook has dropped it.