Google met à jour l’API de recherche d’analyse pour clarifier la fraîcheur des données

Google a ajouté un nouveau champ de métadonnées à l’API de recherche d’analyse de recherche, ce qui permet aux développeurs et aux professionnels du référencement de s’identifier lorsqu’ils travaillent avec des données incomplètes ou de traitement.

La mise à jour introduit une nouvelle transparence dans la fraîcheur des résultats de la requête, une amélioration pour les spécialistes du marketing qui s’appuient sur des mesures à jour pour éclairer les décisions en temps réel.

Quoi de neuf dans l’API

Le champ de métadonnées apparaît lorsque les demandes incluent le dataState Paramètre défini sur all ou hourly_allpermettant l’accès aux données qui peuvent encore être collectées.

Deux valeurs de métadonnées sont maintenant disponibles:

• first_incomplete_date: Indique la date la plus précoce pour laquelle les données sont encore incomplètes. N’apparaît que lorsque les données sont regroupées par date.
• first_incomplete_hour: Indique la première heure où les données restent incomplètes. N’apparaît que lorsque les données sont regroupées par heure.

Les deux valeurs aident à clarifier si les mesures récentes peuvent être considérées comme stables ou si elles peuvent toujours changer à mesure que Google finalise son traitement.

Pourquoi cela compte pour les rapports SEO

Cette amélioration vous permet de mieux distinguer les changements légitimes des performances de recherche et des lacunes temporaires causées par des données incomplètes.

Pour aider à réduire le risque d’interprétation erronée de fluctuations à court terme, la documentation de Google indique:

«Toutes les valeurs après le first_incomplete_date peut encore changer sensiblement.

Pour ceux qui exécutent des rapports automatisés, les nouvelles métadonnées permettent une logique plus intelligente, comme le signaler ou l’exclusion de données fraîches mais incomplètes pour éviter les parties prenantes trompeuses.

Cohérence du fuseau horaire

Tous les horodatages fournis dans le champ de métadonnées utilisent le fuseau horaire America / LOS_Angeles, quel que soit l’emplacement d’origine ou de propriété de demande. Les développeurs peuvent devoir tenir compte de cela lors de l’intégration des données dans les systèmes locaux.

Implémentation compatible en arrière

Les nouvelles métadonnées sont renvoyées en tant qu’objet facultatif et ne modifient pas les réponses API existantes, sauf si vous êtes demandé. Cela signifie aucun changement de rupture pour les implémentations actuelles, et les développeurs peuvent commencer à utiliser la fonctionnalité selon les besoins.

Meilleures pratiques de mise en œuvre

Pour profiter pleinement de cette mise à jour:

• Incluez la logique pour vérifier l’objet de métadonnées lors de la demande de données récentes.
• Pensez à afficher des avertissements ou des notes de bas de page dans les rapports lorsque les métadonnées indiquent des périodes incomplètes.
• Planifiez les rafraîchissements des données une fois la fenêtre incomplète passée pour garantir la précision.

Google rappelle également aux utilisateurs que l’API de recherche d’analyse de recherche continue de retourner uniquement les lignes supérieures, et non un ensemble de données complet, en raison des limitations du système.

En avant

Cet ajout petit mais significatif donne aux équipes de référencement plus de clarté autour de la fraîcheur des données, un point de douleur fréquent lorsque vous travaillez avec des mesures de performance horaires ou à temps proche.

C’est une amélioration bienvenue pour toute personne qui construit des outils ou des tableaux de bord en plus de l’API de la console de recherche.

Le champ de métadonnées est maintenant disponible via les demandes d’API standard. Les détails complets de l’implémentation sont disponibles dans la documentation de l’API d’analyse de recherche.