Дополнительные отчеты

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

Если вы запрашиваете дополнительные отчеты, вам следует учитывать следующее:

• По-прежнему полезно время от времени запрашивать полный отчет, на случай, если некоторые дополнительные изменения будут потеряны. Например, если вы запрашиваете еженедельные дополнительные отчеты в течение января, в конце февраля вам следует запросить полный отчет за январь, чтобы убедиться, что вы получили все данные за январь.
• Поскольку не всегда возможно определить, изменились ли некоторые объекты, дополнительный отчет будет содержать объект, если Search Ads 360 даже подозревает , что объект изменился. Это означает, что дополнительные отчеты могут содержать данные, которые не изменились.

Чтобы запросить добавочный отчет, укажите одно из следующих свойств Reports.request.timeRange :

changedMetricsSinceTimestamp= timestamp

Запрашивает метрики, которые изменились с указанной отметки времени. Поскольку метрики хранятся с ежедневной детализацией и могут меняться в течение одного дня, но не в другой, такие запросы необходимо сегментировать по дням (должен присутствовать столбец date ). Например, отчет keyword со столбцами clicks , actions и date вернет строку для каждого ключевого слова и даты, когда зарегистрированное количество кликов или действий изменилось с указанной временной метки.

Временная метка должна быть не ранее, чем за 8 дней до момента запроса. Чтобы отследить все изменяющиеся метрики, обязательно делайте changedMetricsSinceTimestamp не реже одного раза в 7 дней и создавайте полный отчет для каждой даты, как только метрики стабилизируются (безопаснее подождать не менее 7 дней). Пример шаблона — создание двух отчетов каждый день: добавочный отчет для показателей, которые изменились за последние 36 часов, и полный отчет для показателей, произошедших 8 дней назад.

changedAttributesSinceTimestamp= timestamp

Запрашивает атрибуты, которые изменились с момента указанной отметки времени. changedAttributesSinceTimestamp может включать только столбцы атрибутов (без столбцов показателей или сегментов) и не работает для необработанных отчетов о событиях, таких как отчеты conversion . Например, отчет campaign со столбцами dailyBudget и campaignStartDate вернет строку для каждой кампании, дневной бюджет или дата начала которой изменились с момента указанной временной метки.

Обратите внимание, что изменения родительских атрибутов не фиксируются в отчетах changedAttributesSinceTimestamp . Например, ключевое слово может унаследовать стратегию назначения ставок от родительской группы объявлений. Даже если группе объявлений будет назначена новая стратегия назначения ставок, это ключевое слово может не появиться в отчете. Столбцы атрибутов, значение которых зависит от родительских сущностей (и, следовательно, могут меняться, не попадая в отчеты changedAttributesSinceTimestamp ), обычно имеют префикс «эффективный», например effectiveLabelIds или effectiveBidStartegy .