Google Analytics Multi-Channel Funnels Reporting API Changelog

We periodically update the Google Analytics Multi-Channel Funnels Reporting API in order to deliver new features and to repair defects discovered in previous versions. In most cases, these changes will be transparent to API developers. However, occasionally we need to make changes that require developers to modify their existing applications.

This page documents any changes made to the Google Analytics Multi-Channel Funnels Reporting API that might affect your application. We recommend that API developers periodically check this list for any new announcements. You can also subscribe to changes via the feeds listed under the Subscribe section below.

Subscribe To Related Changelogs

Includes all Collection, Configuration, and Reporting APIs.

Includes Core Reporting API, Multi-Channel Funnels Reporting API, and Real Time Reporting API.

This release adds a new dimension to the API. Check the Dimensions and metrics Reference for the complete list of definitions.

Transaction ID

  • dimension - mcf:transactionId - The transaction ID, supplied by the ecommerce tracking method, for the purchase in the shopping cart.

This release adds new dimensions and metrics to the API. Check the Dimensions and Metrics Reference for the complete list of definitions.

Conversion Paths

  • dimension - mcf:dcmAd - DCM ad name of the DCM event (impression or click) matching the Google Analytics conversion.
  • dimension - mcf:dcmAdPath - The path to conversion where interactions on the path are represented by DCM ads.
  • dimension - mcf:dcmAdType - DCM ad type name of the DCM event (impression or click) matching the Google Analytics conversion.
  • dimension - mcf:dcmAdvertiser - DCM advertiser name of the DCM event (impression or click) matching the Google Analytics conversion.
  • dimension - mcf:dcmAdvertiserPath - The path to conversion where interactions on the path are represented by DCM advertisers.
  • dimension - mcf:dcmCampaign - DCM campaign name of the DCM event (impression or click) matching the Google Analytics conversion.
  • dimension - mcf:dcmCampaignPath - The path to conversion where interactions on the path are represented by DCM campaigns.
  • dimension - mcf:dcmCreative - DCM creative name of the DCM event (impression or click) matching the Google Analytics conversion.
  • dimension - mcf:dcmCreativePath - The path to conversion where interactions on the path are represented by DCM creatives.
  • dimension - mcf:dcmCreativeVersion - DCM creative version of the DCM event (impression or click) matching the Google Analytics conversion.
  • dimension - mcf:dcmCreativeVersionPath - The path to conversion where interactions on the path are represented by DCM creative versions.
  • dimension - mcf:dcmNetwork - The network used.
  • dimension - mcf:dcmPlacement - DCM site placement name of the DCM event (impression or click) matching the Google Analytics conversion.
  • dimension - mcf:dcmPlacementPath - The path to conversion where interactions on the path are represented by DCM placements.
  • dimension - mcf:dcmSite - DCM site name where the DCM creative was shown for the DCM event (impression or click) matching the Google Analytics conversion.
  • dimension - mcf:dcmSitePath - The path to conversion where interactions on the path are represented by DCM sites.
  • metric - mcf:firstImpressionConversions - The number of conversions for which a DCM campaign impression was the first conversion interaction in a 30-day lookback window. This dimension includes both goal completions and transactions.
  • metric - mcf:firstImpressionValue - The value of conversions for which a DCM campaign campaign impression was the first conversion interaction in a 30-day lookback window. This dimension includes both goal completions and transactions.
  • metric - mcf:impressionAssistedConversions - The number of conversions for which a DCM campaign impression appeared on the conversion path, but was not the final conversion interaction. This dimension includes both goal completions and transactions.
  • metric - mcf:impressionAssistedValue - The value of conversions for which a DCM campaign campaign impression appeared on the conversion path, but was not the final conversion interaction. This dimension includes both goal completions and transactions.

This release adds new dimensions and metrics to the API. Check the Dimensions and Metrics Reference for the complete list of definitions.

Conversion Paths

  • Dimension - mcf:adwordsCustomerIDPath - Sequence of AdWords customer ID along conversion paths.

Interactions

  • Dimension - mcf:adwordsCustomerID - Corresponds to AdWords API Customer.id.

This release adds new dimensions and metrics to the API. Check the Dimensions and Metrics Reference for the complete list of definitions.

Conversion Paths

  • Dimension - mcf:adwordsAdGroupIDPath - Sequence of AdWords ad group ID along conversion paths.
  • Dimension - mcf:adwordsCampaignIDPath - Sequence of AdWords campaign ID along conversion paths.
  • Dimension - mcf:adwordsCreativeIDPath - Sequence of AdWords creative ID along conversion paths.
  • Dimension - mcf:adwordsCriteriaIDPath - Sequence of AdWords criteria ID along conversion paths.

Interactions

  • Dimension - mcf:adwordsAdGroupID - Corresponds to AdWords API AdGroup.id.
  • Dimension - mcf:adwordsCampaignID - Corresponds to AdWords API Campaign.id.
  • Dimension - mcf:adwordsCreativeID - Corresponds to AdWords API Ad.id.
  • Dimension - mcf:adwordsCriteriaID - Corresponds to AdWords API Criterion.id.

New Sample Size Control and Relative Dates Features

Relative Dates
  • Support for relative dates has been added to the MCF Reporting API. today, yesterday, and NdaysAgo are now valid values for the start-date and end-date query parameters.
  • Using these values will automatically determine the date range based on the current date at the time the query is made, and on the timezone of the view (profile) specified in the query. See the API Reference for additional details.
Sampling Level
  • A new parameter, samplingLevel, has been introduced that allows you to set the sampling level (i.e. the number of visits used to calculate the result) for a reporting query. Allowed values are: DEFAULT, FASTER, and HIGHER_PRECISION.
  • 2 new fields have been added to the API Response: sampleSize and sampleSpace. You can use these values to calculate the percentage of visits that were used for a sampled response.
  • See the API Reference and Sampling for additional details.

This is the initial release of the Multi-Channel Funnels Reporting API:

  • This new API enables you to request Multi-Channel Funnels data for an authenticated user. Data is derived from conversion path data, which shows user interactions with various traffic sources over multiple visits prior to converting. This allows you to analyze how multiple marketing channels influence conversions over time. For more details on what data is available and how to use the API see Multi-Channel Funnels Reporting API.