Intégration des données Ryte dans Google Data Studio via une API: Guide étape par étape et cas d'utilisation

Cet article explique comment utiliser SEO Expertise pour télécharger des données de projet via une API via Google Apps Script dans une feuille de calcul et dans Data Studio à des fins de création de rapports et de surveillance. Il est destiné aux débutants et aux avancés, qui connaissent déjà quelques termes techniques de base. Le code est disponible en téléchargement gratuit, avec un cas d'utilisation pour l'orientation.

Il y a l'API SEO Expertise? Que pouvez-vous en faire?

Pour les utilisateurs de comptes professionnels (et les niveaux supérieurs), SEO Expertise offre un accès aux données de projet via leur API REST. Le Guide d'intégration de l'API SEO Expertise décrit les points clés de l'accès par programme.

Comme décrit dans Integrationsguide, il existe un menu déroulant pour chaque visualisation dans le module Réussite de site Web avec la sélection "Api-Call", dont le code doit être copié. Il s'agit de la charge POST la plus récente pour la requête sur le / zoom / point de terminaison, et non de l'appel API complet directement.

Actuellement, les requêtes API ne sont disponibles que pour le module Website Success. Cet article portera donc exclusivement sur ce sujet.

Figure 1: Appel API dans le menu déroulant

Figure 2: Vue détaillée de l'appel API pour un objet sélectionné

Collection de vues: Quels sont les domaines pertinents pour mon projet?

Maintenant commence la recherche des vues pertinentes pour votre propre projet. Suis-je intéressé par les erreurs de code de statut, les sitemaps, le multilinguisme ou tous en même temps? Pour chaque graphique et chaque tableau de module de réussite de site Web, un bloc de code Api-Call, plus précisément une charge POST au format JSON, peut être copié.

Après avoir collecté plusieurs vues, il est essentiel de pouvoir gérer plusieurs vues et requêtes simultanément. Une solution simple fournit l'implémentation suivante Script Google Apps et le code fourni.

RÉSERVATION: Selon le projet, différentes vues sont intéressantes. Nous avons mis en place une sélection arbitraire et l'avons stockée dans un objet de configuration, qui peut être étendu à volonté dans le script ci-dessous.

Guide pas à pas: 1. JSON-Minifying

Toute charge utile POST copiée doit être transmise au contenu par un outil de minifier JSON tel que codebeautify.org avant d'être insérée dans le script. sur une ligne présenter et garder le script clair.

Ci-dessous, nous utilisons pour Javascript en combinaison avec l'environnement d'exécution Google Apps Script. Apps Script est le moyen le plus simple de tester des API en tant que spécialiste du marketing en ligne pour les affiliés de Google ou de le SEO, sans avoir à connaître ou à créer la base technique à partir de rien.

Guide pas à pas: 2. Création d'un script Google Apps

La première étape consiste à créer un script sur script.google.com. Là vous insérez le code ci-dessous et supprimez le corps fonctionnel existant "Fonction myFunction () {}", Si plusieurs scripts du même projet sont planifiés ultérieurement, ils doivent avoir des noms spécifiques. Ci-dessous, vous trouverez le code complet à copier, y compris le corps fonctionnel "Fonction onPageApiCall () {}" énumérés.

Figure 4: Créez un script sur script.google.com

Voici le code prêt à être copié.

La collection actuelle de vues ou de charges utiles POST

Après avoir créé et enregistré le script, il passe à la configuration. Ci-dessous se trouve notre liste de requêtes sur le site Web de Success API, les noms devraient suffire pour parler:

Figure 5: Liste de requêtes sur l'API de réussite de site Web

Pour l'exemple d'implémentation, nous avons fusionné les charges utiles JSON des graphiques récapitulatifs de SEO Expertise, dans le langage API appelé "action": "agrégat", et des vues de liste, appelées "action": "liste". Le résultat est deux blocs de code:

premier les charges utiles minimisées individuelles par demande et

deuxième un tableau ONPAGE_CALLS consolidé d'objets par zone.

Une extension des charges utiles dans 1. doit donc être accompagnée d'une addition du tableau dans 2.

Guide pas à pas: 3. Configuration des valeurs Projet, Clé API et Limite

Toutes les données utiles sont fournies avec les trois constantes, de sorte que lors de la copie d'un script, ces valeurs ne doivent être modifiées qu'à un seul endroit:

• PROJET: C'est le nom du répertoire dans l'URL. Exemple: https://my.ryte.com/noriskshop-de/website-success/, ici le nom du projet serait "noriskshop-de"
• api_key: La clé est alphanumérique à 32 chiffres et peut être copiée à partir de n’importe quel bloc d’appel d’API. Ceci est inclus dans chaque JSON de charge utile et est le même pour tous les projets, uniquement lié à l'utilisateur
• LIMITE: Valeur arbitraire pour limiter les résultats, inférieure à 5000.

L'avantage d'avoir des constantes en Javascript est qu'elles peuvent être utilisées avec une portée globale en tout point du code, sans implication spécifique en tant que paramètre de fonction ou de méthode.

Guide pas à pas: 4. Feuille de calcul Google en sortie

À la fin il manque encore Identifiant de feuille de calcul du Google Docdans lequel est écrit. Pour configurer la fiche, il vous suffit de:

• une feuille de calcul vide est créée ou une feuille de calcul existante est utilisée
• une fiche technique "SEO Expertise" nommé et l'ID sera copié à partir de l'URL selon ce modèle.

Figure 6: URL Google Spreadsheets

Voici un exemple de fichier avec des données de démonstration visibles.

Le code est, comme mentionné, prêt dans cet esprit public à github.

Guide pas à pas: 5. Première exécution et planification du script

Étant donné que 26 requêtes d'API sont exécutées dans la configuration actuelle, une première exécution peut prendre jusqu'à 5 minutes. Dans l'élément de menu Affichage> Protocole d'exécution, les étapes exactes peuvent être comprises. L'exécution le démarre comme suit:

Figure 7: Run Histoire

Si tout fonctionne correctement, le tableau suivant devrait être visible dans l'onglet "SEO Expertise":

Figure 8: Tableau dans Google Spreadsheet

Chaque bloc de contenu est un objet ou une table distinct. Dans la présentation actuelle, nous n’avons pas encore fait le travail de traduction de chacun en un seul tableau. Avec la mise en forme conditionnelle, le Vues liste mais déjà un solide pouvoir explicatif, facilement comparable à d’autres projets:

Figure 9: Mise en forme conditionnelle dans le document Google Spreadsheet

Comme pour les 1-3 points gris prioritaires du site Web, les quantités de champs de problèmes de SEO Expertise peuvent être visualisées à l'aide des ensembles, ce qui permet de définir rapidement les priorités du projet pour la période suivante.

La dernière étape de l’automatisation est régulière déclencheurs de script, qui peut être réglé via l’icône d’horloge dans le coin supérieur gauche du menu. Il assure l'exécution automatisée à un moment récurrent. Ici, vous pouvez choisir entre les intervalles "horaire", "quotidien" et "hebdomadaire".

Figure 9: Définir le déclencheur de script

Intégration des données API SEO Expertise dans Google Data Studio

Ceux qui vivaient autrefois sous un rocher dans une grotte: Google Data Studio est un outil puissant pour connecter diverses sources de données et les visualiser dans un tableau de bord Web avec sélecteur de période, filtres et autres. Il ne reste plus beaucoup de souhaits.

Sur la base des Data Studio Hypes actuels (et justifiés), nous en avons profité pour concevoir une intégration exemplaire de SEO Expertise via Google Sheets.

Figure 10: Intégration exemplaire de SEO Expertise

Dans l'exemple de tableau de bord, les valeurs de liste jusqu'à la valeur maximale de 200 sont spécifiées pour 13 catégories de réussite de site Web, bien qu'elles puissent bien entendu être définies plus haut dans le script. Les valeurs peuvent donner une orientation rapide sur la santé du site et les potentiels importants. Dans l'exemple, les problèmes suivants peuvent être définis:

• Liaison interne: Beaucoup de pages ont peu ou pas de liens entrants, ainsi que de longs chemins de clic
• URL du sitemap: Il semble y avoir à la fois des URL incorrectes et des URL manquantes dans le sitemap.
• Page balisage: Il convient de remédier aux multiples balises h1, titres dupliqués et descriptions d'images manquantes
• Pagespeed & taille du fichier: En plus des fichiers et des pages volumineux, il semble y avoir trop de pages à chargement lent

Ici, le tableau de bord est prêt à être copié.

Après la copie, la feuille de calcul de démonstration peut également être clonée et liée au script.

Les données générées peuvent également être facilement combinées avec d'autres modèles, tels que le tableau de bord de la console de recherche, pour mapper des rapports de référencement riches dans Data Studio.

conclusion

La gestion de la qualité d'un site Web commence par le référencement sur page et l'exploration. Le script Google Apps facilite l’intégration des résultats du robot d'exploration de Website Success dans des structures de rapport personnalisées. La solution présentée est assez étroitement liée à la configuration, il existe certainement une implémentation plus élégante et générique. Nous sommes heureux des idées et des suggestions dans les commentaires!