Показатели и параметры

В приведенной ниже таблице вы найдете перечень доступных параметров и показателей с описанием каждого из них.

Параметры

Примечание. Параметры CODE и ID используются программно, а параметр NAME отображается для конечного пользователя и может быть локализован.

Параметр Описание
AD_CLIENT_ID Идентификатор рекламного клиента. Пример: ca-pub-088712.
AD_FORMAT_CODE Код формата объявления. Примеры: text, image, html.
AD_FORMAT_NAME Название рекламного формата. Примеры: Text (текстовое), Image (графическое) или Rich Media (мультимедийное). Последнее значение предназначено для формата HTML.
AD_UNIT_CODE Код рекламного блока (не обязательно уникальный в каждом рекламном клиенте). Пример: 837572.
AD_UNIT_ID Уникальный идентификатор рекламного блока. Пример: ca-pub-088712:837572.
AD_UNIT_NAME Название рекламного блока.
AD_UNIT_SIZE_CODE Код размера рекламного блока. Примеры: 720x42 или mobile_single.
AD_UNIT_SIZE_NAME Название размера рекламного блока. Примеры: 720x42 или Single (Mobile) (Одинарный (мобильный)).
BID_TYPE_CODE Тип ставки (например, cpc или cpm).
BID_TYPE_NAME Название типа ставки. Примеры: CPC bids (цена за клик) или CPM bids (цена за тысячу показов).
BUYER_NETWORK_ID Идентификатор рекламной сети, которая отправляет объявления на ваш сайт.
BUYER_NETWORK_NAME Название рекламной сети, которая отправляет объявления на ваш сайт. Пример: Google Adwords.
COUNTRY_CODE CLDR-код региона. Примеры: US, FR.
COUNTRY_NAME Название региона. Примеры: United States (США), France (Франция).
CUSTOM_CHANNEL_CODE Код клиентского канала.
CUSTOM_CHANNEL_ID Идентификатор клиентского канала.
CUSTOM_CHANNEL_NAME Название клиентского канала.
DATE Дата в формате ГГГГММДД.
DOMAIN_NAME Доменное имя.
MONTH Месяц в формате ГГГГММ.
PLATFORM_TYPE_CODE Код типа платформы. Примеры: HighEndMobile, Desktop.
PLATFORM_TYPE_NAME Название типа платформы. Примеры: High-end mobile devices (мобильные устройства высокого класса), Desktop (настольные компьютеры).
PRODUCT_CODE Название продукта. Примеры: AFC, AFS.
PRODUCT_NAME Название продукта. Примеры: AdSense for Content (AdSense для контента), AdSense for Search (AdSense для поиска).
TARGETING_TYPE_CODE Код типа таргетинга. Прим: Keyword, WebSite, Publisher.
TARGETING_TYPE_NAME Название типа таргетинга. Примеры: Contextual (контекстный), Reservation (резервирование), Publisher (издательский).
URL_CHANNEL_ID Идентификатор URL-канала.
URL_CHANNEL_NAME Название URL-канала.
WEEK Дата первого дня недели в формате ГГГГММДД.

Показатели

Примечание. Единицы отображаются в виде строк.

Показатель Описание Единицы
AD_REQUESTS Количество объявлений, запрошенных в рекламных блоках или в результатах поиска. Запрос объявления может не дать никаких результатов либо вызвать показ одного или нескольких отдельных объявлений в зависимости от размера рекламного блока и доступности объявлений. Целое число
AD_REQUESTS_COVERAGE Отношение общего количества запросов рекламных блоков к числу выполненных. Десятичное число в интервале от 0 до 1
AD_REQUESTS_CTR Коэффициент запросов объявлений, результатом которых стал клик по объявлению. Десятичное число в интервале от 0 до 1
AD_REQUESTS_RPM Доход за тысячу запросов объявлений. Рассчитывается путем деления ориентировочного дохода на количество отправленных вами запросов объявлений и последующего умножения на 1000. Десятичное число
CLICKS Сколько раз пользователь нажал на стандартное объявление AdSense для контента. Десятичное число
COST_PER_CLICK Сумма, которую вы зарабатываете за каждый клик пользователя по объявлению. Цена за клик рассчитывается путем деления ориентировочного дохода на количество кликов. Десятичное число (валюту см. в заголовке ответа)
EARNINGS Ориентировочный доход издателя. Обратите внимание, что прибыль от вчерашнего дня указана точно, а более поздние доходы указаны приблизительно из-за возможности спама и колебаний валютного курса. Десятичное число (валюту см. в заголовке ответа)
INDIVIDUAL_AD_IMPRESSIONS Количество показов отдельного объявления на вашем сайте. Для разных форматов будет отображаться различное количество объявлений. Например, вертикальный баннер может состоять из двух и более объявлений. Обратите внимание, что количество объявлений в рекламном блоке зависит от их типа (графические, стандартные, расширенные текстовые). Целое число
INDIVIDUAL_AD_IMPRESSIONS_CTR Коэффициент показов отдельного объявления, результатом которых стало посещение вашего сайта. Десятичное число в интервале от 0 до 1
INDIVIDUAL_AD_IMPRESSIONS_RPM Доход за тысячу показов отдельного объявления. Рассчитывается путем деления ориентировочного дохода на количество показов отдельных объявлений и последующего умножения на 1000. Десятичное число
MATCHED_AD_REQUESTS Количество объявлений, показанных в рекламных блоках или в результатах поиска. Совпадающие запросы рассчитываются для каждого запроса объявления, который возвращает хотя бы одно объявление на сайт. Целое число
MATCHED_AD_REQUESTS_CTR Коэффициент соответствующих запросов, результатом которых стало посещение вашего сайта. Десятичное число в интервале от 0 до 1
MATCHED_AD_REQUESTS_RPM Доход за тысячу совпадающих запросов. Рассчитывается путем деления ориентировочного дохода на количество совпадающих запросов и последующего умножения на 1000. Десятичное число
PAGE_VIEWS Количество просмотров страницы. Целое число
PAGE_VIEWS_CTR Коэффициент просмотров отдельной страницы, результатом которых стал клик по объявлению. Десятичное число в интервале от 0 до 1
PAGE_VIEWS_RPM Доход на тысячу просмотров страниц. Это значение рассчитывается путем деления ориентировочного дохода на количество просмотров страниц и последующего умножения на 1000. Десятичное число

Совместимость

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

metadata.dimensions

Ответ на этот вызов будет выглядеть примерно так:

[{
  "kind": "adsense#reportingMetadataEntry",
  "id": "EXAMPLE_DIMENSION",
  "compatibleDimensions": [
    "1",
    "2",
    "4",
    ...
  ],
  "compatibleMetrics": [
    "AD_REQUESTS",
    "AD_REQUESTS_COVERAGE",
    "AD_REQUESTS_CTR",
    ...
  ],
  "supportedProducts": [
    "AFMC",
    "AFC",
    "AFV"
  ]
},
...]
  
  • Поле compatibleDimensions содержит список целых чисел, каждое из которых представляет группу совместимых параметров. Параметры сопоставляются не один к одному, а группами. Пара параметров совместима, если они оба входят в одну и ту же группу (или группы) из списка compatibleDimensions.
  • В поле compatibleMetrics перечислены идентификаторы совместимых показателей.
  • В поле supportedProducts представлены коды продуктов, совместимых с данными параметрами.

metadata.metrics

Ответ аналогичен ответу на вызов metadata.dimensions:

  • В поле compatibleDimensions перечисляются идентификаторы, а не номера параметров.
  • Поля compatibleMetrics нет. Совместимость показателей зависит от используемых параметров.
  • В поле supportedProducts представлены коды продуктов, совместимых с выбранным показателем.

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

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