Vai al contenuto
Anchor Social
Anchor SocialRegistrati

Risoluzione dei problemi

Come verificare i backlink tramite API quando i dati restituiti sembrano errati

Una tabella basata sui sintomi per i casi in cui l'estrazione degli anchor restituisce meno righe del previsto, costa più del previsto o non corrisponde ai dati del mese precedente.

Quattro tubi di argilla che alimentano un contenitore che rappresenta errori dei dati API e link bloccati

Controlla prima queste tre cose

La maggior parte delle estrazioni anomale risale a una di tre cause. Ognuna di queste può essere verificata in meno di un minuto, quindi è sensato escluderle prima che qualcuno perda un'ora sulle righe. Controlla queste tre: la chiave, il saldo dei crediti o la data dello snapshot.

Ogni risposta autenticata contiene ok e un oggetto _credits con il costo e il saldo residuo, quindi il primo passo è sempre stampare questi due campi. Inizia sempre da qui. Se ok è false, nulla delle righe ha ancora importanza.

Poi controlla il mese. Il nostro indice viene aggiornato circa una volta al mese e un link aggiunto la scorsa settimana potrebbe semplicemente non esservi ancora, il che non è un bug.

Un'abitudine in più. Tieni una riga di log per ogni chiamata con l'azione, il numero di pagina e il saldo residuo da _credits; rende facile rintracciare in seguito un credito mancante di 7 invece di avere un mistero a fine mese.

Sintomo, causa, soluzione

SintomoProbabile causaSoluzione
HTTP 401Chiave mancante o errataInvia key=sk_... o Authorization: Bearer sk_...; ricopiala dalla pagina dell'account
HTTP 402Crediti esauritiRicarica in USDT (TRC-20) dalla pagina dell'account e riprova
Numero di righe inferiore al totale previstoUna singola chiamata restituisce fino a 1.000 righeAggiungi page=2, page=3; la paginazione profonda si ferma a 50.000 righe
Il costo sembra superiore a 2 creditiÈ stata eseguita un'azione diversaanchors costa 2 crediti; keyword e search costano 3; controlla il valore di action
Il totale differisce da quello del mese scorsoL'indice è stato aggiornatoConfronta gli snapshot solo all'interno dello stesso strumento e della stessa cadenza mensile
Manca un nuovo linkIl link è apparso dopo l'ultimo aggiornamentoAttendi il prossimo aggiornamento mensile; non eseguire un nuovo pull per recuperarlo
La quota del brand aumenta improvvisamenteI link sitewide hanno aggiunto molte righeRicalcola collegando il dominio, consulta il runbook
Numeri diversi da Ahrefs o SemrushCrawl e date di aggiornamento diversiScegli una fonte per i trend; usa l'altra per verifiche puntuali

Leggere correttamente un risultato breve

Un dominio piccolo potrebbe semplicemente avere pochi anchors. Un dominio registrato di recente o con poche pagine contenenti link esterni può produrre un elenco breve per motivi perfettamente ordinari. Breve non significa difettoso. Non ogni elenco breve è un fallimento.

Confronta il numero di righe con le figure overview gratuite per lo stesso dominio: se overview segnala migliaia di backlink e anchors restituisce quaranta righe nella prima pagina, probabilmente ti serve la pagina due, non un ticket di supporto. Se anche overview segnala solo un numero limitato, il dominio è giovane o piccolo e il pull è corretto. Conta prima, poi lamentati.

Accade anche il contrario. I domini enormi raggiungono il limite di paginazione a 50.000 righe, quindi ordina per la colonna che ti interessa e prendi la fetta superiore, oppure chiama prima anchor_cloud per vedere quali termini dominano prima di scorrere tutto.

Ingranaggi di arginta intrecciati di varie dimensioni che mostrano come le impostazioni influenzano i risultati

Le impostazioni di ordinamento e paginazione cambiano ciò che vedi

Due pull possono differire per un motivo che non ha nulla a che fare con il web. Ordine, direzione e dimensione della pagina agiscono insieme, quindi modificare uno di questi può riordinare l'intero risultato anche quando il dominio e la chiave restano esattamente gli stessi. L'ordinamento, la direzione e la dimensione della pagina decidono quali righe vengono per prime e quante arrivano per chiamata. Controlla prima queste impostazioni.

Stesso dominio, leader diversi

Le prime righe seguono l'ordinamento richiesto, quindi un file ordinato in un modo non sembrerà un file ordinato in un altro modo. L'ordinamento cambia i leader. Se un file ha come leader i siti che rimandano più grandi e il successivo ha come leader le righe più recenti, entrambi possono essere corretti. Annota l'ordinamento nel nome del file.

Un test rapido aiuta. Esegui il test prima su un dominio piccolo, in modo che il test costi quasi nulla e dia una risposta chiara sulla richiesta. Chiama la stessa azione due volte con parametri identici. Se le righe corrispondono, la differenza risiede nella richiesta, non nei dati.

La pagina due non è una copia della pagina uno

Ogni pagina è una chiamata separata con la propria riga di fatturazione e le righe di una pagina non dovrebbero ripetersi nella successiva. Le pagine sono chiamate distinte. Quando ciò accade, probabilmente il loop ha mantenuto lo stesso valore di pagina. Stampa il primo dominio di ogni pagina per confermare che i numeri cambino.

Tieni il numero di pagina nel tuo log accanto al saldo. Un loop che si blocca sulla pagina due è molto più facile da risolvere quando puoi vedere la chiamata esatta che si è fermata. I log fanno risparmiare ore.

Testa prima due pagine. Un breve test dopo le prime due pagine è sufficiente. Se la pagina due ripete la pagina uno, ferma il loop prima che il saldo paghi per le stesse righe due volte.

Stampa i campi di fatturazione prima di qualsiasi altra cosa

Una protezione di tre righe che puoi incollare in uno script cron.

bash
R=$(curl -s "https://anchorsocial.org/api.php?action=anchors&q=example.com&per=1000&key=$KEY")
echo "$R" | jq '{ok, _credits}'
[ "$(echo "$R" | jq -r .ok)" = "true" ] || exit 1

Ripristina l'ordine quando un estratto sembra errato

Lavora dall'alto verso il basso. Ogni passaggio rimuove una famiglia di cause prima che inizi il successivo.

  1. 1

    Conferma che la chiamata sia andata a buon fine

    Leggi ok nella prima risposta. Se è falso, le righe non hanno ancora importanza.

  2. 2

    Confronta i parametri

    Verifica action, q, sort, order, per e page rispetto al file con cui stai confrontando.

  3. 3

    Verifica la data di indicizzazione

    Verifica se un aggiornamento mensile è avvenuto tra i due estratti e annota quella data nel foglio.

  4. 4

    Ricostruisci la richiesta da zero

    Riscrivi la chiamata parametro per parametro, per cogliere un errore di battitura che un URL copiato potrebbe nascondere.

Buste di argilla sotto una lente d'ingrandimento che mostrano differenze sottili per la risoluzione delle controversie

Risolvere una controversia con il file del mese scorso

Quando due file sono in disaccordo, la domanda raramente riguarda chi abbia ragione. La maggior parte delle divergenze è causata da una modifica a un'impostazione non registrata, motivo per cui il log è più importante della memoria. La domanda è quale parte della richiesta sia cambiata tra i due. Osserva prima la richiesta. Esegui tre verifiche in ordine e la maggior parte delle controversie si risolve al primo passaggio.

Inizia con la data di indicizzazione

L'indicizzazione si aggiorna circa una volta al mese e questo aggiornamento è la prima cosa da escludere. Un link diventato attivo dopo l'ultimo aggiornamento non apparirà in nessuno dei due file e un nuovo estratto nello stesso giorno non risolverà il problema. Le date di aggiornamento spiegano le lacune.

Etichetta ogni file. Un file nominato con la data dell'estratto e il suo ciclo di aggiornamento risponde alla domanda più comune prima che qualcuno debba farla in riunione. Scrivi il ciclo di aggiornamento accanto al nome di ogni file. In questo modo, una lacuna appare come una lacuna temporale, non come una lacuna sul web.

Mantieni le date di aggiornamento in una singola colonna, non sparse tra le note. Un lettore che vede le date accanto ai totali raramente ha bisogno di fare una seconda domanda. Questo risparmia una domanda.

Confronta elementi omogenei

Due file sono confrontabili solo quando l'azione, il dominio, l'ordinamento e il valore per corrispondono. Se l'ordinamento è diverso, le righe principali saranno diverse anche quando tutti i totali corrispondono, e questo può sembrare un cambiamento reale nel profilo. Mescolare un file di anchor con un file di backlink è un modo comune per inventare un calo che non è mai avvenuto. La corrispondenza delle impostazioni viene prima.

Se i parametri corrispondono e i totali sono ancora diversi, quella differenza merita un'analisi più attenta e il log ti dice da dove iniziare. Poi leggi il log.

Assegna al valore per una colonna propria, poiché cambia il numero di righe ricevute per chiamata e quindi il numero di chiamate necessarie per un estratto. Mantienilo visibile.

Quando le righe si sono spostate invece di scomparire

Dopo un cambio di dominio o una ristrutturazione, un link può ancora esistere e puntare a un nuovo indirizzo. I vecchi host mantengono i link. Confronta le pagine principali per il vecchio e il nuovo host prima di dichiarare il link perso. La checklist di migrazione illustra questo accoppiamento.

Registra entrambi i lati. Annota entrambi gli indirizzi su una riga, in modo che lo spostamento rimanga visibile nel foglio.

Costi che sorprendono le persone

Un conto che cresce più velocemente del piano di solito ha una causa. Molti team notano un conto più alto solo alla fine del mese, quindi un controllo settimanale del totale cumulativo cattura la deriva più presto. È l'azione. Molti lettori chiedono come verificare i backlink senza spendere troppo, e la risposta inizia con il nome dell'azione. Leggi il saldo in ogni risposta e mantieni un totale cumulativo accanto al tuo foglio.

Un saldo che si esaurisce più velocemente del previsto

I nomi delle azioni contano. Il colpevole di solito è il nome dell'azione. anchors costa 2 crediti, mentre keyword e search costano 3 ciascuno, quindi uno script che ha cambiato azioni in silenzio ha aumentato il conto. Verifica il valore action nella richiesta prima della prima esecuzione importante.

Traccia la deriva. Tieni un totale cumulativo di _credits nel foglio. Una piccola deriva giornaliera è facile da vedere lì, molto prima della fine del mese.

Un 402 a metà di un ciclo

Un 402 significa che il saldo è esaurito. Ferma il ciclo. Le chiamate già servite sono state fatturate, mentre la chiamata successiva fallisce. Ferma il ciclo, ricarica in USDT (TRC-20) dalla pagina dell'account e riprendi dalla pagina in cui ti sei fermato.

Un punto di ripresa è utile solo quando è annotato. Tieni il numero di pagina nel log, in modo che il riavvio non sia un'ipotesi. Scrivi il numero di pagina.

Leggere un risultato troppo grande

Un conteggio che cresce improvvisamente merita un'analisi della fonte prima che diventi una storia. Un singolo link template può aggiungere migliaia di righe e una riga di totale da sola non ti dirà se si tratta di un sito o di molti. Le righe potrebbero essere corrette e il motivo potrebbe risiedere in un dominio piuttosto che nell'intero profilo. Verifica prima la fonte.

Un footer sitewide dietro un grande conteggio

Un singolo link template che appare su migliaia di pagine di un singolo sito può spiegare un grande blocco di righe. Raggruppa l'estratto per dominio di collegamento e vedi quanto del totale è detenuto da un sito. Raggruppa prima, poi giudica.

Se un dominio domina, il totale è un fatto riguardante quel sito e l'analisi dovrebbe essere formulata in quel modo. Formulaiamola in quel modo.

Righe da un dominio a cui non hai mai linkato

Anchor strani meritano una verifica. La loro presenza non prova che qualcosa non vada, ma significa che la riga merita la stessa lettura di qualsiasi altra riga nella tua analisi. Domini di collegamento sconosciuti con anchor non correlati possono provenire da uno scraper o da una pagina compromessa. Apri una delle pagine di collegamento, come farebbe un visitatore, prima di assumere che le righe appartengano al tuo profilo.

Registra il dominio, la data e l'anchor nel foglio e mantieni la risposta grezza, in modo che una revisione successiva abbia le prove. Le prove battono la memoria.

Se la tabella non ha risolto il problema

  • Esegui un'azione gratuita come overview per lo stesso dominio; se funziona, il problema è la chiave
  • Conferma di aver digitato il dominio nudo in q, senza un percorso
  • Salva il JSON grezzo prima di modificare qualsiasi cosa
  • Verifica il saldo nella dashboard contro _credits
  • Contattaci dalla tua pagina account con l'azione e un timestamp

Risposte rapide

Una chiamata fallita costa crediti?

Un 401 o 402 restituisce prima che vengano servite delle righe. Ogni chiamata riuscita viene fatturata una volta, indipendentemente dal numero di righe fino a 1.000 righe. Verifica _credits nella risposta per confermare quanto è costata una data chiamata.

Perché due estratti nello stesso giorno potrebbero differire?

Non dovrebbero, perché l'indice cambia solo al suo aggiornamento mensile. Se lo fanno, confronta prima i parametri di ordinamento e pagina, poi la tua chiave e l'azione. La pagina del checker gratuito copre cosa restituiscono le chiamate senza chiave.