维度和指标的元数据

通过AdSense Management API中的元数据调用,开发者可以获取可用的维度指标列表,查看这些维度和指标之间的兼容性以及了解所支持的产品。响应示例如下所示:

{
  "kind": "adsense#reportingMetadataEntry",
  "id": "EXAMPLE_DIMENSION",
  "compatibleDimensions": [
    "1",
    "2",
    "4",
    ...
  ],
  "compatibleMetrics": [
    "AD_REQUESTS",
    "AD_REQUESTS_COVERAGE",
    "AD_REQUESTS_CTR",
    ...
  ],
  "supportedProducts": [
    "AFMC",
    "AFC",
    "AFV"
  ]
}

compatibleMetrics字段仅提供了与该维度兼容的指标列表。这意味着,如果您想在报告中使用某个指标,您需要确保该指标与您所请求的所有维度兼容。

不过,维度之间的兼容性有点复杂。

了解维度的兼容性

compatibleDimensions字段会显示代表一组兼容维度的列表,其中的每个项目都是整数。由于这些兼容维度之间没有一对一的关系,因此它们会以组的形式表示(如下所示)。

第1组第2组第3组第4组
AD_CLIENT_IDAD_CLIENT_IDAD_CLIENT_IDAD_CLIENT_ID
AD_FORMAT_CODEAD_FORMAT_CODEAD_FORMAT_CODEAD_FORMAT_CODE
AD_FORMAT_NAMEAD_FORMAT_NAMEAD_FORMAT_NAMEAD_FORMAT_NAME
AD_UNIT_CODE
AD_UNIT_ID
AD_UNIT_NAME
AD_UNIT_SIZE_CODE
AD_UNIT_SIZE_NAME
BID_TYPE_CODEBID_TYPE_CODEBID_TYPE_CODEBID_TYPE_CODE
BID_TYPE_NAMEBID_TYPE_NAMEBID_TYPE_NAMEBID_TYPE_NAME
COUNTRY_CODECOUNTRY_CODE
COUNTRY_NAMECOUNTRY_NAME
CUSTOM_CHANNEL_CODE
CUSTOM_CHANNEL_ID
CUSTOM_CHANNEL_NAME
BUYER_NETWORK_ID
BUYER_NETWORK_NAME
DATEDATEDATEDATE
DOMAIN_NAME
MONTHMONTHMONTHMONTH
PLATFORM_TYPE_CODEPLATFORM_TYPE_CODEPLATFORM_TYPE_CODEPLATFORM_TYPE_CODE
PLATFORM_TYPE_NAMEPLATFORM_TYPE_NAMEPLATFORM_TYPE_NAMEPLATFORM_TYPE_NAME
PRODUCT_CODEPRODUCT_CODEPRODUCT_CODEPRODUCT_CODE
PRODUCT_NAMEPRODUCT_NAMEPRODUCT_NAMEPRODUCT_NAME
TARGETING_TYPE_CODETARGETING_TYPE_CODETARGETING_TYPE_CODETARGETING_TYPE_CODE
TARGETING_TYPE_NAMETARGETING_TYPE_NAMETARGETING_TYPE_NAMETARGETING_TYPE_NAME
WEEKWEEKWEEKWEEK

在上表中,请注意以下几点:

  • DATEMONTHWEEK与每一组都兼容。
  • DOMAIN_NAME(第1组)与CUSTOM_CHANNEL_*(第4组)不兼容。
  • 如果您想生成针对广告单元(第3组)的报告,您将无法使用自定义渠道(第4组),因为自定义渠道可应用到一个或多个广告单元上。
  • 国家/地区名称(第3组和第4组)可以与广告单元(第3组)或自定义渠道(第4组)结合使用,但不能同时与两者结合使用。

后续步骤

发送以下问题的反馈:

此网页
AdSense Management API
AdSense Management API