Вместо того, чтобы получать дамп всех данных каждый раз, когда вы запрашиваете отчет, вы можете периодически запрашивать только те данные, которые изменились с момента вашего последнего отчета. Эти дополнительные отчеты, вероятно, будут значительно меньше, чем полный отчет.
Если вы запрашиваете дополнительные отчеты, вам следует учитывать следующее:
- По-прежнему полезно время от времени запрашивать полный отчет, на случай, если некоторые дополнительные изменения будут потеряны. Например, если вы запрашиваете еженедельные дополнительные отчеты в течение января, в конце февраля вам следует запросить полный отчет за январь, чтобы убедиться, что вы получили все данные за январь.
- Поскольку не всегда возможно определить, изменились ли некоторые объекты, дополнительный отчет будет содержать объект, если 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.