Fermer

mars 18, 2020

Comment interroger l'API Google Search Console7 minutes de lecture

Comment interroger l'API Google Search Console


Si vous êtes un SEO depuis même peu de temps, vous connaissez probablement Google Search Console (GSC). Il s'agit d'un outil précieux pour obtenir des informations sur votre site Web et ses performances dans la recherche naturelle. Cela dit, il a ses limites.

Dans cet article, vous apprendrez comment obtenir des données mieux connectées de Google Search Console et augmenter la taille de vos exportations de 400%.

Limitations de Google Search Console

Bien que GSC dispose d'un nombre de sections, nous nous concentrerons sur le rapport «Performance». Depuis le tableau de bord GSC, vous pouvez accéder à ce rapport de deux manières:

Une fois dans le rapport "Performance", les données des requêtes et des pages sont accessibles:

Cela révèle l'un des problèmes avec GSC: requête et page les données sont séparées.

En d'autres termes, si je veux voir les requêtes pour lesquelles une page spécifique est classée, je dois d'abord cliquer sur "Pages", sélectionner la page, puis cliquer sur "retour" pour "Requêtes". C'est une expérience très lourde.

L'autre problème (en deux parties) concerne l'exportation:

  • Les données de performances pour les requêtes et les pages doivent être exportées séparément.
  • Les exportations sont limitées à 1 000 lignes.

Nous ' Je vais chercher à résoudre ces problèmes en utilisant l'API GSC.

Qu'est-ce que l'API Google Search Console?

Nous savons maintenant que l'interface utilisateur GSC a des limites: la connexion des données de requête aux données de page est délicate et les exportations sont limitées .

Si l'interface utilisateur GSC représente la valeur par défaut, l'API GSC représente nos paramètres personnalisés. Cela demande un peu plus d'efforts, mais nous donne plus de contrôle et ouvre plus de possibilités (au moins dans le domaine des données de requête et de page).

L'API GSC est un moyen pour nous de nous connecter aux données de notre compte, faire des demandes plus personnalisées et obtenir une sortie plus personnalisée. Nous pouvons même ignorer ces paramètres d'usine par défaut, comme les exportations limitées à 1 000 lignes, par exemple.

Pourquoi l'utiliser? Eh bien, avec l'API, nous pouvons connecter les données de requête à la page pour laquelle la requête se classe, donc plus besoin de cliquer d'avant en arrière et d'attendre que les choses se chargent. Avec l'API, nous pouvons demander jusqu'à 5 000 lignes, soit une augmentation de 400%!

Alors connectons-nous, faisons notre demande et récupérons un ensemble de données plus robuste et plus significatif.

Configuration

Connectez-vous au compte GSC approprié sur cette page (coin supérieur droit). Par exemple, si mon site Web est example.com et que je peux afficher ce compte Search Console sous admin@email.com c'est le compte auquel je vais me connecter.

Saisissez l'URL du GSC approprié compte:

Configurez votre demande:

  1. Définissez startDate. Cela devrait être formaté comme: AAAA-MM-JJ.
  2. Définir la date de fin.
  3. Définir les dimensions. Une dimension peut être:
      • requête
      • page
      • périphérique
      • et / ou pays
  4. Définition des filtres (facultatif). Un filtre doit inclure:
      • dimension (une dimension peut être: requête, page, périphérique ou pays)
      • opérateur (un opérateur peut être: contient, notContains, equals, notEquals)
      • expression (une expression peut n'importe quelle valeur associée aux dimensions)
    1. Définissez rowLimit. Avec l'API GSC, vous pouvez demander jusqu'à 5 000!
    2. La page partagée à la première étape rend toute cette configuration assez facile, mais elle peut être fastidieuse et même déroutante pour certains. J'ai fait tout le nécessaire pour vous et j'ai créé JSON que vous pouvez modifier rapidement et facilement pour obtenir le retour d'API que vous souhaitez.

      Demande non filtrée

      La demande suivante ne sera pas filtrée. Nous allons définir nos dates, dimensions et limite de ligne préférées, puis faire notre demande.

      L'ordre dans lequel vous placez vos dimensions est l'ordre dans lequel elles seront renvoyées.

      L'API renvoie les données du bureau, du mobile et de la tablette, séparées. Les chiffres que vous voyez dans l'interface utilisateur de la CGC – les clics, par exemple – sont un agrégat des trois (sauf si vous appliquez le filtrage des appareils).

      N'oubliez pas, vos dimensions peuvent également inclure «pays» si vous le souhaitez. [19659002] {

      "startDate": "2019-11-01",

      "endDate": "2020-01-31",

      "dimensions":

      [

      "query",

      "page",

      "périphérique"

      ]

      "rowLimit": 3000

      }

      Demande filtrée

      Cette version de notre demande inclura des filtres afin d'être plus précis sur ce qui est retourné.

      Les filtres sont indiqués comme dimension / opérateur / expression. Voici quelques exemples pour montrer ce qui est possible:

      • la requête contient go fish digital
      • page équivaut à https://gofishdigital.com/
      • device notContains tablet

      Il semble que vous ne pouvez appliquer qu'un seul filtre par dimension , tout comme dans l'interface utilisateur normale de GSC, mais si vous le savez différemment, faites-le nous savoir dans les commentaires!

      {

      "startDate": "2019-11-01",

      "endDate": " 2020-01-31 ",

      " dimensions ":

      [

      " requête ",

      " page ",

      " appareil "

      ]

      " dimensionFilterGroups ":

      [

      {

      "filtres":

      [

      {

      "dimension": "appareil",

      "opérateur": "notContains",

      "expression ":" tablette "

      }

      ]

      }

      ]

      " rowLimit ": 3000

      }

      Choisissez un modèle, non filtré ou filtré, et indiquez votre nom personnalisé valeurs (tout ce qui suit deux points doit être mis à jour comme votre propre valeur, sauf si vous aimez mes préréglages).

      Execute t il demande

      Alors voilà! Deux modèles de demande parmi lesquels vous pouvez choisir et modifier à votre guise. Il est maintenant temps de faire la demande. Cliquez dans le "corps de la demande", sélectionnez tout et collez votre JSON personnalisé:

      C'est ici que vous pouvez configurer manuellement vos clés et valeurs de demande, mais comme je l'ai dit plus tôt, cela peut être fastidieux et un peu déroutant j'ai donc fait ce travail pour vous.

      Faites défiler vers le bas et cliquez sur "Exécuter". Vous pouvez également être invité à vous connecter ici.

      Si tout a été entré correctement et que la demande a pu être satisfaite, l'API renvoie vos données. Si vous obtenez une erreur, auditez d'abord votre demande, puis toutes les autres étapes et entrées si nécessaire.

      Cliquez dans la case en bas à droite (il s'agit de la réponse de l'API), sélectionnez tout et copiez les informations. [19659091] Convertir de JSON en CSV

      Excel ou Sheets sera une bien meilleure façon de travailler avec les données, convertissons donc notre sortie JSON en CSV.

      Utilisez un convertisseur comme celui-ci et collez votre sortie JSON. Vous pouvez maintenant exporter un CSV. Mettez à jour vos en-têtes de colonne comme vous le souhaitez.

      Interrogez vos propres données

      La plupart des SEO sont assez confortables dans Excel, vous pouvez donc désormais interroger la sortie de votre demande comme vous le souhaitez.

      L'une des tâches les plus courantes effectuées recherche des données associées à un ensemble spécifique de pages. Cela se fait en ajoutant une feuille avec votre ensemble de pages et en utilisant RECHERCHEV pour indiquer une correspondance.

      La sortie de l'API étant dans une feuille de calcul permet également les actions les plus courantes dans Excel comme le tri, le filtrage et la création de graphiques.

      Tirez le meilleur parti de Google Search Console

      GSC offre des données importantes pour les moteurs de recherche et la sortie de l'API GSC offre non seulement plus de ces données, mais dans un format qui est beaucoup moins lourd et plus cohérent.

      Aujourd'hui, nous avons surmonté deux obstacles que nous rencontrons souvent dans l'interface utilisateur standard de GSC: la connexion requête / page et les exportations limitées. J'espère que l'utilisation de l'API Google Search Console fera passer vos analyses et vos connaissances au niveau supérieur.

      Alors que mes modèles JSON couvriront les scénarios les plus courants en termes de ce que vous serez intéressé à demander, Google offre une documentation qui couvre un peu plus de terrain si vous êtes intéressé.

      Avez-vous une autre façon d'utiliser l'API GSC? Existe-t-il une autre API que vous utilisez couramment en tant que SEO? Faites le moi savoir dans les commentaires!



Source link