Google добавил новое поле метаданных в API поисковой аналитики, что облегчает разработчикам и специалистам SEO идентифицировать, когда они работают с неполными или все еще обрабатывающими данные.

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

Что нового в API

Поле метаданных появляется, когда запросы включают dataState параметр установлен на all или hourly_allобеспечивая доступ к данным, которые все еще могут быть в процессе сбора.

В настоящее время доступны два значения метаданных:

• first_incomplete_date: Указывает самую раннюю дату, для которой данные все еще неполны. Появляется только тогда, когда данные сгруппированы по дате.
• first_incomplete_hour: Указывает первый час, когда данные остаются неполными. Появляется только тогда, когда данные сгруппированы по часу.

Оба значения помогают прояснить, можно ли считать недавние метрики стабильными или они все еще могут измениться, поскольку Google завершает свою обработку.

Почему это важно для отчетности SEO

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

Чтобы помочь снизить риск неправильного истолкования краткосрочных колебаний, документация Google гласит:

«Все значения после first_incomplete_date может все еще измениться заметно ».

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

Последовательность часового пояса

Все временные метки, представленные в поле метаданных, используют часовой пояс America/Los_angeles, независимо от происхождения запроса или местоположения свойства. Разработчикам может потребоваться учесть это при интеграции данных в локальные системы.

Обратно совместимая реализация

Новые метаданные возвращаются в качестве дополнительного объекта и не изменяют существующие ответы API, если не запрошены. Это означает, что нет нарушающих изменений для текущих реализаций, и разработчики могут начать использовать эту функцию по мере необходимости.

Лучшие практики для реализации

Чтобы в полной мере воспользоваться этим обновлением:

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

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

Глядя в будущее

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

Это долгожданное улучшение для любого, кто строит инструменты или информационные панели на вершине API консоли поиска.

Поле метаданных теперь доступно с помощью стандартных запросов API. Полные данные реализации доступны в Поисковая аналитика документация APIПолем

---

Показанное изображение: Roman Samborskyi/Shutterstock