CData Python Connector 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.
06/05/20248922PythonAdded
  • Added support for Python 3.12.
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/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
08/29/20238641PythonAdded
  • Added support for SQLAlchemy 2.0.
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/19/20238539PythonAdded
  • Added support for Python 3.11 on Windows, Linux and Mac.
05/16/20238536PythonRemoved
  • Removed support for Python 3.7 on Windows and Linux
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/15/20228354PythonChanged
  • Updated embedded JRE to jre8u345-b01(Linux x64 / MacOS x64) and jre-17.0.5+8(MacOS aarch64).
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.
05/18/20228173PythonAdded
  • Added support for Python 3.10 on Windows, Linux, and Mac
  • Added support for Python 3.9 on Mac
  • Added support for Mac M1

Removed
  • Removed support for Python 3.6 on Windows and Linux
01/12/20228047Facebook AdsAdded
  • Added the following fields for AdCreatives: EffectiveInstagramMediaId, EffectiveInstagramStoryId, SourceInstagramMediaId.
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/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/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/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.
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.
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/16/20217776GeneralChanged
  • Updated implicit and metadata caching to improve performance and support for multiple connections. Old metadata caches are not compatible - you need to generate new metadata caches if you are currently using CacheMetadata.
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.

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