Случаи, требующие особого внимания

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

Структура отчета

Отчет в формате JSON выглядит следующим образом:

{
  "kind": "adsense#report",
  "totalMatchedRows": long,
  "headers": [
    {
      "name": string,
      "type": string,
      "currency": string
    }
  ],
  "rows": [
    [
      string
    ]
  ],
  "totals": [
    string
  ],
  "averages": [
    string
  ],
  "warnings": [
    string
  ],
  "startDate": string,
  "endDate": string
}

Описания этих атрибутов можно найти в статье, посвященной методу reports.generate.

Использование хронологических параметров DATE, WEEK и MONTH

Отчеты могут быть пустыми или содержать пробелы

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

Подробности можно узнать из статьи Подстановка недостающих дат.

Добавление параметров MONTH и WEEK в один отчет

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

Пример

ПараметрыПоказателиДата началаДата окончания
WEEK
MONTH
CLICKS2014-04-282014-05-03

Результат:

MONTHWEEK*CLICKS
2014-042014-04-2750
2014-052014-04-2743
*Первый день недели

Решение

Удалите из отчета параметр MONTH.

WEEKCLICKS
2014-04-2793

Проверка значений параметров

Когда вы запрашиваете параметры, связанные, например, с платформами (настольные компьютеры, мобильные устройства высокого класса), в отчет войдут только те платформы, где наблюдалась активность. Если в какой-то день, неделю или месяц не было посещений с мобильных устройств высокого класса, для этой категории не будет представлено данных.

Пример

ПараметрыПоказателиДата началаДата окончания
PLATFORM_TYPE_NAME
MONTH
AD_REQUESTS2014-02-012014-03-31

Результат:

MONTHPLATFORM_TYPE_NAMEAD_REQUESTS
2014-03Настольные компьютеры100
2014-03Мобильные устройства высокого класса5
2014-04Настольные компьютеры75

Решение

При обработке результатов подставляйте ноль для всех значений параметра, которые отсутствуют в отчете:

MONTHPLATFORM_TYPE_NAMEAD_REQUESTS
2014-03Настольные компьютеры100
2014-03Мобильные устройства высокого класса5
2014-04Настольные компьютеры75
2014-04Мобильные устройства высокого класса0

Объединение нескольких смежных отчетов

Иногда, если отчет слишком большой, его разбивают на несколько. При этом необходимо учитывать следующие моменты:

  1. Если вы добавили параметры WEEK или MONTH и разбиваете отчет в середине недели или месяца соответственно, то каждый отчет будет содержать дублирующиеся записи с разными данными.
  2. Убедитесь, что во всех отчетах используются одни и те же параметры и показатели, так как при разных параметрах данные могут быть несочетаемыми.

Аккаунты, требующие особого подхода

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

  1. Издатели с тысячами доменов или сайтов.
  2. Издатели с тысячами рекламных блоков или клиентских каналов.
  3. Издатели, которым нужны отчеты по нескольким рекламным клиентам (AdSense для поиска, AdSense для видео и т. д.).

Несколько аккаунтов

У пользователей может быть доступ к нескольким аккаунтам AdSense, поэтому при каждом запросе к API необходимо указывать идентификатор аккаунта. Вызов метода accounts.list позволяет получить список аккаунтов. При этом пользователю должно быть показано диалоговое окно с просьбой выбрать нужный аккаунт. Однако этого можно не делать, если количество получаемых аккаунтов равно единице.

Смена часового пояса

Издатели AdSense могут в любой момент изменить свой часовой пояс. При этом в отчетах могут наблюдаться пики и спады активности. Дополнительную информацию по этому вопросу можно найти в статье Отчеты по местному времени.