Excel Add-In for Facebook Ads

Build 24.0.9060

Changelog

General Changes

DateBuild
Number
Change
Type
Description
09/03/20249012Facebook AdsAdded
  • Added the PixelAddToCart and PixelPurchase columns to the AdInsights view. These columns expose the offsite_conversion.fb_pixel_add_to_cart and offsite_conversion.fb_pixel_purchase action types.
08/12/20248990Facebook AdsAdded
  • Added the AutoDetectPageTokens connection property. By default, the driver continues to automatically gather page access tokens for mapping when necessary. This new property allows users to disable the automatic retrieval of page access tokens when executing queries that target specific Facebook pages.
07/17/20248964Facebook AdsAdded
  • Added the AsyncTimeout connection property, which specifies how long the driver should wait for results when submitting an asynchronous request for insights. If insights are not returned by the time specified in AsyncTimeout, an error message is returned.
06/22/20248939Facebook AdsAdded
  • Added the following columns to the Ads view: AdActiveTime, AdScheduledEndTime, AdScheduledStartTime, BidAmount, LastUpdatedByAppId, PreviewShareableLink, and SourceAdId.
05/23/20248909Facebook AdsAdded
  • The CustomConversions table now supports INSERT and UPDATE queries.
05/09/20248895GeneralChanged
  • The ROUND function previously did not accept negative precision values. That feature has now been restored.
04/25/20248881Facebook AdsChanged
  • Changed the default Graph API and Market API versions to 19.0.
03/15/20248840GeneralAdded
  • Created a new SQL function called STRING_COMPARE that provides java's String.compare() ability to SQL queries. Returns a number representative of the compared value of two strings
02/28/20248824Facebook AdsRemoved
  • Removed "region" breakdown from Demographic_DMA_Region_Report. Demographic_Region_Report covers the "region" breakdown.
02/21/20248817Facebook AdsAdded
  • Added the CustomConversions view.
02/14/20248810Facebook AdsAdded
  • Added the IgnoreValidationException connection property.
12/31/20238765ExcelAdded
  • Added support for dialect SELECT queries in UI, VBA, and UDF =CDATAQUERY function.
12/28/20238762Facebook AdsAdded
  • Added the BoostedObjectId column to the Campaigns view.
11/29/20238733GeneralChanged
  • The ROUND function doesn't accept the negative precision values anymore.

Changed
  • The returning types of the FDMonth, FDQuarter, FDWeek, LDMonth, LDQuarter, LDWeek functions are changed from Timestamp to Date.
  • The return type of the ABS function will be consistent with the parameter value type.
11/28/20238732GeneralAdded
  • Added the HMACSHA256 formatter to allow for secrets to be decoded if it is in base64 format
07/26/20238607Facebook AdsChanged
  • Changed the default Graph API and Market API versions to 17.0.
06/20/20238571GeneralAdded
  • Added the new sys_lastresultinfo system table.
06/12/20238563Facebook AdsAdded
  • Added the following predefined views to facilitate easier access to specific ad insights reporting: Action_Canvas_Component_Report, Action_Carousel_Card_Report, Action_Conversion_Device_Report, Action_Product_Id_Report, Action_Reactions_Report, Action_Video_Sound_Report, Action_Video_View_Type_Report, Basic_Ad_Set_Report, Basic_All_Levels_Report, Basic_Campaign_Report, Delivery_Device_Report, Delivery_Platform_Report, Demographic_Age_And_Gender_Report, Demographic_Age_Report, Demographic_Country_Report, Demographic_DMA_Region_Report, Demographic_Gender_Report, Demographic_Region_Report.
06/07/20238558Facebook AdsChanged
  • Changed the default Graph API and Market API versions to 16.0.
05/10/20238530ExcelAdded
  • Added the ability to cancel an in-progress test connection in the Connection Dialog Box.
04/29/20238519Facebook AdsRemoved
  • Removed the Version connection property. Graph API and Marketing API versions will now be managed internally by the driver, and updated as necessary in new driver releases per API deprecations.
04/25/20238515GeneralRemoved
  • Removed support for the SELECT INTO CSV statement. The core code doesn't support it anymore.
12/14/20228383GeneralChanged
  • Added the Default column to the sys_procedureparameters table.
12/09/20228378Facebook AdsAdded
  • Added the AdImages view for querying ad images associated with an ad account.

Changed
  • Changed the API version default of the Version property from 14.0 to 15.0.
11/14/20228353Facebook AdsAdded
  • Added the CreateAdInsightsReport stored procedure for the generation of custom ad insights reports.
10/25/20228333Facebook AdsAdded
  • Added retry method, governed by new RetryLevel connection property, for avoiding data limit API errors for ad insights requests. For Target-less queries executed at the ad account level, the driver will now attempt to retry initial data requests that encounter errors about requesting insights over too many rows by attempting to retry the request at a lower level of ad object. The deepest level of ad object to which the driver might retry is determined by the Level query parameter and RetryLevel connection property, in order of precedence.
09/30/20228308GeneralChanged
  • Added the IsPath column to the sys_procedureparameters table.
09/28/20228306ExcelAdded
  • Added a config file option STATUSBAR_UPDATE=TRUE. This indicates whether the Excel Add-In will update the Excel Status Bar with progress status on completed tasks. The default value is TRUE. This way, there is the option to NOT update the Status Bar by setting it to FALSE.
09/14/20228292ExcelChanged
  • Improved the User Experience of the Connection Editor by introducing a Basic tab for the most imporant connection properties.
03/17/20228111ExcelChanged
  • Changed the behavior so that auto-refreshing continues even if the worksheet is not active anymore or loses focus.
03/05/20228099ExcelAdded
  • Added support for inserting rows on tables when no primary key is defined on a given table.
02/19/20228085ExcelAdded
  • The button "Get Data -> From ProviderX" now displays a submenu with existing connections buttons and a separator, with the "New ProviderX Connection" button, if a connection exists. If no connections exist, then clicking "Get Data -> From ProviderX" will prompt the user to create a new connection before selecting the data.

Removed
  • In the "Table Selection" form, the "Source", "New Connection", "Connection", and "Edit Connection" fields are removed as they are out of the scope of the "Table Selection" form.
01/12/20228047Facebook AdsAdded
  • Added the following fields for AdCreatives: EffectiveInstagramMediaId, EffectiveInstagramStoryId, SourceInstagramMediaId.
12/31/20218035ExcelAdded
  • Added batch support for CDATAINSERT, CDATAUPDATE, and CDATADELETE user-defined functions.
11/11/20217985ExcelAdded
  • Added a config file option called RETRIEVE_DATA_ROWS_PERCOUNT. When getting data, this indicates how many rows will be populated into the sheet at a time. The default value is 1000.

Changed
  • Improved performance when loading data from Get Data/Refresh and the CDATAQUERY function.
11/03/20217977ExcelAdded
  • Added new VBA functions: GetLastErrorCode and GetLastError.
11/02/20217976Facebook AdsChanged
  • Updated the maximum pagesize to be unrestricted for all tables. Previously Facebook would throw exceptions if the pagesize was exceeded, but this seems to have been removed.
10/29/20217972ExcelAdded
  • Added new VBA functions: GetUpSertedRows, UpSertRows, UpSertAll and UpSert.

Changed
  • The "Update Rows" button will now update changes made to existing rows or insert newly created rows.

Removed
  • The "Add Rows" button has been removed.
10/26/20217969Facebook AdsChanged
  • The default API version is updated to 12.0.
10/14/20217957Facebook AdsAdded
  • Added the TargetingDevicePlatforms, TargetingPublisherPlatforms, and TargetingInstagramPositions to the drivers.
09/28/20217941ExcelAdded
  • When loading data, table columns are auto-fitted to display all cells' content. In cases when cells have large amounts of text and the table has many rows, this operation might be slow.
  • Added a config file option DISABLE_AUTOFIT_COLUMN. Setting DISABLE_AUTOFIT_COLUMN==TRUE will speed up the process in those cases. The default value is FALSE.

Changed
  • Changed the maximum characters that a cell can retreive from the data source from 8,192 to 32,767.
09/27/20217940Facebook AdsAdded
  • Added extra columns for Dimension, Hierarchy and OLAPType to sys_tablecolumns for OLAP properties.
09/02/20217915GeneralAdded
  • Added support for the STRING_SPLIT table-valued function in the CROSS APPLY clause.
08/07/20217889GeneralChanged
  • Added the KeySeq column to the sys_foreignkeys table.
08/06/20217888GeneralChanged
  • Added the new sys_primarykeys system table.
07/26/20217877ExcelAdded
  • You can sort and reorder columns on the "CData Query" form to alter the sort order.
07/23/20217874GeneralChanged
  • Updated the Literal Function Names for relative date/datetime functions. Previously, relative date/datetime functions resolved to a different value when used in the projection as opposed to the predicate. For example: SELECT LAST_MONTH() AS lm, Col FROM Table WHERE Col > LAST_MONTH(). Formerly, the two LAST_MONTH() methods would resolve to different datetimes. Now, they will match.
  • As a replacement for the previous behavior, the relative date/datetime functions in the criteria may have an 'L' appended to them. For example: WHERE col > L_LAST_MONTH(). This will continue to resolve to the same values that were previously calculated in the criteria. Note that the "L_" prefix will only work in the predicate - it not available for the projection.
07/21/20217872ExcelRemoved
  • Removed support for .NET 3.5. Before upgrade/downgrade, a clean uninstall and then the same product versions install should be performed. So, if you want to downgrade, all the downgrade build versions must support .NET 3.5. If you want to upgrade, all the upgrade build versions will drop .NET 3.5 support.
07/06/20217857ExcelAdded
  • Added a config file option REPLACE_SYSTEM_LOCALE=TRUE. This indicates whether Office culture replaces system locale. The default value is TRUE. This way, there is the option to disable overriding system locale by setting it to FALSE.
06/26/20217847ExcelAdded
  • Added the ability to move the columns up and down on the "CData Query" form grid view and change their order via the UI.
06/24/20217845ExcelAdded
  • Added the default parameter "showPopups" so the user may decide whether to show popups when calling VBA functions.
06/14/20217835Facebook AdsChanged
  • The default API version is updated to 11.0.
  • Facebook has removed access from apps to return comment ids when the user does not also have permissions to moderate the comments. This may mean in some cases comments will stop returning with our driver when they were working previously.
  • The user_likes and user_posts permissions (no longer used by default with the embedded driver) now have much more difficult requirements to access them from Facebook.
  • Nearly all unique page type columns for the Pages table were deprecated by Facebook. For example, Parking columns, GeneralInfo, Attire, Restaurant Services columns, Awards, etc. These will all start returning null as Facebook transitions to the New Page Experience. These columns will be removed in the 2022 release of the driver.
05/21/20217811ExcelAdded
  • A new UI implementation is added for "in" and "not in" filter options on the "CData Query" form. The user is able to select via an interface from a list of distinct column values.
04/25/20217785GeneralAdded
  • Added support for handling client side formulas during insert / update. For example: UPDATE Table SET Col1 = CONCAT(Col1, " - ", Col2) WHERE Col2 LIKE 'A%'
04/23/20217783GeneralChanged
  • Updated how display sizes are determined for varchar primary key and foreign key columns so they will match the reported length of the column.
04/16/20217776GeneralAdded
  • Non-conditional updates between two columns is now available to all drivers. For example: UPDATE Table SET Col1=Col2
04/16/20217776GeneralChanged
  • Reduced the length to 255 for varchar primary key and foreign key columns.

Changed
  • Updated index naming convention to avoid duplicates.
04/13/20217773Facebook AdsChanged
  • Updated the default Version to 10.0.
  • On the AdsInsights and AdInsightsActions tables, the date_preset input available input value of "lifetime" is changed to "maximum" to comply with Facebook API changes. The more relevant impact is that as of API version 10.0, apps may only retrieve up to 37 months prior data. In the past, older insight data was available.
03/19/20217748Facebook AdsDeprecated
  • The Permissions connection property is deprecated and replaced with Scope to match other drivers.
12/30/20207669ExcelAdded
  • Implemented user awareness during the upgrade process from 2019 to 2020 or 2021 editions.
12/18/20207657ExcelAdded
  • Added the "is null" and "is not null" filters on the "CData Query" form.

Copyright (c) 2024 CData Software, Inc. - All rights reserved.
Build 24.0.9060