Метаданные для параметров и показателей

Вызов метаданных в API управления AdSense позволяет разработчикам получить список доступных параметров и показателей, проверить их совместимость и узнать, какие продукты поддерживаются. Ответ на такой вызов может выглядеть следующим образом:

{
  "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

Несколько замечаний к таблице:

  • DATE, MONTH и WEEK совместимы со всеми группами.
  • Параметр DOMAIN_NAME (группа 1) несовместим с CUSTOM_CHANNEL_* (группа 4).
  • Если вам нужен отчет по рекламным блокам (AD_UNIT, группа 3), то вы не сможете использовать клиентские каналы (CUSTOM_CHANNEL, группа 4), так как один клиентский канал может быть связан с несколькими рекламными блоками.
  • Названия стран (COUNTRY_NAME, группы 3 и 4) можно использовать в сочетании с рекламными блоками (AD_UNIT, группа 3) или клиентскими каналами (CUSTOM_CHANNEL, группа 4), но не с теми и другими вместе.

Дополнительная информация

Оставить отзыв о...

Текущей странице
AdSense Management API
AdSense Management API