Распространенные подводные камни

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

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

Результаты отчета возвращаются как объект ReportResult . Полную информацию см. в ссылке на ответ на отчет .

Использование хронологических измерений: ДАТА, НЕДЕЛЯ и МЕСЯЦ.

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

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

Дополнительную информацию см. в руководстве по заполнению дат .

Запрос измерений МЕСЯЦ и НЕДЕЛЯ в одном отчете

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

Пример

Размеры Метрики Дата начала Дата окончания
WEEK
MONTH
CLICKS 28 апреля 2014 г. 03.05.2014
Возврат:
MONTH WEEK * CLICKS
2014-04 27 апреля 2014 г. 50
2014-05 27 апреля 2014 г. 43

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

Решение

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

WEEK CLICKS
27 апреля 2014 г. 93

Сопоставление значений измерений

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

Пример

Размеры Метрики Дата начала Дата окончания
PLATFORM_TYPE_NAME
MONTH
AD_REQUESTS 01.02.2014 2014-03-31
Возврат:
МЕСЯЦ PLATFORM_TYPE_NAME AD_REQUESTS
2014-03 Рабочий стол 100
2014-03 Высококачественные мобильные устройства 5
2014-04 Рабочий стол 75
Решение

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

МЕСЯЦ 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 могут изменить свой часовой пояс в любое время, и это может привести к скачкам или провалам в отчетах. Дополнительные сведения см. в руководстве по отчетам о местных часовых поясах .