В 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 |
Объединение нескольких смежных отчетов
Иногда, если отчет слишком большой, его разбивают на несколько. При этом необходимо учитывать следующие моменты:
- Если вы добавили параметры
WEEK
илиMONTH
и разбиваете отчет в середине недели или месяца соответственно, то каждый отчет будет содержать дублирующиеся записи с разными данными. - Убедитесь, что во всех отчетах используются одни и те же параметры и показатели, так как при разных параметрах данные могут быть несочетаемыми.
Аккаунты, требующие особого подхода
Аккаунты AdSense некоторых ваших пользователей могут иметь характеристики, которые вы не предусмотрели или о которых вы не знаете. Вот случаи, требующие особого внимания:
- Издатели с тысячами доменов или сайтов.
- Издатели с тысячами рекламных блоков или клиентских каналов.
- Издатели, которым нужны отчеты по нескольким рекламным клиентам (AdSense для поиска, AdSense для видео и т. д.).
Несколько аккаунтов
У пользователей может быть доступ к нескольким аккаунтам AdSense, поэтому при каждом запросе к API необходимо указывать идентификатор аккаунта. Вызов метода accounts.list
позволяет получить список аккаунтов. При этом пользователю должно быть показано диалоговое окно с просьбой выбрать нужный аккаунт. Однако этого можно не делать, если количество получаемых аккаунтов равно единице.
Смена часового пояса
Издатели AdSense могут в любой момент изменить свой часовой пояс. При этом в отчетах могут наблюдаться пики и спады активности. Дополнительную информацию по этому вопросу можно найти в статье Отчеты по местному времени.