Einrichtung des Domain-Rating-Tools für eine Tabelle und einen Cron-Job
Ein Workflow, an den sich niemand erinnern muss, schlägt einen, den sich jeder merken will. Sechs Schritte bringen Sie von einer leeren Tabelle zu einem monatlichen Job, der seine eigenen Kosten protokolliert.
Redaktionsteam von ASEOTools ·
Sechs Schritte, etwa eine Stunde
01
Anmelden und Key kopieren
Verwenden Sie die Google-Anmeldung unter /auth/google.php. Das Dashboard unter /account.php enthält Ihren Key, der mit sk_ beginnt und mit $100 Guthaben geliefert wird.
02
Einen kostenlosen Testaufruf durchführen
Führen Sie die Overview-Aktion ohne Key gegen Ihre eigene Domain aus. Wenn Sie JSON mit ok auf true zurückbekommen, funktioniert der Netzwerkpfad.
03
Die Domain-Liste erstellen
Eine Spalte in einer Tabelle, eine Domain pro Zeile, kein https und keine Pfade. Bis zu 2.000 Zeilen passen in einen einzelnen bulk_dr-Aufruf.
04
bulk_dr aus der Tabelle oder einem Skript aufrufen
Senden Sie die Liste als kommagetwerten GET-Wert oder als POST-Body. Speichern Sie die Antwort in einem zweiten Tab mit einer Datumsspalte.
05
Monatlich planen
Führen Sie den Job einige Tage nach dem ersten des Monats aus, sobald der monatliche Index-Refresh abgeschlossen ist. Eine Cron-Zeile reicht aus. Prüfen Sie die Ausgabe des ersten Monats manuell an drei Domains, die Sie gut kennen.
06
Credits protokollieren und bei niedrigem Kontostand warnen
Jede authentifizierte Antwort enthält _credits mit den Kosten und dem verbleibenden Guthaben. Schreiben Sie beides in eine Log-Zeile und senden Sie sich eine E-Mail unterhalb eines von Ihnen gewählten Schwellenwerts.
Die Bausteine, bereit zum Einfügen
Ersetzen Sie Ihren eigenen Key und Ihre Dateinamen.
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
Den Key aus der Tabelle halten
Legen Sie den Key in Apps Script-Eigenschaften, einer Umgebungsvariable oder dem Credential-Store Ihres Automatisierungstools ab. Jeder mit Bearbeitungszugriff auf eine Tabelle kann einen in eine Zelle eingegebenen Key lesen, und ein geleakter Key verbraucht Ihr Guthaben.
Wo diese Einrichtung scheitert
Stille ist der übliche Fehlerfall. Ein Cron-Job, der fehlschlägt, sieht genauso aus wie einer, der erfolgreich war.
Prüfen Sie den HTTP-Code. Ein 401 bedeutet, dass der Key fehlt oder falsch ist, und ein 402 bedeutet, dass das Guthaben aufgebraucht ist. Warnen Sie bei beiden und beheben Sie den Fehler, bevor der Bericht des nächsten Monats fällig ist.
Denken Sie auch daran, dass die Paginierung auf 50.000 Zeilen Tiefe begrenzt ist und dass bulk_dr bis zu 2.000 Domains pro Aufruf verarbeitet. Längere Listen erfordern Chunking, was eine zusätzliche Schleife bedeutet und einen Credit pro Chunk kostet.
Testen Sie zuerst manuell. Führen Sie die Cron-Zeile in einem Terminal aus, lesen Sie die Log-Datei und prüfen Sie, ob das Guthaben genau um die erwarteten Kosten gesunken ist. Vergleichen Sie dann die Zahlen mit einem Suite-Plan und entscheiden Sie, wie oft Sie ihn ausführen möchten.
Versionieren Sie Ihre Domain-Liste. Halten Sie die Datei in einem Repository oder einem gemeinsamen Laufwerk mit Historie, damit Sie sehen können, ob sich die Liste geändert hat, wenn sich eine Zahl im März ändert. Fügen Sie eine Notizspalte für Domains hinzu, die Sie absichtlich hinzugefügt haben, wie einen neuen Wettbewerber oder einen Kunden, der im Monat beigetreten ist. Behandeln Sie die Liste als Daten mit einem Eigentümer, denn der günstigste Fehler ist der, den Sie in einem Diff erkennen.
Eine lange Liste in Chunks aufteilen
Lange Listen sind dort, wo eine saubere Einrichtung an ihre Grenzen stößt. Ein Bulk-Aufruf verarbeitet bis zu 2.000 Domains, daher benötigt eine Liste mit 5.000 Domains drei Anfragen, und die Aufteilung muss vor dem ersten Aufruf erfolgen.
Teilen Sie nach einer stabilen Regel, z. B. der sortierten Reihenfolge der Domain-Spalte. So landet dieselbe Domain jeden Monat im selben Chunk, und der Vergleich bleibt gültig.
Listen mit mehr als 2.000 Zeilen
Schreiben Sie jeden Chunk als eigenen Block in die Tabelle, mit der Chunk-Nummer in der ersten Spalte. Ein fehlgeschlagener Chunk ist dann leicht zu finden.
Jeder Chunk kostet einen Credit, daher kostet eine Liste mit 5.000 Zeilen 3 Credits pro Durchlauf, was $0,0003 entspricht. Ein Domain-Rating-Tool ist nur so nützlich wie die Liste, die es liest, also halten Sie diese Liste sauber.
Wenn die Liste mehr als 5.000 Zeilen überschreitet, überdenken Sie das Layout der Tabelle selbst. Ein Tab pro Monat hält jeden Durchlauf lesbar, wenn die Zeilen anhäufen.
Einen fehlgeschlagenen Chunk erneut ausführen
Wenn Chunk zwei einen Fehler zurückgibt, führen Sie nur Chunk zwei erneut aus. Das erneute Ausführen der gesamten Liste würde Credits für bereits zurückgegebene Zeilen verbrauchen.
Protokollieren Sie die Chunk-Nummer mit dem Statuscode, damit der erneute Aufruf eine Zeile im Log ist und keine Suche durch die Tabelle.
Die Chunk-Karte stabil halten
Wenn sich die Reihenfolge der Domain-Liste ändert, bewegen sich die Chunks, und ein Vergleich von Monat zu Monat funktioniert nicht mehr. Sortieren Sie die Liste vor der Aufteilung jedes Mal.
Speichern Sie die Chunk-Karte neben der Liste.
Ein einfacher Test: Wählen Sie einen beliebigen Chunk und zählen Sie seine Zeilen gegen die Liste. Eine Diskrepanz bedeutet, dass die Karte abgewichen ist, und das ist in der Tabelle günstiger zu finden als im Bericht.
Kosten der gesamten Routine, mit Beispiellisten
Hypothetische Listen Größen, veröffentlichte Aktionspreise.
Listen Größe
Aufrufe pro Monat
Credits
Dollar
200 Domains
1
1
$0.0001
5.000 Domains
3
3
$0.0003
5.000 Domains plus 20 vollständige Backlink-Abfragen
23
43
$0.0043
Was Sie vor dem ersten geplanten Durchlauf bestätigen sollten
Testen Sie einen Chunk manuell und lesen Sie die vollständige Antwort
Bestätigen Sie, dass das Guthaben genau um die erwarteten Credits gesunken ist
Prüfen Sie den Statuscode für jeden Chunk, nicht nur für den ersten
Vergleichen Sie drei Domains, die Sie gut kennen, mit Zahlen, denen Sie bereits vertrauen
Legen Sie einen Log-Dateipfad fest und entscheiden Sie, wer ihn jeden Monat liest
Schreiben Sie den Namen des Eigentümers an den Anfang der Tabelle
Was eine nützliche monatliche Log-Zeile enthalten sollte
Ein Log, das nur ok sagt, ist kein echtes Log. Jeder Durchlauf sollte eine Zeile schreiben, die eine müde Person in zehn Sekunden lesen kann: das Datum, der Chunk, der Status, die verbrauchten Credits und das Guthaben nach dem Aufruf.
Hypothetisch: Eine Zeile, die Chunk vier, Status 200, einen verbrauchten Credit und das verbleibende Guthaben nach dem Aufruf zeigt, beantwortet die meisten Fragen einen Monat später, ohne die Antwort zu öffnen.
Felder, die es sich zu protokollieren lohnt
Protokollieren Sie das Datum, den Listenamen, die Chunk-Nummer, den Statuscode, die berechneten Credits und das Guthaben nach dem Aufruf. Diese sechs Felder decken die meisten Fragen ab, die einen Monat später auftauchen.
Fügen Sie nur einen Freitextnotiz hinzu, wenn eine Person etwas manuell geändert hat.
Warnungen, die nicht zum Wolf heulen
Warnen Sie sofort bei einem 401 oder 402, da beide bedeuten, dass der Job seine Arbeit nicht erledigen kann. Eine Warnung bei niedrigem Gutholen sollte den von Ihnen gewählten Schwellenwert verwenden, damit sie einmal auslöst und sagt, was als Nächstes zu tun ist.
Senden Sie eine Warnung pro Durchlauf, nicht eine pro Zeile, sonst wird der Posteingang zum Rauschen.
Einrichtungsfragen
Funktioniert ein Google Sheet als Client?
Ja. Die API ist plain REST mit offenem CORS und JSON-Antworten, daher können Apps Script oder ein IMPORTDATA-ähnlicher Aufruf darauf zugreifen. Halten Sie den Key in den Skript-Eigenschaften statt in einer Zelle, die Mitarbeiter lesen können.
Kann ich dies mit n8n oder Make verwenden?
Ja, über einen normalen HTTP-Anfrage-Knoten. Übergeben Sie den Key als Authorization Bearer Header, analysieren Sie die JSON-Antwort und schreiben Sie das _credits-Feld in Ihr Log, damit Sie die Ausgaben pro Durchlauf sehen können.
Warum zeigt das Log höhere Kosten an, als ich für dieses Domain-Rating-Tool erwartet habe?
Zählen Sie die Aufrufe, nicht nur die Listen Größe. Ein Chunk pro Durchlauf, ein Retry oder ein Testaufruf fügt jeweils seine Kosten hinzu, und das _credits-Feld in jeder Antwort gibt die genaue Zahl für diesen Aufruf an.
Sollte der Key in der Cron-Zeile selbst stehen?
Es ist einfacher, aber jeder, der die Crontab lesen kann, kann den Key lesen. Laden Sie ihn aus einer Datei mit eingeschränkten Berechtigungen oder aus einer Umgebungsvariable, die für den Job festgelegt ist, und halten Sie ihn aus gemeinsamen Logs fern.
Wer bemerkt, wenn der Job ausfällt
Ein monatlicher Job läuft, ohne dass jemand darauf achtet. Das ist der Punkt der Automatisierung, und genau deshalb kann ein Fehler wochenlang unbemerkt bleiben.
Nennen Sie die Person, die das Log liest, und die Person, die den Job repariert. Zwei Namen sind besser als einer. Ferien passieren. Das Runbook erklärt, wie man die Liste überhaupt auswählt.
Zeitaufwand für Einrichtung versus Wartung
Der erste Durchlauf nimmt die meiste Zeit in Anspruch, da Key, Tabelle und Testaufruf Aufmerksamkeit benötigen. Danach sollte die Routine monatlich nur einen Blick erfordern, keinen Neuaufbau.
Wenn die Wartung zunimmt, ist die Liste meist die Ursache. Eine Liste, die sich jede Woche ändert, benötigt einen Eigentümer, eine Version und eine Regel für Ergänzungen.
Einen Fehler sichtbar machen
Eine fehlende Zeile in der Ausgabe ist leichter zu sehen als ein stiller Fehler. Vergleichen Sie die Zeilenzahl mit der Länge der Liste bei jedem Durchlauf und schreiben Sie eine Warnung, wenn sie abweichen.
Halten Sie diese Warnung in derselben Log-Datei, damit die Person, die das Log liest, sie zuerst sieht.
Zeitplanung um den Index-Refresh herum
Der Index aktualisiert sich etwa einmal im Monat, daher kann ein Durchlauf am ersten des Monats Zahlen aus dem vorherigen Build lesen. Ein paar Tage später auszuführen, wie die Schritte oben vorschlagen, gibt dem Refresh Zeit, einzutreffen.
Wählen Sie jeden Monat denselben Tag aus, damit die Reihe vergleichbar bleibt, und schreiben Sie diesen Tag in einen Kommentar zur Cron-Zeile.
Wann man mit der Automatisierung aufhören sollte
Ein Job, der einmal im Quartal ausgeführt wird, rechtfertigt vielleicht keine Cron-Zeile. Eine Tabelle und eine Kalendererinnerung können ausreichen, und eine halbautomatisierte Routine ist schlechter als eine klare manuelle.
Automatisieren Sie erst, wenn dieselben Schritte mehrere Zyklen hintereinander sauber gelaufen sind.
