Google Analytics API Data API Updates: asynchronous reporting, new dimensions for key events

[Ilya Kuleshov]

On behalf of the Google Analytics team I would like to announce the following updates to the Google Analytics Data API:

• Added report tasks, an asynchronous reporting feature, to the Data API v1alpha
  

  Using report tasks, you can initiate a long running asynchronous request to form a customized report of your Google Analytics event data.

  The following report task manipulation methods have been added to the Data API v1alpha:

  • properties.reportTasks.create
  • properties.reportTasks.get
  • properties.reportTasks.list
  • properties.reportTasks.query
    
    
• New dimensions for key events
  Dimensions and metrics for key events are now available.
  Modify your report requests that use the isConversionEvent dimension to use the isKeyEvent dimension instead.
  Modify any report requests that use a Deprecated Metric in the following table to use the Key Event Metric instead.

Deprecated Metric	Key Event Metric
advertiserAdCostPerConversion	advertiserAdCostPerKeyEvent
conversions	keyEvents
firstTimePurchaserConversionRate	firstTimePurchaserRate
purchaserConversionRate	purchaserRate
sessionConversionRate	sessionKeyEventRate
userConversionRate	userKeyEventRate

Make similar modifications to any usage of key event metrics for one key event in your report requests.

The response for the properties/getMetadata method reflects the introduction of key event dimensions and metrics in DimensionMetadata and MetricMetadata objects as follows:

• The apiName, uiName, and description contain the key event API name, UI name, and description.
• The deprecatedApiNames repeated field has an entry with the deprecated conversion API name.

Feedback

As part of the testing process, we kindly ask you to answer a quick Google Analytics 4 APIs Survey and provide any feedback you have regarding the testing experience.