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.
Release 2016-07-14 (July 14, 2016)
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.
Release 2014-08-25 (August 25, 2014)
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.
Release 2014-02-14 (February 14, 2014)
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 APICustomer.id
.
Release 2013-12-12 (December 12, 2013)
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 APIAdGroup.id
. - Dimension -
mcf:adwordsCampaignID
- Corresponds to AdWords APICampaign.id
. - Dimension -
mcf:adwordsCreativeID
- Corresponds to AdWords APIAd.id
. - Dimension -
mcf:adwordsCriteriaID
- Corresponds to AdWords APICriterion.id
.
Release 2013-10-14 (October 14, 2013)
New Sample Size Control and Relative Dates Features
Relative Dates
- Support for relative dates has been added to the MCF Reporting API.
today
,yesterday
, andNdaysAgo
are now valid values for thestart-date
andend-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
, andHIGHER_PRECISION
. - 2 new fields have been added to the API Response:
sampleSize
andsampleSpace
. 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.
Release 2012-08 (August 1, 2012)
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.