API управления AdSense имеет вызовы для создания новых и сохраненных отчетов. Они могут содержать простую аналитику, такую как доход в день, или очень сложные таблицы рейтинга кликов по каждому пользовательскому каналу в каждой стране. В этом руководстве представлен список крайних случаев, которые следует правильно обрабатывать для надежной интеграции с API.
Структура отчета
Результаты отчета возвращаются как объект ReportResult . Полную информацию см. в ссылке на ответ на отчет .
Использование хронологических измерений: ДАТА, НЕДЕЛЯ и МЕСЯЦ.
Отчеты могут быть пустыми или иметь пробелы.
Если в течение периода времени, указанного в запросе, не было активности, запросы объявлений не генерируются, и служба отчетов не отображает строки за эти периоды времени. Это важно, если вы, например, строите график.
Дополнительную информацию см. в руководстве по заполнению дат .
Запрос измерений МЕСЯЦ и НЕДЕЛЯ в одном отчете
Этот отчет может иметь негативные или неожиданные последствия. Если неделя принадлежит двум разным месяцам, для одной недели будут показаны две строки, по одной для каждого месяца.
Пример
| Размеры | Метрики | Дата начала | Дата окончания |
|---|---|---|---|
WEEKMONTH | 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_NAMEMONTH | 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 могут изменить свой часовой пояс в любое время, и это может привести к скачкам или провалам в отчетах. Дополнительные сведения см. в руководстве по отчетам о местных часовых поясах .