Douze termes issus du monde des données de liens et des pipelines de publication, chacun accompagné du nom de champ que vous lirez dans le JSON et de l'erreur courante qui y est associée.
Équipe de recherche SEOBlogBot ·
Comment lire cette page
Il s'agit d'une page de termes, pas de théorie. Accédez directement à l'entrée qui vous intéresse, car chacune est autonome.
Chaque entrée indique le nom de champ que vous verrez dans le JSON, sa signification brève et l'erreur que les gens commettent. Si vous manquez de temps, lisez d'abord la ligne sur l'erreur.
Les termes suivent l'ordre dans lequel un pipeline les rencontre : d'abord les données de liens, puis la facturation, ensuite les échecs, et enfin les vérifications validées par l'équipe.
Les gens recherchent un vérificateur de backlinks SEO Moz parce qu'ils ont vu l'Autorité de Domaine (DA) dans un rapport et souhaitent obtenir le même chiffre dans un script. Notre notation est une métrique différente ; chaque entrée précise ce que le terme signifie ici et en quoi il diffère des grands outils.
Trois confusions qui coûtent du temps réel
Les comptes sont plus souvent mélangés que tout le reste, y compris les chiffres d'un rapport vérificateur de backlinks SEO Moz. Un site avec 10 000 backlinks provenant de 40 domaines référents est bien plus petit, en termes de graphe de liens, qu'un site avec 2 000 backlinks provenant de 900 domaines référents.
Notre notation est construite sur les domaines référents pour cette raison. Un filtre qui lit les totaux bruts de backlinks est facile à tromper avec un seul lien en pied de page sur tout le site.
Une quatrième erreur consiste à lire une notation sans sa date. Une notation de printemps et une d'automne ne sont pas la même mesure une fois que l'index a été actualisé entre les deux.
Datez chaque notation que vous copiez dans un rapport, même si celui-ci ne contient qu'une seule colonne de chiffres.
Utilisez un seul nom pour chaque élément à travers l'équipe et les journaux, afin qu'une recherche trouve toutes les lignes pertinentes.
Le deuxième piège est le mot « gratuit ». overview est gratuit, mais refdomains coûte 2 crédits, et la première réponse contenant _credits est l'endroit où vous apprenez quel type d'appel vous avez effectué.
Lire une notation sans se tromper
Une notation est un chiffre sur une échelle, et cette échelle a une forme. Deux idées sont les plus importantes. Elles apparaissent à nouveau dans les guides de filtre et d'audit, alors clarifiez-les ici.
Pourquoi l'échelle est logarithmique
Passer de 20 à 30 domaines référents fait bouger la notation bien plus que passer de 400 à 410. Une échelle logarithmique compresse les grands nombres, de sorte que le haut de la plage évolue lentement. Planifiez les seuils en tenant compte de cette forme, plutôt que de traiter chaque point comme égal.
Ce qu'est un plancher
Un plancher est la notation minimale que vous acceptez pour un hôte sortant. Il s'agit d'une règle locale, définie à partir de vos propres publications, et aucune autre équipe ne l'utilise. Notez-le avec la date à laquelle vous l'avez défini, afin qu'une révision ultérieure sache contre quoi il a été mesuré.
Un plancher défini à partir de trente publications est un point de départ. Il ne devient une règle qu'après qu'une équipe l'a utilisé au moins pendant une actualisation complète.
Lire une réponse champ par champ
Commencez par ok. Chaque réponse le contient, et les réponses authentifiées ajoutent _credits avec le coût et le solde restant.
Analysez ces deux éléments avant tout le reste. Un pipeline qui lit des données à partir d'une réponse avec ok false écrira joyeusement des données erronées dans votre journal, donc cette vérification ne coûte qu'une ligne de code.
Conservez la réponse brute pour chaque échec. Les noms de champs sont sensibles à la casse dans la plupart des analyseurs. Faites correspondre ok et _credits exactement. Lorsqu'un nombre semble incorrect dans un rapport mensuel, la réponse stockée montre ce que l'API a réellement envoyé, ce qui est le moyen le plus rapide de trancher le débat.
Termes liés aux données de liens
01
Domaine référent
Un site distinct qui fait un lien vers le vôtre, compté une seule fois quel que soit le nombre de liens qu'il envoie. L'action refdomains les liste, 2 crédits par appel.
02
Backlink
Un lien d'une page à une autre. Notre index en contient environ 798,5 milliards, et l'action backlinks renvoie jusqu'à 1 000 lignes par appel.
03
Texte d'ancrage
Les mots cliquables d'un lien. anchors renvoie la distribution, et un amas artificiel d'une seule phrase est ce qu'il faut surveiller.
04
DR (notre notation)
round(100 x log(ref_domains + 1) / log(20 000 000)). Une échelle logarithmique, donc passer de 20 à 30 est un saut plus important que de 60 à 70.
05
DA et DR Ahrefs
Métriques d'autres outils avec leurs propres formules. Elles ne correspondront pas à notre chiffre, donc ne les mélangez jamais dans un même seuil.
06
Graphe de liens
La carte de qui fait un lien vers qui. Le nôtre compte 181 132 097 domaines et 2 774 625 913 liens de domaine à domaine.
Termes financiers expliqués simplement
Les termes de facturation apparaissent dans chaque revue de pipeline, et chacun a une signification spécifique ici. La plupart des confusions proviennent de l'hypothèse qu'un mot signifie ce qu'il signifie sur une facture d'abonnement.
Crédit prépayé
Vous achetez du crédit à l'avance, et chaque appel payé le diminue. Il n'y a pas d'abonnement à annuler ni de minimum mensuel à respecter.
Recharge en USDT (TRC-20)
Vous ajoutez du solde depuis la page de compte, en payant en USDT sur le réseau TRC-20. Les recharges sont ce qui fait croître le solde, donc un job qui s'arrête sur 402 en aura besoin avant de pouvoir s'exécuter à nouveau.
Actions gratuites et payantes
Les actions gratuites sont domain, overview, stats et suggest. Toutes les autres actions consomment du crédit, de 1 à 3 par appel, et la réponse indique le montant exact.
Un calcul rapide aide : à 0,0001 $ par crédit, mille appels payants coûtant chacun un crédit reviennent à environ un dixième de dollar.
Termes d'échec importants dans un pipeline
Un pipeline peut échouer de manières qu'un seul appel ne montre jamais. Ces trois termes nomment les échecs que les équipes manquent le plus souvent. La plupart n'apparaissent que lorsqu'un job s'exécute sans surveillance. Personne ne regarde une exécution planifiée.
Les équipes qui notent ces termes tôt passent moins de temps à se disputer à leur sujet plus tard.
Échec partiel
Un job qui fait quatre choses et en accomplit trois a échoué de la manière qui compte. La publication est à moitié traitée, et rien dans les journaux ne l'indique à moins que quelqu'un ne vérifie chaque étape. La correction consiste à avoir un résultat par étape, afin que le journal nomme l'étape qui n'a pas terminé.
Postcondition
L'état dans lequel le job s'est engagé à laisser les choses, comme une publication marquée Scheduled avec une heure de publication. Vérifiez la postcondition après l'action, pas seulement le code d'état de l'appel. Formulez-la sous forme de question par oui ou par non, par exemple si le statut est Scheduled et si l'heure de publication est toujours dans le futur.
Résultat vide
Une réponse qui réussit mais ne contient aucune ligne. C'est une question à investiguer, pas un fait à journaliser silencieusement. Comparez-le avec le même domaine du mois dernier avant de décider de ce qu'il est.
Suivez une réponse de la requête à la ligne de journal
Le même chemin fonctionne pour chaque action, donc écrivez-le une fois et réutilisez-le pour chaque appel.
01
Envoyer la requête
Appelez l'endpoint avec la clé dans un en-tête Bearer, et placez l'action et le domaine dans la chaîne de requête.
02
Vérifier le statut HTTP
Un 401 ou 402 arrête le job avant toute analyse.
03
Analyser le JSON
Confirmez que le corps se parse et que ok est true. Seulement alors lisez les champs de données.
04
Écrire la ligne
Stockez la date, l'action, la valeur _credits et le solde. Une ligne par appel garde le journal facile à sommer.
Termes de pipeline
01
Filtre (Gate)
Une vérification qui peut arrêter une publication avant son envoi. Consultez l'arbre de décision.
02
Audit
Une vérification qui s'exécute après la publication et rapporte au lieu de bloquer. Le manuel d'exécution contient un calendrier.
03
Exécution idempotente
Un job que vous pouvez répéter sans changer le résultat. Les appels API en lecture seule sont idempotents ; vos alertes Slack ne le sont généralement pas, donc dédupliquez-les.
04
Crédit
L'unité de facturation. Un crédit équivaut à 0,0001 $, et le champ de réponse _credits indique le coût et le solde.
05
HTTP 401 vs 402
401 signifie une clé manquante ou invalide ; 402 signifie que le crédit est épuisé. Relancer ne corrige ni l'un ni l'autre.
06
Fenêtre d'actualisation
Nos données sont actualisées environ une fois par mois. Un nouveau lien peut ne pas apparaître pendant des semaines, donc les alertes doivent comparer les mois.
Une erreur qui se répète
Les équipes définissent un plancher DR à partir d'une capture d'écran d'un autre outil, comme le DA Moz ou le DR Ahrefs, puis s'étonnent que la moitié des bonnes publications soient retenues. Calibrez d'abord sur vos propres publications.
Termes à valider avant d'écrire un manuel d'exécution
Quel champ de la réponse décide du passage ou de l'échec.
Si un résultat vide est un avertissement ou une erreur.
Qui est responsable de l'alerte lorsque le crédit est épuisé.
Le format de date et le fuseau horaire utilisés dans le journal.
Ce qui compte comme un changement significatif entre deux instantanés mensuels.
Où les termes s'arrêtent
Certains termes ici sont les nôtres, comme DR et le crédit. Si un terme diffère de ce que votre propre réponse montre, faites confiance à la réponse.
Lorsqu'un collègue cite un DA Moz, vérifiez quelle métrique il désigne avant de la comparer avec la nôtre. Les deux utilisent des entrées et des formules différentes, donc un chiffre ne peut jamais remplacer l'autre.
Gardez cette page ouverte pendant que vous rédigez la première version du job, et fermez-la une fois que les lignes de journal ont du sens par elles-mêmes.
Choisissez une personne pour répondre aux questions sur ces termes, afin que les réponses restent cohérentes à travers l'équipe.
Les termes ne servent à rien s'ils ne sont pas utilisés de la même manière par tous ceux qui lisent le journal. Validez le sens avant la première exécution, et la page remplira sa fonction.
Notez la différence avant de modifier du code. La page de compte est l'endroit où les questions sur votre propre compte commencent.
