Configuration de l'outil de vérification du Domain Rating pour un tableau et un cron
Un workflow que personne n'a besoin de retenir vaut mieux qu'un que tout le monde a l'intention de faire. Six étapes vous permettent de passer d'un tableau vide à un job mensuel qui consigne ses propres coûts.
Équipe éditoriale ASEOTools ·
Six étapes, environ une heure
01
Connectez-vous et copiez la clé
Utilisez la connexion Google sur /auth/google.php. Le tableau de bord sur /account.php contient votre clé, qui commence par sk_ et arrive avec $100 de crédit.
02
Effectuez un appel de test gratuit
Exécutez l'action overview sans clé contre votre propre domaine. Si vous obtenez un JSON avec ok défini sur true, le chemin réseau fonctionne.
03
Construisez la liste des domaines
Une colonne dans un tableau, un domaine par ligne, sans https ni chemins. Jusqu'à 2 000 lignes peuvent être envoyées dans une seule requête bulk_dr.
04
Appelez bulk_dr depuis le tableau ou un script
Envoyez la liste comme une valeur GET jointe par des virgules ou comme un corps POST. Stockez la réponse dans un deuxième onglet avec une colonne de date.
05
Planifiez-le mensuellement
Exécutez le job quelques jours après le premier du mois, une fois que l'index mensuel a été actualisé. Une ligne cron suffit. Vérifiez manuellement la sortie du premier mois par rapport à trois domaines que vous connaissez bien.
06
Consignez les crédits et alertez en cas de solde bas
Chaque réponse authentifiée contient _credits avec le coût et le solde restant. Écrivez les deux dans une ligne de journal et envoyez-vous un email en dessous d'un seuil que vous choisissez.
Les éléments, prêts à être collés
Remplacez par votre propre clé et vos noms de fichiers.
bash
# crontab: 06:00 on the 4th of each month
0 6 4 * * /usr/bin/curl -s -X POST \
-H "Authorization: Bearer sk_live_..." \
-d "domains=$(paste -sd, domains.txt)" \
"https://aseotools.com/api.php?action=bulk_dr" >> dr_log.jsonl
Gardez la clé hors du tableau
Placez la clé dans les propriétés Apps Script, une variable d'environnement ou le magasin de mots de passe de votre outil d'automatisation. Quiconque a un accès en modification à un tableau peut lire une clé tapée dans une cellule, et une clé divulguée dépensera votre crédit.
Là où cette configuration échoue
Le silence est l'échec habituel. Un job cron qui échoue ressemble à un qui a réussi.
Vérifiez le code HTTP. Un 401 signifie que la clé est manquante ou incorrecte, et un 402 signifie que le crédit est épuisé, alors alertez pour l'un ou l'autre et corrigez-le avant la date limite du rapport du mois suivant.
N'oubliez pas que la pagination est limitée à 50 000 lignes de profondeur, et que bulk_dr prend jusqu'à 2 000 domaines par appel. Les listes plus longues nécessitent un fractionnement, ce qui est une boucle supplémentaire et coûte un crédit par chunk.
Testez d'abord manuellement. Exécutez la ligne cron dans un terminal, lisez le fichier journal et vérifiez que le solde a diminué exactement du coût attendu. Ensuite, voyez comment les chiffres se comparent à un plan suite et décidez à quelle fréquence le faire fonctionner.
Versionnez votre liste de domaines. Gardez le fichier dans un dépôt ou un lecteur partagé avec historique, afin que lorsqu'un nombre change en mars, vous puissiez voir si la liste a également changé. Ajoutez une colonne de note pour les domaines que vous avez ajoutés intentionnellement, comme un nouveau concurrent ou un client qui s'est inscrit ce mois-ci. Traitez la liste comme des données avec un propriétaire, car le bug le moins cher est celui que vous repérez dans un diff.
Fractionner une longue liste en chunks
Les longues listes sont là où une configuration soignée atteint ses limites. Un appel en masse prend jusqu'à 2 000 domaines, donc une liste de 5 000 nécessite trois requêtes, et le fractionnement doit se faire avant le premier appel.
Fractionnez par une règle stable, comme l'ordre trié de la colonne domaine. De cette façon, le même domaine atterrit dans le même chunk chaque mois, et la comparaison tient.
Listes de plus de 2 000 lignes
Écrivez chaque chunk dans le tableau comme son propre bloc, avec le numéro de chunk dans la première colonne. Un chunk en échec est alors facile à trouver.
Chaque chunk coûte un crédit, donc une liste de 5 000 lignes revient à 3 crédits par exécution, soit $0.0003. Un outil de vérification du Domain Rating n'est utile que dans la mesure où la liste qu'il lit l'est, alors gardez cette liste propre.
Si la liste dépasse 5 000 lignes, reconsidérez la mise en page du tableau lui-même. Un onglet par mois garde chaque exécution lisible lorsque les lignes s'empilent.
Relancer un seul chunk en échec
Si le chunk deux retourne une erreur, relancez uniquement le chunk deux. Relancer toute la liste dépenserait du crédit sur des lignes qui sont déjà revenues.
Consignez le numéro de chunk avec le code de statut, afin que la relance soit une ligne dans le journal, et non une recherche dans le tableau.
Maintenir la carte des chunks stable
Si l'ordre de la liste de domaines change, les chunks bougent, et une comparaison mois par mois est rompue. Triez la liste avant de la fractionner, à chaque fois.
Stockez la carte des chunks à côté de la liste.
Un test simple : choisissez n'importe quel chunk et recomptez ses lignes par rapport à la liste. Une incohérence signifie que la carte a dérivé, et cela est moins cher à trouver dans le tableau que dans le rapport.
Coût de toute la routine, avec des tailles d'exemple
Tailles de liste hypothétiques, prix des actions publiées.
Taille de la liste
Appels par mois
Crédits
Dollars
200 domaines
1
1
$0.0001
5 000 domaines
3
3
$0.0003
5 000 domaines plus 20 tirages complets de backlinks
23
43
$0.0043
Ce à quoi confirmer avant la première exécution planifiée
Testez un chunk manuellement et lisez la réponse complète
Confirmez que le solde a diminué exactement des crédits attendus
Vérifiez le code de statut pour chaque chunk, pas seulement le premier
Comparez trois domaines que vous connaissez bien avec des chiffres que vous faites déjà confiance
Définissez un chemin de fichier journal et décidez qui le lit chaque mois
Écrivez le nom du propriétaire en haut du tableau
Ce qu'une ligne de journal mensuelle utile contient
Un journal qui dit seulement ok n'est pas beaucoup un journal. Chaque exécution devrait écrire une ligne qu'une personne fatiguée peut lire en dix secondes : la date, le chunk, le statut, les crédits dépensés et le solde après l'appel.
Hypothétique : une ligne qui montre le chunk quatre, le statut 200, un crédit dépensé et le solde restant après l'appel répond à la plupart des questions un mois plus tard sans ouvrir la réponse.
Champs dignes d'être consignés
Consignez la date, le nom de la liste, le numéro de chunk, le code de statut, les crédits facturés et le solde après l'appel. Ces six champs couvrent la plupart des questions un mois plus tard.
Ajoutez une note en texte libre uniquement lorsqu'une personne a changé quelque chose manuellement.
Alertes qui ne crient pas au loup
Alertez immédiatement sur un 401 ou un 402, car les deux signifient que le job ne peut pas faire son travail. Une alerte de solde bas devrait utiliser le seuil que vous avez choisi, afin qu'elle se déclenche une fois et dise quoi faire ensuite.
Envoyez une alerte par exécution, pas une par ligne, ou la boîte de réception devient du bruit.
Questions de configuration
Un Google Sheet fonctionne-t-il comme le client ?
Oui. L'API est du REST simple avec CORS ouvert et des réponses JSON, donc Apps Script ou un appel de style IMPORTDATA peut y accéder. Gardez la clé dans les propriétés du script plutôt que dans une cellule que les collaborateurs peuvent lire.
Puis-je l'utiliser avec n8n ou Make ?
Oui, via un nœud de requête HTTP normal. Passez la clé en tant qu'en-tête Authorization Bearer, analysez la réponse JSON et écrivez le champ _credits dans votre journal afin de pouvoir voir les dépenses par exécution.
Pourquoi le journal affiche-t-il un coût plus élevé que prévu pour cet outil de vérification du Domain Rating ?
Comptez les appels, pas seulement la taille de la liste. Un chunk par exécution, une tentative ou un appel de test ajoute chacun son coût, et le champ _credits dans chaque réponse donne le chiffre exact pour cet appel.
La clé devrait-elle être dans la ligne cron elle-même ?
C'est plus simple, mais quiconque peut lire le crontab peut lire la clé. Chargez-la depuis un fichier avec des permissions restreintes ou depuis une variable d'environnement définie pour le job, et gardez-la hors des journaux partagés.
Qui remarque quand le job tombe en panne
Un job mensuel s'exécute sans que personne ne le regarde. C'est le point de l'automatiser, et c'est aussi pourquoi une panne peut rester inaperçue pendant des semaines.
Nommez la personne qui lit le journal et la personne qui répare le job. Deux noms valent mieux qu'un. Les vacances arrivent. Le runbook explique comment choisir la liste dès le départ.
Temps passé sur la configuration versus l'entretien
La première exécution prend la majeure partie de l'heure, car la clé, le tableau et l'appel de test nécessitent tous une attention. Après cela, la routine devrait nécessiter un coup d'œil chaque mois, pas une reconstruction.
Si l'entretien augmente, la liste est généralement la cause. Une liste qui change chaque semaine a besoin d'un propriétaire, d'une version et d'une règle pour les ajouts.
Rendre une panne visible
Une ligne manquante dans la sortie est plus facile à voir qu'une erreur silencieuse. Comparez le nombre de lignes avec la longueur de la liste à chaque exécution, et écrivez un avertissement lorsqu'ils diffèrent.
Gardez cet avertissement dans le même fichier journal, afin que la personne qui lit le journal le voie en premier.
Planification autour de l'actualisation de l'index
L'index s'actualise environ une fois par mois, donc une exécution le premier jour du mois peut lire des chiffres de la construction précédente. Exécuter quelques jours plus tard, comme le suggèrent les étapes ci-dessus, donne à l'actualisation le temps de se déployer.
Choisissez le même jour chaque mois pour que la série reste comparable, et écrivez ce jour dans un commentaire sur la ligne cron.
Quand arrêter l'automatisation
Un job qui s'exécute une fois par trimestre pourrait ne pas justifier une ligne cron. Un tableau et un rappel de calendrier peuvent suffire, et une routine semi-automatisée est pire qu'une manuelle claire.
Automatisez une fois que les mêmes étapes se sont exécutées proprement pendant plusieurs cycles de suite.
