Guides References

Reporting API v0 Release Notes

The Reporting API allows to retrieve the reports about the performance of accounts and campaigns.

Contact: api@acquisio.com

Releases by year:

09 April 2021

13 May 2020

  • Two new segments have been added to retrieve yearly statistics and statistics by the day of week (ex: Monday). These new segments can be requested with segments=Year or segments=DayOfWeek. See the Segments documentation for more details.

17 March 2020

  • Important performance improvements make Reporting API execute requests between 2 and 3 times faster.

04 December 2019

  • A new metric specific to Google Ads has been added: googleStatistics.allConversions.
  • Two new call tracking metrics have been added: callConvCount and callConvFractional.
  • The API documentation has a new section with examples of useful formulas.

03 December 2019

  • The field adPlatformId has been added to the Ad Platform accounts, the ad groups and the keywords. The adPlatformId is the ID that identifies a resource in the API provided by an Ad Platform (ex: Google Ads).

21 November 2019

  • A new Display Ad Platform named Programmatic is now supported. Programmatic statistics can be retrieved for accounts, Ad Platform Accounts, campaigns, ad groups and ads. Statistics specific to Programmatic can be requested with the new statistics query parameter.

29 October 2019

  • The maximum number of formulas that can be sent in a request has been increased from 10 to 20.

21 October 2019

  • Three call tracking statistics have been added to most endpoints: externalStatistics.callCount, externalStatistics.callDuration and externalStatistics.callAnsweredCount. externalStatistics.totalConversionCount has also been added. Total Conversion Count is a special metric based on a formula that can be configured in the Client Campaigns application. Refer to the list of Available statistics for more details about which statistics are supported.

17 October 2019

  • Two new statistics specific to Google Ads have been added to most endpoints: googleStatistics.impressionTopPercentage and googleStatistics.impressionAbsoluteTopPercentage. Refer to the list of Available statistics for more details about which statistics are supported.

30 September 2019

  • A new Display Ad Platform named The Trade Desk is now supported. The Trade Desk statistics can be retrieved for accounts, Ad Platform Accounts, campaigns, ad groups and ads. Statistics specific to The Trade Desk can be requested with the new statistics query parameter.

16 September 2019

  • A new Display Ad Platform named Programmatic1 is now supported. Programmatic1 statistics can be retrieved for accounts, Ad Platform Accounts, campaigns, ad groups and ads. Statistics specific to Programmatic1 can be requested with the new statistics query parameter.

10 September 2019

  • DeviceType segment is now supported for Microsoft Advertising. The feature was previously limited to Google Ads. Refer to the Segments documentation for more details.

31 July 2019

  • GET
    /ads    : It’s now possible to retrieve the images of Facebook ads with a better resolution by adding embed=images to the query parameters.

25 July 2019

  • The statistics.conversions statistic is now a Decimal instead of an Integer to support the fractional conversions of Google Ads.

27 June 2019

  • GET
    /markups    : New endpoint to retrieve the markup rates that are applied on cost statistics.

28 May 2019

21 May 2019

  • References to Bing Ads has been replaced by Microsoft Advertising in the API documentation, due to the recent rebranding.
  • The constant BingAds has been renamed to MicrosoftAdvertising. The rename affects the response field type of Ad Platform Accounts and the response field adPlatformAccountType of Campaigns, Ad Groups, Keywords and Ads.

07 May 2019

  • The query parameter statistics now allow to specify the statistics that should be returned in the response. This allows to reduce the latency of the API calls, especially when segments are used. For example, segments=Day&statistics=statistics.clicks,statistics.impressions is likely to be faster than segments=Day, since that second call include nine statistics by default.

01 May 2019

  • A new Display Ad Platform named Simpli.fi is now supported. Simpli.fi statistics can be retrieved for accounts, Ad Platform Accounts, campaigns, ad groups and ads. Statistics specific to Simpli.fi can be requested with the new statistics query parameter.
  • It’s now possible to sort on a formula (ex: sort=formulas.CostPerImpression). Refer to the Formulas documentation for more details about how formulas works.
  • Formulas can now include the Conversion Count and Conversion Value statistics to calculate totals (ex: formulas=totalConversions:externalStatistics.convCount4 + externalStatistics.convCount12:Integer). Refer to the list of available statistics for more details.

23 April 2019

  • Two new segments have been added to retrieve weekly statistics and monthly statistics. These new segments can be requested with segments=Week or segments=Month. See the Segments documentation for more details.
  • GET
    /ads/facebook    : New endpoint to retrieve the Reach and Frequency statistics for Facebook ads.

15 April 2019

11 April 2019

25 February 2019

  • GET
    /ads    : It’s now possible to retrieve the fields that are specific to a given type of ad (ex: Facebook Text Ad). Specific fields can be requested with &embed=specificFields. This new feature is currently limited to Facebook Ads. Filtering and sorting on specific fields isn’t yet supported.

07 January 2019

  • GET
    /accounts    : Account custom fields can now be retrieved with &embed=customFields. Filters on custom fields are also supported (ex: &filter=customFields.field1:"Boston".
  • GET
    /accounts    : Sorting on account labels is now available (ex: &sort=labels.Color:"Blue").

13 December 2018

  • A generic Ad Platform named Virtual Search is now supported. Virtual Search allows to import in Acquisio the structure and statistics from additional Ad Platforms like Marchex and DialogTech.
  • Formulas (the query parameter formulas) and advanced filters (the query parameter filter) are now out of preview and are considered stable.
  • Many superfluous query parameters that allow to filter on resources have been deprecated. The advanced filters (the filter query parameter) should be used instead. The deprecated query parameters will be removed in the future when the clients of Reporting API will no longer use them.

02 October 2018

  • Formulas have been added to most endpoints (they were previously only available for campaigns). See the query parameter formulas on endpoints like accounts.
  • Account labels can now be included in the response. See the query parameter embed on the accounts endpoint.

24 September 2018

  • Most of the endpoints have a new response header X-TotalCount that indicates how many resources are available for that request in all pages.
  • Filters on account labels are now supported.

10 September 2018

09 July 2018

  • Segment filters on Device Type and Network type can be used to retrieve the statistics for specific devices or networks. Segment filters are part of the Advanced filters.
  • Formulas are now supported in segment breakdowns.

03 July 2018

  • References to AdWords has been replaced by Google Ads in the API documentation, due to the recent rebranding.
  • The constant AdWords has been renamed to GoogleAds. The rename affects the response field type of Ad Platform Accounts and the response field adPlatformAccountType of Ad Groups, Keywords and Ads.
  • The new segments query parameter allows to define segment breakdowns to split the statistics by Day (daily statistics) and/or by Device Type.

27 June 2018

  • The new filter query parameter allows to define advanced filters to determine which resources should be returned. The feature is currently in preview (not considered stable yet).
  • GET
    /campaigns    : The formulas query parameter now allows to set a type to change the format of the result.

23 May 2018

  • The new sort query parameter allows to define the order in which resources are returned.
  • The new name query parameter allows to retrieve Accounts, Ad Platform Accounts, Campaigns, Ad Groups and Ads by their name.
  • The new text query parameter allows to retrieve Keywords by their text.

04 May 2018

  • GET
    /keywords    : New endpoint to retrieve the statistics of some keywords.
  • GET
    /ads    : New endpoint to retrieve the statistics of some ads.
  • GET
    /campaigns    : Initial support for formulas as been added in preview (not considered stable yet).

26 April 2018