Migrare da Rebrandly: guida a export, import e cutover DNS

Per migrare da Rebrandly si fanno tre cose: estrarre i link tramite l'API di Rebrandly, ricreare ogni slashtag su un dominio che controlli in Elido e poi puntare il DNS di quel dominio a Elido. L'importer Rebrandly integrato in Elido gestisce le prime due per i campi che supporta (slashtag, destinazione, titolo, tag). Il cambio DNS, lo storico dei click e le regole di routing restano a tuo carico.

Ciò che sorprende le persone è il dominio. I link sul tuo hostname mantengono gli URL esatti, quindi il redirect che un visitatore ottiene il lunedì è lo stesso del venerdì. I link su rebrand.ly non possono spostarsi, perché non possiedi quell'host. Questa guida percorre tutto il viaggio in ordine: export, mappatura, import, cutover DNS, 301 intatti, verifica, rollback e cosa aspettarsi dalle analytics. Tutto ciò che riguarda Elido qui sotto è stato verificato sul sorgente dell'importer e sulla dashboard; tutto ciò che riguarda Rebrandly viene dal suo centro assistenza e dalla documentazione per sviluppatori, consultati il 2026-10-02.

Se stai ancora decidendo se lasciare Rebrandly, parti da Elido contro Rebrandly. Se hai già deciso, continua a leggere.

La migrazione da Rebrandly in sintesi

La versione breve, per chi vuole il piano prima del dettaglio:

1. Scarica ogni link con GET /v1/links in un file JSONL da conservare come traccia di audit.
2. Decidi per ogni dominio: il tuo hostname si sposta con un cambio di CNAME, i link rebrand.ly ottengono nuovi URL.
3. Aggiungi il dominio di destinazione in Elido e pubblica il suo record TXT di verifica.
4. Esegui l'importer (o l'API bulk) con una strategia di conflitto che non possa cambiare gli slug in silenzio.
5. Cambia il CNAME, controlla da resolver pubblici, prova i link principali.
6. Lascia Rebrandly attivo per 30 giorni come rollback.

Per qualche migliaio di link l'import richiede minuti. Il tempo di calendario se ne va in TTL del DNS, test e sovrapposizione di 30 giorni.

Passo 1: esporta i link da Rebrandly

Rebrandly espone i link tramite la sua API REST, ed è il percorso di export che usa ogni strumento di migrazione, Elido compreso. GET /v1/links restituisce fino a 25 link per pagina, ordina per createdAt e può filtrare per domain.id o domain.fullName. La paginazione è a cursore: passa come last l'id dell'ultimo link ricevuto, come descrive la documentazione sulla paginazione.

I file sono più difficili. L'articolo di Rebrandly su come spostare i link su un nuovo dominio dice che non esiste un comando integrato; la soluzione è esportare via API in CSV, modificare la colonna del dominio e reimportare. La sua guida all'import copre la direzione opposta (CSV fino a 400.000 link per file, dominio personalizzato obbligatorio). Quindi usa l'API e tieni una copia tua:

# Dump every link to links.jsonl (25 per page, cursor = id of last link)
last=""
while :; do
  page=$(curl -s -H "apikey: $REBRANDLY_KEY" \
    "https://api.rebrandly.com/v1/links?limit=25&orderBy=createdAt&orderDir=asc${last:+&last=$last}")
  [ "$(echo "$page" | jq 'length')" -eq 0 ] && break
  echo "$page" | jq -c '.[]' >> links.jsonl
  last=$(echo "$page" | jq -r '.[-1].id')
done
wc -l links.jsonl

Il file è la tua base per il conteggio, la tua fonte delle date di creazione originali e l'input per qualsiasi correzione via script. Una trappola: una chiave API di Rebrandly vede ogni link in ogni workspace a cui appartiene l'utente. Un'agenzia con cinque workspace cliente di solito vuole spostare un cliente alla volta, e sia la chiamata di elenco sia l'importer di Elido accettano un filtro per workspace.

Dalla documentazione pubblica non sono riuscito a confermare quali campi dei click restituisca ciascun piano, quindi apri un record reale del tuo account prima di promettere a qualcuno le analytics storiche.

Passo 2: decidi cosa si sposta - rebrand.ly o dominio tuo

Il percorso si sposta; l'host si sposta solo se è tuo. Un link come go.acme.com/summer può continuare a funzionare invariato dopo il cutover. rebrand.ly/summer no, perché quell'hostname appartiene a Rebrandly e continua a risolversi tramite il loro servizio finché dura il tuo account. Tre casi coprono la maggior parte degli account.

• Un tuo dominio, con DNS sotto il tuo controllo. Il caso migliore. Ricrea ogni slashtag sullo stesso hostname in Elido, poi ripunta il DNS. Codici QR stampati, archivi email e bio continuano a funzionare.
• Un dominio acquistato tramite Rebrandly. L'articolo di assistenza di Rebrandly dice di usare Transfer out e chiedere un codice via email, e segnala che la maggior parte dei domini ha un blocco di 60 giorni dopo la registrazione. Fai partire presto quel conto alla rovescia e considera il cambio di CNAME la prima mossa più sicura.
• Il dominio gratuito rebrand.ly. Gli slashtag passano a un nuovo host, ma i vecchi URL restano a Rebrandly. Se sono stampati, tieni attivo l'account finché quei materiali circolano.

Per un hostname nuovo, vedi domini personalizzati per i link brevi.

Passo 3: mappa campi, tag e workspace di Rebrandly su Elido

L'importer è volutamente stretto. Legge quattro cose per ogni link Rebrandly (slashtag, destinazione, titolo, tag), le scrive in un link Elido sul dominio che hai scelto e aggiunge un tag. Tutto il resto richiede un tuo script o un passaggio manuale.

Le date di creazione meritano un'altra occhiata: l'endpoint bulk (POST /v1/workspaces/{id}/links/bulk, 100 link per richiesta) accetta solo slug, destinazione, titolo e tag, quindi i link importati si ordinano per data di import. L'importer di Dub le conserva, quindi se le date originali contano per i report, tieni il file JSONL. Il modulo della dashboard mostra solo la chiave, il dominio di destinazione e la strategia di conflitto; il filtro per workspace funziona oggi tramite API e un campo nella dashboard è previsto.

Elido ha le cartelle, ma l'importer non le crea. Porta la struttura come tag nel tuo pre-processing (client:acme, campaign:summer), oppure filtra su imported:rebrandly in seguito e usa le modifiche di tag in blocco. I template UTM di Rebrandly non hanno un export pulito, quindi ricostruiscili come regole di campagna e sistema i nomi disordinati con una convenzione di naming per le UTM. I link importati ricevono un codice QR Elido predefinito; i design QR personalizzati vanno riapplicati.

Passo 4: esegui l'importer Rebrandly di Elido

L'importer si trova in Integrations, poi Rebrandly to Elido (anche POST /v1/workspaces/{id}/imports/rebrandly). Aggiungi prima il dominio di destinazione al workspace, così compare nel selettore.

1. Crea una chiave in Rebrandly sotto Account, poi API. Al job basta l'accesso in lettura.
2. Incolla la chiave nel modulo. Elido la tiene nella memoria del processo per la durata dell'esecuzione e poi la scarta; non viene scritta nel record del job.
3. Scegli il dominio di destinazione. Ogni link che la chiave vede finisce su questo unico dominio, senza filtro per dominio, quindi un account con più domini Rebrandly e slashtag sovrapposti andrà in collisione.
4. Scegli una strategia di conflitto, poi avvia il job. La pagina interroga lo stato ogni due secondi e puoi chiuderla.

Rebrandly limita una pagina a 25 link dove Bitly ne restituisce 100, quindi lo stesso account richiede più tempo da Rebrandly e il collo di bottiglia è il fornitore. La nostra stima tecnica per 5.000 link è da 6 a 10 minuti. Il worker segue il cursore last finché una pagina torna vuota, limita un job a 50.000 link e rinuncia dopo 30 minuti. Le righe saltate e fallite finiscono nel log degli errori del job (prime 1.000 voci).

Le strategie di conflitto, tre, si scelgono all'avvio. suffix (predefinita) prova mylink-2, mylink-3 e così via fino a 50 candidati, poi segnala un errore. skip lascia stare il link Elido esistente e registra la riga. fail interrompe il job al primo conflitto. Uno slug con suffisso non viene registrato come problema, eppure è un URL cambiato, quindi per un passaggio di dominio identico usa skip o fail su un dominio di destinazione vuoto e tratta qualsiasi conteggio non nullo di saltati o falliti come lavoro da fare.

Per un controllo più fine, dai il tuo JSONL all'endpoint bulk, che riporta successo o errore per riga; le API e SDK di Elido accettano la stessa coppia slug e destinazione. Vuoi provare prima? Crea un workspace Elido e punta l'importer a un dominio di riserva; la pagina di migrazione da Rebrandly elenca le stesse voci portate e lasciate indietro.

Passo 5: cutover DNS e 301 intatti

L'ordine conta, perché Elido verifica un dominio con due record DNS e il traffico reale cambia solo quando cambia il secondo: un record TXT su _elido-verify.<hostname> con valore verify=<token>, e un CNAME dall'hostname alla destinazione edge di Elido (edge.elido.me per impostazione predefinita). Vedi la pagina della funzione domini personalizzati.

1. Due giorni prima, abbassa a 300 secondi il TTL del CNAME attuale, aggiungi il dominio in Elido e pubblica il record TXT. Il traffico reale non viene toccato.
2. Esegui l'importer su quel dominio e confronta il conteggio importato con wc -l links.jsonl.
3. Nella finestra di cutover, cambia il CNAME verso la destinazione edge di Elido. Elido controlla entrambi i record ed emette il certificato, come spiegato in TLS del dominio personalizzato in cinque minuti.
4. Interroga almeno due resolver pubblici (dig @8.8.8.8 go.acme.com CNAME, poi @1.1.1.1), perché la tua macchina prova solo la tua cache.
5. Lascia stare Rebrandly: non eliminare ancora il dominio né l'account.

Ripunta Zapier, Make o gli script che creano link Rebrandly solo dopo aver confermato l'import.

Sul tuo dominio hostname e percorso sono identici, quindi lo stesso URL ora risponde da Elido. Quello che proteggi è il tipo di redirect: se i tuoi link Rebrandly erano permanenti, tienili permanenti, perché trasformare in temporaneo un link di lunga durata cambia il modo in cui motori di ricerca e cache lo trattano (redirect 301 vs 302). Quando cambia l'host stesso, un 301 dal vecchio al nuovo porta gli utenti dall'altra parte e la RFC 9110 sezione 15.4.2 dice ai client che possono aggiornare i riferimenti memorizzati, ma serve il vecchio hostname, che su rebrand.ly non controlli.

Passo 6: verifica la migrazione

Non annunciare lo spostamento sulla base di una schermata verde del job. Controlla che importati più saltati più falliti sia uguale al numero di righe del tuo JSONL (meno i domini che hai lasciato), che saltati e falliti siano zero o che ogni voce del log sia spiegata, e che nessuno slug sia finito con un suffisso -2 che Rebrandly non aveva. Filtra Links per imported:rebrandly e scorri. Poi confronta l'header Location dei tuoi primi 100 link con la destinazione nel JSONL:

while read -r slug dest; do
  got=$(curl -s -o /dev/null -w "%{redirect_url}" "https://go.acme.com/$slug")
  [ "$got" = "$dest" ] || echo "MISMATCH $slug -> $got (expected $dest)"
done < top100.tsv

Controlla a mano gli slashtag con maiuscole miste e caratteri speciali, perché non ho testato ogni slug limite. Scansiona con un telefono, su rete mobile, un codice QR stampato. Migrare da Bitly senza rompere i link ha un elenco di modalità di guasto più severo, e la guida alla migrazione da TinyURL mostra lo schema per un'altra origine.

Passo 7: rollback, analytics e quando non passare

Il tuo vero rollback è la vecchia configurazione, ancora attiva. Finché Rebrandly tiene dominio e link, tornare indietro è un cambio di CNAME di una riga verso la destinazione precedente, e con un TTL di 300 secondi la maggior parte dei visitatori si adegua in pochi minuti. Dentro Elido, il tag imported:rebrandly è la maniglia per annullare: filtra il lotto e ritaggalo, spostalo o eliminalo, poi reimporta. Rilanciare è sicuro con skip; con suffix crea copie -2, quindi preferisci skip per un secondo passaggio.

Il worker gira dentro l'applicazione Elido, quindi un deploy o un crash a metà importazione lo interrompe. Un controllo ogni cinque minuti porta a failed, con un motivo, ogni job senza progressi da 30 minuti. Oggi non c'è un cursore salvato. Riavvii il job. La ripresa dall'ultimo cursore di Rebrandly è in programma e conterà di più oltre circa 10.000 link.

Lo storico dei click resta in Rebrandly, quindi esporta i report che ti servono prima di fare il downgrade e annota l'ora del cutover. I nuovi click arrivano in Elido dal momento in cui il CNAME risolve verso di lui, con una breve sovrapposizione in cui entrambe le dashboard contano, perché i resolver scartano i record in cache a velocità diverse. Se un link molto visitato non mostra nulla dopo un'ora, esegui il ciclo curl prima di sospettare della dashboard. Per mantenere continue le serie di campagna, vedi tracciare le UTM end to end. Dopo 30 giorni tranquilli, fai il downgrade o chiudi Rebrandly.

L'importatore non ricostruisce le regole di routing per dispositivo o area geografica, i modelli UTM o lo stile dei QR. Non porta con sé nemmeno l'appartenenza ai team. Anche l'importatore Rebrandly di Dub salta il targeting per dispositivo e area geografica, quindi è tipico e non una peculiarità di Elido. Se la tua configurazione si appoggia a regole di routing o al branding dei QR, per un mese usa i due prodotti in parallelo. La pagina di confronto con Rebrandly e le alternative a Rebrandly mettono a confronto prezzi e funzioni.

Correlati sul blog

• Elido vs Rebrandly: prezzi, residenza UE e link personalizzati nel 2026
• Alternative a Rebrandly: 9 strumenti di link personalizzati in classifica
• Bitly vs Rebrandly: link personalizzati, prezzi e adattamento
• Guida alla migrazione da Bitly: dall'inventario al monitoraggio a 30 giorni
• Configura link brevi personalizzati: scegli un dominio e vai online in un pomeriggio