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

В 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	CLICKS	2014-04-28	2014-05-03

Результат:

MONTH	WEEK*	CLICKS
2014-04	2014-04-27	50
2014-05	2014-04-27	43

*Первый день недели

Решение

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

WEEK	CLICKS
2014-04-27	93

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

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

Пример

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

Результат:

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

Решение

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

MONTH	PLATFORM_TYPE_NAME	AD_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 могут в любой момент изменить свой часовой пояс. При этом в отчетах могут наблюдаться пики и спады активности. Дополнительную информацию по этому вопросу можно найти в статье Отчеты по местному времени.