Bitly-migratieplaybook: van inventaris tot 30 dagen monitoring

Een Bitly-migratie is een klein project met vijf fasen: inventariseren wat je hebt, de velden mappen, importeren, DNS omzetten en daarna 30 dagen opletten. De import duurt minuten. De kalendertijd gaat op aan DNS-caching en aan de soak-periode voordat je iets opzegt. Volgens mij is die soak-periode de stap die teams het vaakst overslaan, en waar ze spijt van krijgen. Deze playbook geeft je de volgorde, de eigenaren, een tijdlijn, een verificatiechecklist en een rollbackplan.

Weinig tijd? Spring naar de tijdlijn. Wil je de redirectmechanica, dus slug-hoofdletters, 301-ketens en het opnieuw aansluiten van webhooks, de details die bepalen of een cutover onzichtbaar blijft voor je bezoekers, lees dan de playbook over faalscenario's. Wil je weten hoe de importer is gebouwd, lees dan hoe we de Bitly-importer hebben opgeleverd. Dit bericht is het projectplan dat boven beide staat.

De Bitly-migratietijdlijn in één oogopslag

De lijst hieronder is het hele project op één scherm. Dagnummers zijn relatief ten opzichte van de cutoverdag (D0), en de 24 uur wachten op de TTL is de enige stap die je niet kunt versnellen.

• D-14 tot D-10, inventaris en export. Resultaat: JSONL met links, plus de lijst met groepen, domeinen, QR-codes en bio-pagina's. Eigenaar: marketing ops.
• D-10 tot D-7, veldmapping en opschoning. Resultaat: afgesproken regels voor slugs, bestemmingen, tags en conflicten. Eigenaar: marketing ops met SEO.
• D-7 tot D-3, oefenimport. Resultaat: een testset die is geïmporteerd en op klikken is gecontroleerd. Eigenaar: een engineer.
• D-2, TTL verlaagd naar 300 seconden. Resultaat: resolvers cachen het oude doel niet meer lang. Eigenaar: wie DNS beheert.
• D0, productie-import en DNS-cutover. Resultaat: de hostnaam wijst naar Elido en het domein is geverifieerd. Eigenaar: engineer en DNS-beheerder.
• D0 tot D+1, verificatie. Resultaat: de checklist hieronder, afgetekend door iemand anders dan de engineer.
• D+1 tot D+30, monitoring. Resultaat: een dagelijkse controle op 404's en klikvolume, daarna een wekelijkse review.
• D+30 tot D+90, soak en uitfaseren. Resultaat: het Bitly-account is gedowngraded of opgezegd.

Fase 1: inventariseer wat je echt hebt

Begin met een lijst van alles wat kan breken. Niet alleen de links. Vier objecttypen tellen mee, en Bitly behandelt elk anders.

1. Korte links. Slug, bestemming, titel, tags en de groep waarin ze zitten. Groepen zijn geen werkruimten. Eén account kan er meerdere bezitten, elk met eigen domeininstellingen, en een groep die je vergeet te exporteren is een domein dat je vergeet te migreren.
2. Eigen domeinen. Elke hostnaam die Bitly-links serveert, ook oude waar niemand zich meer iets van herinnert. Controleer de DNS-zones, niet alleen de instellingenpagina van Bitly.
3. QR-codes. Bitly genereert QR-codes die naar een korte link wijzen. Een code die op een verpakking is gedrukt, blijft werken zolang de korte link erachter werkt. Maak een lijst van de gedrukte codes, want die zijn het moeilijkst te wijzigen.
4. Bio-pagina's. De link-in-bio-pagina's van Bitly staan op eigen URL's en maken geen deel uit van de linkexport.

Exporteer links via de Bitly API met een Generic Access Token, één groep tegelijk, 100 links per pagina. De export in het dashboard hangt af van je abonnement en dekt alleen wat je op het scherm ziet. Noteer er meteen bij de klikteller over de hele levensduur van elke link. Het is de enige klikgeschiedenis die Bitly je geeft, en je hebt hem vóór de cutover nodig, niet erna. Bitly publiceert geen export van klikgebeurtenissen per klik, dus er is niets om ruwe klikken te importeren. De Short.io-gids over het exporteren van Bitly-links maakt dit punt ook, op zijn eigen manier.

Snoei daarna de lijst. Gearchiveerde links, eenmalige shares en campagnes die twee jaar geleden eindigden hoeven niet mee. Beslis dat nu. Het is veel goedkoper dan later 5.000 dode redirects debuggen.

Fase 2: map de velden vóór je importeert

Bepaal vóór je iets draait hoe elk Bitly-veld in Elido terechtkomt. De Bitly-importer van Elido neemt vier dingen per link mee, de rest bouw je opnieuw op.

De conflictregel doet ertoe wanneer het doeldomein al links bevat. In een verse werkruimte is dat zelden zo. Suffix (de standaard) maakt van een botsing op promo een promo-2, wat stilletjes een publieke URL verandert. Skip laat de bestaande Elido-link ongemoeid en logt de Bitly-rij. Fail stopt de hele job bij de eerste botsing. Moet bij een migratie de gedrukte slug exact blijven, kies dan skip of fail en los elke botsing met de hand op.

Fase 3: importeren

Elido heeft drie manieren om links binnen te halen, en welke je gebruikt hangt af van de omvang en de bron.

• Bitly-importer. Open in het dashboard onder Integrations de Bitly-migratie, plak een Generic Access Token, kies de Bitly-groep, kies een doeldomein en een conflictregel, en start. Hij draait op de achtergrond, haalt Bitly 100 links per keer op en is begrensd op 50.000 links per job met een runbudget van 30 minuten. Het token wordt voor de run gebruikt en niet opgeslagen. Grotere accounts splitsen op groep of vragen support.
• Dashboard bulk en CSV. Het dialoogvenster Nieuwe link heeft een tabblad Bulk (één URL per regel, optioneel slug en titel, tot 100 per batch) en een tabblad CSV (kolommen url, slug, title). Gebruik het voor met de hand bewerkte lijsten, bijvoorbeeld als je de export in een spreadsheet hebt gefilterd. Deze gids behandelt de spreadsheetroute.
• API. POST /v1/workspaces/{workspace_id}/links/bulk accepteert tot 100 links per aanroep en meldt succes of falen per item, zodat één foute rij de batch niet stopt.

Elido levert ook importers voor Rebrandly, Short.io, TinyURL en Dub, gebouwd op hetzelfde jobsysteem. Handig als je uit meer dan één tool tegelijk consolideert, want elke bron krijgt een eigen job, eigen aantallen en een eigen foutenlijst.

De linklijst na een import, met tags om op te filteren. Dit is een DEMO-werkruimte met synthetische voorbeelddata, geen klantresultaten.

Doe eerst de oefenrun. Importeer een kleine groep, of de hele inventaris naar een staging-subdomein of een gedeeld Elido-domein. Klik 20 links door over je meest waardevolle bestemmingen. Controleer dan de job: de importer meldt aantallen geïmporteerd, overgeslagen en mislukt, en de status partial betekent dat sommige rijen zijn mislukt en dat de foutenlijst aangeeft welke.

Fase 4: DNS en cutover van het eigen domein

Alleen links op je eigen domein hebben deze fase nodig. Als je het domein in Elido registreert, krijg je twee records: een TXT-record op _elido-verify.<hostname> en een CNAME van de hostnaam naar edge.elido.me. Het domein wordt geverifieerd wanneer beide resolven, wat betekent dat de verificatie bij de cutover klaar is, niet eerder. Plan de oefenrun daarop. De gids voor het instellen van een eigen domein loopt het formulier door, en de gids over branded links behandelt het kiezen van een hostnaam.

1. D-2: verlaag de TTL op de bestaande CNAME naar 300 seconden. Was die 86400, dan kan de oude waarde een dag in resolvercaches blijven zitten, dus dit is een wachttijd van 24 uur. Schrijf het huidige Bitly-CNAME-doel op. Dat is je rollbackwaarde.
2. D0, wijzigingsvenster: draai de productie-import voor het domein, vervang dan het CNAME-doel door edge.elido.me en voeg het TXT-record toe.
3. D0, na propagatie: controleer of het domein als geverifieerd wordt getoond en vraag een link op via HTTPS. Certificaten worden bij het eerste verzoek uitgegeven, dus verwacht dat dat ene verzoek trager is dan de rest. Zie de functiepagina over eigen domeinen voor wat automatisch gaat.

Controleer vanaf meer dan één netwerk. Je laptop is één resolver, en de TTL-referentie van Cloudflare legt uit waarom andere caches achterlopen. Staat het domein achter een proxy of CDN, test die instelling dan tijdens de oefenrun, niet op de dag zelf.

Fase 5: verifieer met een checklist en houd 30 dagen in de gaten

Verificatie is een korte lijst. Iemand anders dan de engineer tekent hem af.

• Het aantal links in Elido komt overeen met de gefilterde inventaris (geïmporteerd plus overgeslagen plus mislukt is gelijk aan de export)
• Elke mislukte rij is met de hand gerepareerd of bewust weggelaten
• 50 steekproeflinks sturen door naar de juiste bestemming met intacte UTM's
• De top 20 links op klikken over de levensduur doorstaan allemaal een handmatige klik-test
• Een gedrukte QR-code scant en landt op de juiste pagina
• Redirectresponses zijn één hop, geen keten (zie redirectketens en SEO)
• Het domein wordt als geverifieerd getoond en serveert geldige HTTPS
• De Bitly-tellers over de levensduur zijn bewaard met een datum

Monitor daarna. De eerste week bevat de verrassingen. De meeste zijn links die niemand had opgeschreven.

• Dagelijks in week 1: zoek naar 404's op je korte domein en naar een dip in het totale aantal klikken vergeleken met dezelfde weekdagen vóór de cutover.
• Daarna wekelijks: vergelijk het klikvolume per campagne met de baseline van vóór de migratie plus je bewaarde Bitly-tellers.
• Dag 30: bekijk de tag imported:bitly. Links zonder klikken in 30 dagen komen in aanmerking voor archivering.

Het analytics-overzicht, waar je de 30 dagen lang klikken per dag en klikken per host volgt. DEMO-werkruimte, synthetische data.

Wil je een geautomatiseerde nachtelijke controle van elke redirect, dan heeft het bericht over faalscenario's er een script voor. De functiepagina over analytics toont wat Elido standaard rapporteert.

Start een werkruimte en draai de oefenimport voordat je je aan een cutoverdatum bindt. Een oefenrun kost een middag. Hij laat zien welke slugs botsen.

Rollbackplan

Je kunt terugdraaien tot je Bitly opzegt. Het plan is met opzet saai.

1. Trigger. Spreek de drempel vooraf af, bijvoorbeeld een kliksdaling van meer dan 30% ten opzichte van de baseline gedurende twee dagen die je niet kunt verklaren, of een kapotte link in de top 20.
2. Actie. Zet het oude CNAME-doel terug. Met een TTL van 300 seconden werkt dat voor de meeste resolvers binnen minuten.
3. Data. Links die na de cutover in Elido zijn aangemaakt, staan niet in Bitly. Exporteer ze uit Elido voordat je terugdraait, anders raak je ze kwijt.
4. Besluit. Los de oorzaak op en herhaal vanaf D-2. Pas het plan niet aan onder druk op de dag zelf.

Houd het Bitly-account minstens 90 dagen aan. Gedrukt materiaal met bit.ly-URL's hangt af van Bitly, omdat Bitly eigenaar is van dat domein. Bekijk wat Bitly kost voordat je beslist hoe lang je betaalt voor het vangnet.

Gerelateerd op de blog

• Migreer van Bitly zonder links te breken: een playbook over faalscenario's
• De Bitly-migratie opleveren: één worker, vier limieten
• Een eigen domein met TLS instellen in 5 minuten
• Korte links in bulk importeren vanuit een Google Sheet
• Migreer van Rebrandly: branded domein overdragen zonder slugverlies