Предыдущий Search Ads 360 Reporting API выведен из эксплуатации. Теперь вы можете создавать свои отчеты с помощью нового Search Ads 360 Reporting API .
Обратите внимание, что методы get и getByCustomerId в Search Ads 360 Conversion API устарели в третьем квартале 2025 года. Чтобы продолжить доступ к данным о конверсиях, необходимо создать отчет с использованием ресурса конверсии с помощью нового Search Ads 360 Reporting API. Подробнее см. здесь.
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Новый API отчетов Search Ads 360 теперь доступен. Новый API обеспечивает повышенную гибкость для создания пользовательских отчетов и интеграции данных в ваши приложения и процессы отчетности. Узнайте больше о переходе и использовании нового API отчетов Search Ads 360 .
Вместо того, чтобы получать дамп всех данных каждый раз, когда вы запрашиваете отчет, вы можете периодически запрашивать только те данные, которые изменились с момента вашего последнего отчета. Эти дополнительные отчеты, вероятно, будут значительно меньше, чем полный отчет.
Если вы запрашиваете дополнительные отчеты, вам следует учитывать следующее:
По-прежнему полезно время от времени запрашивать полный отчет, на случай, если некоторые дополнительные изменения будут потеряны. Например, если вы запрашиваете еженедельные дополнительные отчеты в течение января, в конце февраля вам следует запросить полный отчет за январь, чтобы убедиться, что вы получили все данные за январь.
Поскольку не всегда возможно определить, изменились ли некоторые объекты, дополнительный отчет будет содержать объект, если Search Ads 360 даже подозревает , что объект изменился. Это означает, что дополнительные отчеты могут содержать данные, которые не изменились.
Запрашивает метрики, которые изменились с указанной отметки времени. Поскольку метрики хранятся с ежедневной детализацией и могут меняться в течение одного дня, но не в другой, такие запросы необходимо сегментировать по дням (должен присутствовать столбец date ). Например, отчет keyword со столбцами clicks , actions и date вернет строку для каждого ключевого слова и даты, когда зарегистрированное количество кликов или действий изменилось с указанной временной метки.
Временная метка должна быть не ранее, чем за 8 дней до момента запроса. Чтобы отследить все изменяющиеся метрики, обязательно делайте changedMetricsSinceTimestamp не реже одного раза в 7 дней и создавайте полный отчет для каждой даты, как только метрики стабилизируются (безопаснее подождать не менее 7 дней). Пример шаблона — создание двух отчетов каждый день: добавочный отчет для показателей, которые изменились за последние 36 часов, и полный отчет для показателей, произошедших 8 дней назад.
changedAttributesSinceTimestamp= timestamp
Запрашивает атрибуты, которые изменились с момента указанной отметки времени. changedAttributesSinceTimestamp может включать только столбцы атрибутов (без столбцов показателей или сегментов) и не работает для необработанных отчетов о событиях, таких как отчеты conversion . Например, отчет campaign со столбцами dailyBudget и campaignStartDate вернет строку для каждой кампании, дневной бюджет или дата начала которой изменились с момента указанной временной метки.
Обратите внимание, что изменения родительских атрибутов не фиксируются в отчетах changedAttributesSinceTimestamp . Например, ключевое слово может унаследовать стратегию назначения ставок от родительской группы объявлений. Даже если группе объявлений будет назначена новая стратегия назначения ставок, это ключевое слово может не появиться в отчете. Столбцы атрибутов, значение которых зависит от родительских сущностей (и, следовательно, могут меняться, не попадая в отчеты changedAttributesSinceTimestamp ), обычно имеют префикс «эффективный», например effectiveLabelIds или effectiveBidStartegy .
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2024-11-08 UTC."],[[["\u003cp\u003eThe new Search Ads 360 Reporting API offers increased flexibility for creating custom reports and integrating data into your workflows.\u003c/p\u003e\n"],["\u003cp\u003eIncremental reports allow you to retrieve only the data that has changed since your last request, making reports smaller and more efficient.\u003c/p\u003e\n"],["\u003cp\u003eIt is recommended to periodically request full reports in addition to incremental reports to ensure all data is captured.\u003c/p\u003e\n"],["\u003cp\u003eIncremental reports can be requested based on either changed metrics or changed attributes using specific time range properties.\u003c/p\u003e\n"],["\u003cp\u003eWhile \u003ccode\u003echangedAttributesSinceTimestamp\u003c/code\u003e requests provide efficient updates for attributes, changes to parent attributes might not be reflected, necessitating awareness of potential data discrepancies.\u003c/p\u003e\n"]]],["The new Search Ads 360 Reporting API allows users to build custom reports and integrate data into their applications. It offers incremental reports, which retrieve only data that has changed since the last request, reducing report size. Users can request changes in metrics (`changedMetricsSinceTimestamp`) or attributes (`changedAttributesSinceTimestamp`). Full reports are still recommended periodically to ensure no data is missed. For `changedMetricsSinceTimestamp`, data must be segmented by day and should be requested every seven days. Changed attributes only report changes to the attribute itself, not inherited changes from parent.\n"],null,[]]
