Google Analytics(分析)Multi-ChannelFunnel Reporting API 变更日志

为了提供新功能并修复以前版本中发现的缺陷,我们会定期对 Google Analytics(分析)Multi-Channel Funnels Reporting API 进行更新。大多数情况下,这些更改将对 API 开发者公开。不过,有时我们所做的更改需要开发者修改其现有应用。

本页记录了对 Google Analytics(分析)Multi-Channel Funnels Reporting API 所做的更改,这些更改可能会影响您的应用。我们建议 API 开发者定期查看此列表,及时了解最新信息。您还可以通过下文订阅部分中列出的 Feed 订阅更改通知。

订阅相关更新日志

包括所有数据收集、配置和报告 API。

包括 Core Reporting API、Multi-Channel Funnels Reporting API 和 Real Time Reporting API。

此版本为 API 新增了一个维度。如需查看完整的定义列表,请参阅维度和指标参考

交易 ID

  • 维度 - mcf:transactionId - 电子商务跟踪方法提供给购物车中的购买的交易 ID。

此版本为 API 新增了一些维度和指标。如需查看完整的定义列表,请参阅维度和指标参考

转化路径

  • 维度 - mcf:dcmAd - 与 Google Analytics(分析)转化匹配的 DCM 事件(展示或点击)所对应的 DCM 广告名称。
  • 维度 - mcf:dcmAdPath - 转化路径,其中的互动通过 DCM 广告体现。
  • 维度 - mcf:dcmAdType - 与 Google Analytics(分析)转化匹配的 DCM 事件(展示或点击)所对应的 DCM 广告类型名称。
  • 维度 - mcf:dcmAdvertiser - 与 Google Analytics(分析)转化匹配的 DCM 事件(展示或点击)所对应的 DCM 广告客户名称。
  • 维度 - mcf:dcmAdvertiserPath - 转化路径,其中的互动通过 DCM 广告客户体现。
  • 维度 - mcf:dcmCampaign - 与 Google Analytics(分析)转化匹配的 DCM 事件(展示或点击)所对应的 DCM 广告系列名称。
  • 维度 - mcf:dcmCampaignPath - 转化路径,其中的互动通过 DCM 广告系列体现。
  • 维度 - mcf:dcmCreative - 与 Google Analytics(分析)转化匹配的 DCM 事件(展示或点击)所对应的 DCM 广告素材名称。
  • 维度 - mcf:dcmCreativePath - 转化路径,其中的互动通过 DCM 广告素材体现。
  • 维度 - mcf:dcmCreativeVersion - 与 Google Analytics(分析)转化匹配的 DCM 事件(展示或点击)所对应的 DCM 广告素材版本。
  • 维度 - mcf:dcmCreativeVersionPath - 转化路径,其中的互动通过 DCM 广告素材版本体现。
  • 维度 - mcf:dcmNetwork - 使用的广告网络。
  • 维度 - mcf:dcmPlacement - 与 Google Analytics(分析)转化匹配的 DCM 事件(展示或点击)所对应的 DCM 网站展示位置名称。
  • 维度 - mcf:dcmPlacementPath - 转化路径,其中的互动通过 DCM 展示位置体现。
  • 维度 - mcf:dcmSite - 与 Google Analytics(分析)转化匹配的 DCM 事件(展示或点击)所对应的 DCM 网站(DCM 广告素材展示在其中)名称。
  • 维度 - mcf:dcmSitePath - 转化路径,其中的互动通过 DCM 网站体现。
  • 指标 - mcf:firstImpressionConversions - DCM 广告系列展示是 30 天回溯期内发生的首次转化互动时的转化次数。该维度同时包含目标达成次数和交易次数。
  • 指标 - mcf:firstImpressionValue - DCM 广告系列展示是 30 天回溯期内发生的首次转化互动时的转化价值。该维度同时包含目标达成次数和交易次数。
  • 指标 - mcf:impressionAssistedConversions - DCM 广告系列展示出现在转化路径上但并非最终转化互动时的转化次数。该维度同时包含目标达成次数和交易次数。
  • 指标 - mcf:impressionAssistedValue - DCM 广告系列展示出现在转化路径上但并非最终转化互动时的转化价值。该维度同时包含目标达成次数和交易次数。

此版本为 API 新增了一些维度和指标。如需查看完整的定义列表,请参阅维度和指标参考

转化路径

  • 维度 - mcf:adwordsCustomerIDPath - 转化路径中 AdWords 客户 ID 的顺序。

互动次数

  • 维度 - mcf:adwordsCustomerID - 对应于 AdWords API Customer.id

此版本为 API 新增了一些维度和指标。如需查看完整的定义列表,请参阅维度和指标参考

转化路径

  • 维度 - mcf:adwordsAdGroupIDPath - 转化路径中 AdWords 广告组 ID 的顺序。
  • 维度 - mcf:adwordsCampaignIDPath - 转化路径中 AdWords 广告系列 ID 的顺序。
  • 维度 - mcf:adwordsCreativeIDPath - 转化路径中 AdWords 广告素材 ID 的顺序。
  • 维度 - mcf:adwordsCriteriaIDPath - 转化路径中 AdWords 条件 ID 的顺序。

互动次数

  • 维度 - mcf:adwordsAdGroupID - 对应于 AdWords API AdGroup.id
  • 维度 - mcf:adwordsCampaignID - 对应于 AdWords API Campaign.id
  • 维度 - mcf:adwordsCreativeID - 对应于 AdWords API Ad.id
  • 维度 - mcf:adwordsCriteriaID - 对应于 AdWords API Criterion.id

新增了“样本规模控制”和“相对日期”功能

相对日期
  • MCF Reporting API 中新增了对相对日期的支持。todayyesterdayNdaysAgo 现在是 start-dateend-date 查询参数的有效值。
  • 采用这些值后,系统会根据查询时的当前日期,以及查询中指定的数据视图(配置文件)时区,自动确定日期范围。如需了解详情,请参阅 API 参考文档
抽样级别
  • 此版本引入了一个新参数 samplingLevel,利用该参数,您可以为报告查询设置抽样级别(即用于计算结果的访问次数)。允许的值包括:DEFAULTFASTERHIGHER_PRECISION
  • API 响应中新增了 2 个字段:sampleSizesampleSpace。您可以使用这些值来计算用于抽样响应的访问次数所占的百分比。
  • 如需了解详情,请参阅 API 参考文档抽样

这是 Multi-Channel Funnels Reporting API 的初始版本:

  • 借助此新 API,您可以请求通过身份验证的用户的多渠道漏斗数据。这些数据来自于转化路径数据,后者显示了转化之前用户在多次访问中与各种流量来源的互动情况。借助此类数据,您可以分析多个营销渠道如何在一段时间内影响转化。如需详细了解所提供的数据以及如何使用该 API,请参阅 Multi-Channel Funnels Reporting API