Ricetta della mappa di reindirizzamento: classifica i vecchi URL in base ai link che contengono
Una mappa di reindirizzamento è un elenco di priorità, non un foglio di calcolo con tutti gli URL. Inizia con le pagine a cui altri siti linkano, e il resto della mappa sarà più semplice.
Team di ricerca ArchiLinks ·
Perché classificare in base ai link
I team creano le mappe partendo dal crawl. È completo. Tratta però una pagina di stampa dimenticata del 2014 come se fosse la homepage.
Quando controlli i backlink verso il mio sito e ordini le pagine in base al numero di domini che linkano, emerge un pattern nella maggior parte delle migrazioni: una decina di URL concentrano la maggior parte del valore esterno. Questi URL vengono abbinati manualmente, revisionati due volte e testati per primi.
Il resto segue delle regole. Le cartelle vengono mappate per pattern, i parametri vengono rimossi e gli URL orfani senza link né traffico possono restituire un 410 se lo decidi. Abbinare l'output alla checklist di migrazione garantisce che la mappa venga testata prima del lancio e verificata nuovamente al giorno 45, insieme agli script API per pianificare l'estrazione mensile.
Passaggio 1: estrai le pagine linkate
Una chiamata restituisce fino a 1.000 righe e costa 2 crediti, indipendentemente dal numero di righe. I nomi dei campi qui sotto sono un esempio; guarda una risposta reale e adatta le chiavi.
import csv, requests
BASE = "https://archilinks.com/api.php"
KEY = "sk_live_..."
def call(action, **params):
r = requests.get(BASE, params={"action": action, "key": KEY, **params}, timeout=30)
r.raise_for_status()
return r.json()
data = call("toppages", q="old-shop.com", per=1000)
rows = next(v for v in data.values() if isinstance(v, list))
with open("linked-pages.csv", "w", newline="") as f:
w = csv.writer(f)
w.writerow(["old_url", "links", "new_url"])
for row in rows:
w.writerow([row.get("url"), row.get("backlinks"), ""])Passaggio 2: compila la terza colonna
Abbinamento per significato
Una pagina prodotto va al prodotto stesso, o alla sua categoria se il prodotto non è più disponibile. Mai alla homepage a meno che la pagina non fosse la homepage.
Fai controllare le prime 50 da una seconda persona
Una persona stanca alle 18:00 mappa una guida sui canonical su un indice del blog. Un revisore lo cattura.
Regole per la coda lunga
Scrivi pattern per le cartelle e rimuovi i parametri di tracciamento. Tieni ogni regola nel controllo di versione con un commento che spieghi il motivo.
Passaggio 3: genera le regole del server
nginx legge bene un file di mappa e scala fino a decine di migliaia di righe.
# /etc/nginx/redirects.map (generated from the csv)
/old/guide-canonicals /guides/canonical-tags;
/products/blue-widget /shop/widgets/blue;
# in nginx.conf, http context
map $request_uri $new_uri {
default "";
include /etc/nginx/redirects.map;
}
# in the server block of the old host
if ($new_uri) {
return 301 https://new-shop.com$new_uri;
}
Passaggio 4: testa ogni passaggio
Fallisci il pipeline su qualsiasi cosa non sia un singolo 301 verso un 200.
while IFS=, read -r old new; do
out=$(curl -s -o /dev/null -w "%{http_code} %{num_redirects} %{url_effective}" -L "https://old-shop.com$old")
echo "$old -> $out"
done < redirect-pairs.csv | grep -v "^.* -> 200 1 " && echo "FIX ABOVE"Errori che controlleremmo per primi
| Sintomo | Presunta causa | Soluzione |
|---|---|---|
| Catene di due o tre passaggi | Vecchie regole sovrapposte alle nuove | Indica la vecchia regola direttamente verso l'URL finale |
| Tutto atterra sulla homepage | Regola catch-all pigra | Abbinamento per argomento; Google potrebbe trattare i reindirizzamenti di massa alla homepage come soft 404 |
| Stringhe di query perse | La regola elimina gli argomenti | Trasferisci i parametri che modificano il contenuto; rimuovi il resto |
| L'URL principale restituisce 404 dopo il lancio | Escluso dal CSV | Riesegui l'estrazione e confronta con la mappa live |
Quali URL meritano una riga abbinata manualmente
Non ogni URL merita una persona. Una suddivisione utile è per domini linkanti: qualsiasi URL con diversi siti esterni che puntano ad esso viene abbinato manualmente, mentre il resto segue un insieme di regole. Supponi di avere 4.000 vecchi URL e che 60 di essi concentrino la maggior parte dei link esterni. Quei sessanta richiedono un pomeriggio di revisione, mentre gli altri 3.940 richiedono un pattern e un test.
Mantieni la soglia nello script, non nella testa di qualcuno. Cinque domini linkanti è un buon punto di partenza per un sito medio. Inizia da lì. Abbassa il numero quando l'intero sito ha pochi link, e aumentalo quando l'elenco manuale diventa troppo lungo per un revisore.
Mantenere separate le righe abbinate manualmente e quelle abbinate per regola
Le righe abbinate manualmente hanno un revisore nominativo e una nota sul motivo della scelta del target. Le righe abbinate per regola hanno un pattern testato su tutta la cartella, così un'anomalia appare nel report di test prima del lancio piuttosto che nel grafico del traffico dopo.
I casi misti causano la maggior parte delle confusioni. Un prodotto discontinuato e sostituito da un successore mappa verso il successore. Uno discontinuato senza successore appartiene alla sua categoria, mai alla homepage.
Utilizzare un secondo estratto per vedere cosa è cambiato
Esegui refdomains per il vecchio host prima che la mappa sia definitiva, poi di nuovo dopo il lancio, e confronta le due liste per dominio. Un dominio linkante mancante dal secondo estratto è una domanda da porre al proprietario del link, non un motivo di allarme, poiché un link rimosso può richiedere tempo per essere rimosso dall'indice.
Tieni entrambi i file affiancati nella cartella di migrazione, con la data in ogni nome. Il diff ti dice dove guardare, e la mappa ti dice cosa hai fatto al riguardo.
Decidere cosa fare con gli URL senza link
Gli URL orfani senza link né traffico sono la parte facile. Restituisci un chiaro 404 o un 410 quando il contenuto è scomparso definitivamente, e reindirizza solo quando esiste un sostituto vicino, così che visitatori e crawler atterrino ovunque utile.
Quando sei incerto, lascia una breve nota nella mappa e torna dopo la prima settimana di log. Il log del server mostra quali vecchi indirizzi ricevono ancora richieste, che è la migliore evidenza che avrai.
Come la mappa si inserisce in un rilascio
Una mappa di reindirizzamento cambia con il sito. Tienilo a mente. Appaiono nuove pagine, le vecchie vengono rinominate e un cambiamento di template può rompere una regola che sembrava sicura il mese scorso. Tratta la mappa come codice, con un file nel controllo di versione, una revisione prima di ogni deploy e un'esecuzione di test su ogni modifica.
Mantieni la mappa in un unico strato dove possibile. I reindirizzamenti distribuiti tra l'applicazione, la CDN e il CMS sono il modo in cui appaiono le catene, e le catene sono difficili da individuare senza un crawl completo.
Dove dovrebbero risiedere le regole
Una mappa del server è veloce e facile da testare. Un plugin CMS è utile per un paio di pagine, ma è difficile da auditare su larga scala. Qualunque tu scelga, il test a un solo passaggio deve leggere dallo stesso punto.
Se due strati reindirizzano lo stesso URL, il test segnala una catena. Rimuovi il duplicato dallo strato che intendi ritirare.
Test sull'host reale dopo ogni modifica
Esegui il test dei passaggi su staging, poi su produzione, dopo ogni modifica al file delle regole. Una regola che passa su staging può ancora fallire una volta che una cache tiene una risposta vecchia, quindi la seconda esecuzione è importante.
Salva l'output con la data. Quando un URL principale si rompe mesi dopo, il vecchio risultato mostra se la regola è cambiata o se è cambiato il sito. La checklist di migrazione elenca quando appartiene questo test, e eseguirlo per primo mantiene il controllo successivo confrontabile con questo.
Revisione di una modifica al file delle regole
Nomina un revisore per le modifiche alla mappa, e chiedi a quella persona di controllare tre cose: se ogni target corrisponde ancora all'argomento, quanti passaggi crea la regola e se il pattern è abbastanza stretto da toccare solo gli URL per cui è stato scritto. Una modifica non revisionata è quella che più probabilmente avvia una catena.
Chiedi la stessa revisione quando il sito stesso cambia. Una nuova categoria che assorbe una vecchia cartella può far sì che una regola corretta punti nel posto sbagliato senza che nessuno modifichi la mappa.
Archivia la nota del revisore accanto alla modifica. Sei mesi dopo, la nota spiega una regola che altrimenti sembrerebbe arbitraria, e risparmia una seconda indagine sulla stessa domanda.
Testare un campione prima dell'esecuzione completa
Prima di eseguire l'elenco intero, scegli un campione di cinquanta righe che mescoli le pagine più linkate con alcune ordinarie. Esegui il test dei passaggi su quel campione prima. Il campione è veloce da leggere, e un errore di regola appare in esso molto prima che appaia su tutto il file.
Includi almeno una riga da ogni pattern di regola e una da ogni gruppo abbinato manualmente. Un pattern che copre una cartella di duecento URL è testato solo dalle righe che capitano di essere nel campione, quindi sceglile appositamente.
Mantenere piccoli i file delle regole
Un file di regole che cresce oltre poche centinaia di pattern diventa difficile da revisionare. Dividilo per sezione del sito e mantieni ogni file abbastanza breve da essere letto in una sola seduta da un revisore.
Rimuovi una regola il giorno in cui la sua cartella scompare. Le vecchie regole lasciate indietro sono quelle che in seguito inviano traffico in una catena.
Prima che la mappa vada live
- Ogni riga ha un nuovo URL, o un 404 o 410 deliberato.
- Nessun target è a sua volta un reindirizzamento.
- I 50 URL con più domini linkanti sono stati revisionati da una seconda persona.
- I parametri di query che modificano il contenuto vengono trasferiti.
- Il file delle regole è nel controllo di versione, con un commento su ogni pattern.
- Una baseline dei domini di riferimento è salvata per il diff post-lancio.
Domande sui reindirizzamenti che continuano ad arrivare
- Dovrei rimuovere i vecchi reindirizzamenti dopo un anno?
- Molti team di migrazione li mantengono per almeno un anno. Oltre quello, mantienili finché gli URL vecchi ricevono ancora link esterni o traffico. I reindirizzamenti costano quasi nulla da servire, quindi raramente c'è una buona ragione per eliminarli prima.
- Va bene reindirizzare solo le pagine indicizzate?
- No se gli non indicizzati hanno link. Lo stato di indicizzazione dice poco sul valore esterno. Reindirizza ogni URL che ha un dominio linkante, poi decidi sul resto in base al traffico.
- E 302 o 307 per un trasferimento permanente?
- Usa 301 o 308 per trasferimenti permanenti. Un 302 lasciato in posizione per anni potrebbe essere trattato come permanente, ma quel risultato è lasciato al caso, e altri client del reindirizzamento potrebbero non indovinare allo stesso modo.
- Posso reindirizzare i 404 dal vecchio sito al nuovo?
- Solo quando esiste una corrispondenza stretta. Un reindirizzamento a una pagina non correlata è un soft 404 agli occhi di Google. Restituisci un vero 404 o 410 quando il contenuto è scomparso.
