Hai diverse basi di conoscenza e vuoi riunirne almeno alcune. Ma quali contenuti dovresti spostare? Cosa dovrebbe rimanere dov'è? E che fine fanno gli articoli duplicati, le traduzioni, gli allegati o le pagine che sono già ben posizionate su Google?
In questa guida, esamineremo innanzitutto il consolidamento della knowledge base (inclusi i casi in cui è più opportuno mantenere alcuni contenuti separati) e poi passeremo alla migrazione vera e propria della knowledge base: cosa è possibile spostare, come prepararsi e come evitare che contenuti e traffico di ricerca vadano persi durante il processo.
Che cos'è il consolidamento della base di conoscenza?
Questi elementi non sempre hanno equivalenti diretti nel nuovo sistema: una knowledge base potrebbe utilizzare categorie laddove un'altra utilizza cartelle, oppure archiviare traduzioni e campi degli articoli in modo diverso. Pertanto, potresti ritrovarti a organizzare i contenuti in modo diverso una volta che saranno tutti in un unico posto.
Consolidamento o integrazione: di cosa hai bisogno?
Si opta per l'integrazione quando si desidera mantenere separate le basi di conoscenza, ma al contempo semplificare la ricerca dei contenuti. Detto questo, è consigliabile valutare il consolidamento se si vuole evitare di dover gestire le stesse informazioni in posizioni diverse.
Supponiamo che i vostri sviluppatori gestiscano la documentazione tecnica in Confluence e il team di supporto pubblichi le guide per i clienti in Zendesk. Tutti sono contenti di continuare a usare questi sistemi, ma i dipendenti desiderano poter effettuare ricerche da entrambi i sistemi da un'unica piattaforma. In questo caso, la ricerca federata potrebbe essere sufficiente. Happeo, ad esempio, può mostrare i risultati provenienti da sistemi connessi come Confluence e Zendesk nella stessa interfaccia di ricerca.
Tuttavia, la ricerca federata non sarà d'aiuto se il problema risiede nel contenuto stesso. Se le due basi di conoscenza si sovrappongono, sarà comunque necessario gestire due versioni delle stesse informazioni. Il consolidamento delle basi di conoscenza consente di unificare il contenuto delle basi di conoscenza e di mantenerne un'unica versione.
Ma non è necessario consolidare tutto. I contenuti di supporto possono essere inseriti in un'unica knowledge base, mentre gli sviluppatori mantengono la documentazione in Confluence, dove già la gestiscono.
Quando mantenere separate le basi di conoscenza ha più senso
Mantieni separate le tue basi di conoscenza se ciascuna ha ancora una chiara ragione di esistere. Ad esempio:
- I tuoi lettori necessitano di informazioni diverse. I clienti potrebbero volere istruzioni su come modificare le impostazioni dell'account, mentre gli addetti all'assistenza clienti potrebbero aver bisogno della procedura di escalation in caso di modifica non riuscita.
- Alcuni contenuti richiedono un accesso più limitato. La distinzione tra knowledge base interna ed esterna può essere valida se si limitano le istruzioni interne ma si rendono gli articoli pubblici accessibili a tutti.
- La proprietà dei contenuti è già chiara. Gli sviluppatori possono mantenere la documentazione tecnica dove la aggiornano abitualmente, mentre il team di supporto si occupa degli articoli rivolti ai clienti.
Ora osserviamo cosa succede dopo una modifica al prodotto. Due persone devono aggiornare due articoli che rispondono alla stessa domanda? Devono ricordarsi quale versione appartiene a quale sistema? I lettori a volte trovano entrambe le versioni?
In tal caso, stai gestendo le stesse informazioni due volte. Riunendo questi articoli, avrai un'unica versione da aggiornare, lasciando invariato il resto delle tue basi di conoscenza.
Perché i team finiscono per consolidare le basi di conoscenza
Le aziende desiderano avere cinque punti di riferimento per la documentazione. Una knowledge base potrebbe essere creata in seguito a un'acquisizione. Il supporto potrebbe iniziare a utilizzare una nuova piattaforma, mentre gli articoli utili potrebbero rimanere su quella vecchia. Il prodotto e il supporto potrebbero creare documentazione separata e in seguito scoprire che parte di essa tratta argomenti simili.
Prima di unire le basi di conoscenza, quindi, cerca di capire come sei arrivato a crearle. La risposta ti aiuterà a decidere cosa unire e cosa ha senso mantenere separato.
Fusioni e acquisizioni
Un'acquisizione può comportare la presenza di anni di contenuti ancora necessari. Quando Oneflare ha acquisito UrbanYou, quest'ultima possedeva oltre 200.000 ticket, oltre alla sua knowledge base e ad altri dati dei clienti. Oneflare desiderava conservare questo storico, quindi Help Desk Migration lo ha trasferito al nuovo Zendesk account
Prima di unire i contenuti del centro assistenza delle due aziende, esaminate attentamente gli articoli. Potreste trovarne uno che genera ancora traffico ma utilizza il vecchio marchio, oppure uno che tratta lo stesso argomento del vostro ma contiene alcuni dettagli mancanti. Decidete come procedere in ciascuno di questi casi prima di unire più basi di conoscenza, finché avete ancora a front le versioni originali.
Proliferazione di strumenti e documentazione duplicata
La proliferazione delle basi di conoscenza diventa un buon motivo per consolidare gli strumenti di documentazione, poiché le persone devono riflettere sulla collocazione di un articolo prima di poterci lavorare.
Supponiamo di voler consolidare la documentazione tra i vari team. Il supporto ha il suo centro assistenza, il team di prodotto gestisce la propria documentazione e gli articoli più vecchi sono ancora archiviati in un sistema che nessuno ha ancora dismesso completamente. Un nuovo articolo potrebbe ragionevolmente essere inserito in più di un sistema, quindi la sua posizione dipende spesso da chi lo pubblica. Col tempo, i contenuti correlati finiscono per essere sparsi in questi sistemi, anche se nessuno crea intenzionalmente duplicati.
Costo di una base di conoscenze frammentata
In un sondaggio APQC del 2021 condotto su 982 lavoratori della conoscenza, gli intervistati hanno dichiarato di aver trascorso in media 2,8 ore a settimana alla ricerca o alla richiesta delle informazioni di cui avevano bisogno. I dipendenti hanno anche riferito di aver perso tempo a ricreare informazioni già esistenti e a trovare persone in grado di rispondere alle loro domande.
Una documentazione frammentata può generare lo stesso tipo di lavoro. Un articolo in una knowledge base potrebbe rispondere alla domanda, ma qualcuno dovrà comunque verificare se un altro sistema dispone di una versione più recente. Questo è un passaggio aggiuntivo che il consolidamento della gestione della conoscenza può eliminare quando i contenuti sovrapposti vengono riuniti.
Cosa puoi consolidare
Ciò che è possibile trasferire dipende dalle due piattaforme coinvolte. Un record o un campo presente nell'origine potrebbe non avere un equivalente nella destinazione, quindi la migrazione deve essere compatibile con i sistemi supportati da entrambi.
Articoli, categorie e media
È fondamentale mantenere un collegamento tra l'articolo e tutto ciò di cui un lettore ha bisogno per utilizzarlo. Ad esempio, una guida all'installazione perde parte del suo valore se le schermate scompaiono, e un articolo sulla risoluzione dei problemi potrebbe risultare incompleto senza il PDF allegato.
Le categorie richiedono un'attenzione particolare, poiché le due piattaforme potrebbero organizzare gli articoli in modo diverso. È possibile mappare una categoria di origine a una categoria o cartella diversa nella destinazione, anziché copiare esattamente la vecchia struttura. Help Desk Migration supporta questo tipo di mappatura, insieme a immagini e allegati incorporati, per le coppie di piattaforme supportate.
Traduzioni e contenuti multilingue
Controlla le traduzioni separatamente. Alcune piattaforme consentono di migrarle insieme agli articoli originali; altre lasciano solo il contenuto nella lingua predefinita.
Anche quando entrambe le piattaforme supportano le traduzioni, il modo in cui vengono memorizzate nella sorgente è importante. Help Desk Migration, ad esempio, può migrare le versioni linguistiche che condividono lo stesso ID articolo. Se gli ID non corrispondono, viene importata solo la versione predefinita.
Autori, metadati e campi personalizzati
Prima di ricreare i metadati e le impostazioni di accesso, decidi quali utilizzi ancora. Il tuo team potrebbe fare affidamento sull'autore, sullo stato, sui tag, sui campi personalizzati o sulle impostazioni di visibilità di un articolo per gestire chi può visualizzare o pubblicare il contenuto.
Esamina i campi che desideri conservare e verifica dove possono essere inserite le relative informazioni nel nuovo sistema. Alcuni avranno una corrispondenza ovvia, mentre altri potrebbero richiedere un campo personalizzato o un lavoro più approfondito per essere mappati correttamente.
Come pianificare un progetto di consolidamento della base di conoscenza
Innanzitutto, verifica ogni base di conoscenza esistente
Crea un inventario completo di tutte le basi di conoscenza che intendi consolidare. Registra per ogni articolo l'URL, lo stato, la lingua, la categoria, l'ultimo aggiornamento, il proprietario, i reindirizzamenti e gli allegati, e aggiungi i dati sul traffico o sull'utilizzo (se disponibili).
Includi anche i collegamenti relativi a ciascun articolo. Registra le traduzioni, i link interni e qualsiasi file o immagine di cui i lettori abbiano bisogno per seguire le istruzioni. Questi dettagli ti serviranno in seguito per verificare il funzionamento dei contenuti nella nuova knowledge base.
Scelta della piattaforma di destinazione
Il tuo inventario ti fornisce un elenco di elementi da verificare per ogni piattaforma che stai prendendo in considerazione. Analizza i contenuti e la struttura che già utilizzi: la piattaforma è in grado di gestire le tue categorie, traduzioni, autorizzazioni e i campi che desideri conservare? Presta particolare attenzione a tutto ciò che sai già essere difficile da sostituire.
Eliminazione dei duplicati e standardizzazione dei contenuti prima dell'unione
Quando si consolidano gli articoli della knowledge base, è necessario decidere cosa fare con quelli sovrapposti. Una versione potrebbe già contenere tutto ciò che vale la pena conservare, ma non bisogna dare per scontato che la più recente sia la più accurata. A volte, l'articolo finale avrà bisogno di informazioni provenienti da diverse versioni.
Alcuni percorsi di migrazione consentono di mantenere i contenuti indesiderati anziché spostare l'intera knowledge base. Help Desk Migration, ad esempio, supporta il filtraggio degli articoli per categoria, sezione o intervallo di date per FreshdeskdaZendesk le migrazioni.
Questo è anche un buon momento per fare chiarezza sulla terminologia e sulle categorie, finché si sa ancora da dove proviene ciascun articolo. Concordate i nomi da utilizzare nella knowledge base consolidata e applicateli ai contenuti che avete scelto di migrare.
Procedura dettagliata: Migrazione dei contenuti della knowledge base tra diverse piattaforme
Prima della migrazione
Iniziate con gli articoli che hanno maggiori probabilità di causare problemi: quelli con categorie annidate, formattazione insolita, immagini incorporate, allegati o campi che non hanno una corrispondenza chiara nella destinazione. Quindi confrontate le versioni migrate con gli originali per vedere cosa è stato trasferito correttamente e cosa no.
Help Desk Migration ti permette di farlo con una migrazione demo. Puoi utilizzare un campione casuale o scegliere fino a 20 articoli, il che è utile se sai già quali potrebbero essere più problematici.
Durante la migrazione
Si prevedono alcuni problemi di migrazione:
- Immagini o allegati mancanti
- Modifiche o interruzioni di formattazione
- Le categorie o le sezioni finiscono nel posto sbagliato
- I valori dei campi personalizzati sono mancanti o mappati in modo errato
- Le autorizzazioni o le impostazioni di visibilità cambiano
- Gli articoli pubblicati o modificati durante la migrazione non sono presenti nella destinazione
I report di migrazione mostreranno i record non riusciti e quelli ignorati, ma per il resto dovrai controllare il contenuto migrato.
Altri aspetti sono più difficili da prevedere perché il trasferimento stesso potrebbe apparire un successo:
- I campi si comportano in modo diverso. La destinazione accetta il valore ma lo interpreta in modo differente.
- Modifiche HTML. Tabelle, ancoraggi, elementi incorporati o formattazione del codice potrebbero non funzionare correttamente anche se l'articolo inizialmente sembra a posto.
- I limiti delle API rallentano la migrazione. Un piccolo test potrebbe rimanere entro i limiti, mentre la migrazione completa viene rallentata.
- Le automazioni reagiscono ai record importati. Notifiche, flussi di lavoro, webhook o altri processi possono essere eseguiti quando la destinazione riceve il contenuto migrato.
- I risultati della ricerca cambiano. Il sito di destinazione potrebbe indicizzare lo stesso contenuto in modo diverso, rendendo alcuni articoli più difficili da trovare.
È possibile prepararsi ad alcuni di questi problemi verificando i limiti dell'API di destinazione e osservando cosa succede quando i record importati attivano le relative automazioni. La formattazione e la ricerca sono più difficili da prevedere, quindi è consigliabile testarle entrambe con i contenuti migrati prima di procedere con la migrazione completa.
Dopo la migrazione
Una volta completata la migrazione, confronta l'origine e la destinazione per verificare se manca qualcosa oltre ai record già contrassegnati come non riusciti o ignorati. Se utilizzi la migrazione per unificare la documentazione di supporto proveniente da diverse fonti, dovrai anche importare i contenuti aggiunti o aggiornati durante l'esecuzione di tali migrazioni.
Nella Help Desk Migration, la funzionalità di migrazione differenziale (Delta Migration) facilita le modifiche successive per i record supportati, evitando di dover ripetere l'intera migrazione. Prima di utilizzare la migrazione differenziale per i contenuti della knowledge base, verifica quali elementi sono supportati dalla migrazione differenziale per l'origine e la destinazione.
Infine, mantieni disponibile la vecchia knowledge base per un certo periodo di tempo dopo il passaggio. Quando un vecchio link non funziona più o qualcuno segnala la mancanza di contenuti, avrai bisogno della fonte per vedere cosa c'era prima e risolvere rapidamente il problema.
Il consolidamento danneggerà il tuo posizionamento SEO?
Potresti notare delle fluttuazioni nel posizionamento dei tuoi articoli se la consolidazione dei contenuti comporta la creazione di nuovi URL. Google deve individuare e indicizzare i nuovi URL, e alcune oscillazioni nel posizionamento sono normali durante la fase di nuova scansione e reindicizzazione delle pagine spostate. Tuttavia, ciò che fai con i vecchi URL è ancora più importante.
Conservazione di URL e reindirizzamenti tra fonti unite
Quando diversi articoli vengono uniti in uno solo, è possibile che alcuni URL obsoleti rimandino allo stesso nuovo articolo. Ad esempio, se si uniscono tre articoli simili provenienti da basi di conoscenza separate, ciascuno di essi dovrà comunque reindirizzare alla versione consolidata, anche se alcuni provengono da piattaforme o domini diversi.
Google raccomanda reindirizzamenti permanenti lato server come il 301 o il 308 e afferma che non causano una perdita di PageRank. Ogni vecchio URL dovrebbe puntare direttamente alla sua nuova destinazione, senza passare prima attraverso un ulteriore reindirizzamento.
Hai un maggiore controllo sui link all'interno della tua knowledge base. Reindirizzali direttamente ai nuovi URL e lascia che i reindirizzamenti gestiscano i backlink, i segnalibri e i link su siti che non controlli. Lo stesso vale per i tag canonical, le annotazioni hreflang e le sitemap: se contengono un URL obsoleto, sostituiscilo con quello nuovo.
Una volta che la nuova knowledge base sarà attiva, vale la pena monitorare Search Console per individuare i vecchi URL che Google continua a scansionare, le nuove pagine non ancora indicizzate e gli errori di scansione o indicizzazione. Google afferma che la maggior parte delle pagine di un sito di piccole o medie dimensioni impiega alcune settimane per essere indicizzata, e ancora di più per i siti più grandi, quindi è consigliabile mantenere i reindirizzamenti per almeno un anno, in modo da dare a Google il tempo di scansionare nuovamente gli URL e trasferire i segnali a quelli nuovi.
Rischi legati al consolidamento della base di conoscenze e come evitarli
Nel corso del processo di consolidamento abbiamo già riscontrato perdite di dati, link non funzionanti e articoli duplicati o contraddittori. Ora analizziamo più da vicino cosa può andare storto e cosa si può fare al riguardo.
perdita e danneggiamento dei dati
Una certa perdita di dati deriva dai limiti della piattaforma stessa. Una piattaforma può limitare le dimensioni degli articoli, gli allegati, la profondità delle categorie o altre parti della knowledge base, mentre alcuni campi potrebbero non essere affatto disponibili.
Prima di procedere con la migrazione completa, verifica i limiti e le note di migrazione specifici per la tua piattaforma di origine e di destinazione. Possono essere sorprendentemente specifici: con alcune coppie di piattaforme, le date degli articoli potrebbero cambiare in base alla data di migrazione, mentre tag, allegati o altri dati potrebbero richiedere una migrazione personalizzata per essere trasferiti.
legami incrociati rotti
I collegamenti tra gli articoli possono interrompersi quando la destinazione assegna loro nuovi ID. Alcuni strumenti di migrazione possono aggiornare automaticamente questi collegamenti. Help Desk Migration, ad esempio, lo fa per i collegamenti interni e i riferimenti incrociati durante le migrazioni supportate.
Una volta completata la migrazione, esegui comunque una scansione della nuova knowledge base per individuare eventuali link non funzionanti. Controlla separatamente gli articoli tradotti e i link all'interno del codice HTML degli articoli, poiché questi possono essere più facili da trascurare.
Articoli duplicati o in conflitto
Anche se hai ripulito i contenuti prima della migrazione, potrebbero comunque comparire dei duplicati. Due articoli che intendevi unire potrebbero arrivare come articoli separati, oppure un elemento migrato potrebbe sovrapporsi a contenuti già presenti nella destinazione.
Cerca nella nuova knowledge base gli argomenti che hai consolidato e confronta i risultati. A questo punto, stai verificando la presenza di duplicati emersi durante la migrazione, dato che hai già gestito quelli trovati nella fonte.
Lista di controllo per il consolidamento
Non è necessario controllare tutto manualmente. Alcune decisioni richiedono una persona che conosca il contenuto, mentre esportazioni, report di migrazione e crawler possono occuparsi di gran parte delle verifiche.
| Cosa controllare | Come verificarlo | Chi dovrebbe occuparsene? |
|---|---|---|
| È stato migrato tutto? | Confronta i conteggi di origine e di destinazione, quindi esamina i record non riusciti e quelli ignorati nel report di migrazione. | Titolare della migrazione |
| Gli articoli sono arrivati integri? | Confronta un esempio con gli originali, soprattutto articoli con immagini, file, traduzioni e campi personalizzati. | team dei contenuti |
| Ci sono ancora duplicati? | Cerca gli stessi argomenti e confronta i risultati simili affiancandoli. | Proprietari dei contenuti |
| I link interni funzionano? | Esplora la nuova knowledge base per trovare gli errori 404 e i link che utilizzano ancora URL obsoleti. | Team SEO/tecnico |
| I vecchi URL conducono alle pagine corrette? | Esamina il tuo vecchio elenco di URL e verifica la destinazione finale di ogni reindirizzamento. | Team SEO/tecnico |
| I dati SEO sono sopravvissuti? | Titoli, meta descrizioni, tag canonici, hreflang e URL della sitemap. | team SEO |
| È cambiato qualcosa durante la migrazione? | Confronta le date di creazione e di aggiornamento successive alla tua data limite oppure utilizza la migrazione differenziale, se disponibile. | Titolare della migrazione |
| Google sta indicizzando le nuove pagine? | Controlla Search Console per problemi di indicizzazione e URL obsoleti che Google sta ancora eseguendo. | team SEO |
| È possibile dismettere in sicurezza le vecchie basi di conoscenza? | Eseguite questa operazione solo dopo aver completato i controlli di cui sopra e aver corretto eventuali contenuti mancanti o errati. | Titolare della migrazione |
Conclusione
Un buon consolidamento della knowledge base non deve necessariamente concludersi con la raccolta di tutto in un unico sistema. Alcuni contenuti possono essere lasciati dove si trovano; il resto necessita di una destinazione chiara e di un piano per la gestione della sua struttura, dei collegamenti e degli altri dati durante il trasferimento.
Una volta prese queste decisioni, Help Desk Migration può gestire il trasferimento tra le piattaforme supportate. È possibile utilizzare una migrazione demo per verificare l'aspetto dei contenuti prima di procedere con la migrazione completa.
FAQ
La migrazione del contenuto di una knowledge base tra piattaforme avviene collegando o esportando l'origine, mappando i relativi record e campi alla destinazione, eseguendo una migrazione di prova e infine trasferendo l'intera knowledge base. Prima di eliminare definitivamente l'origine, è importante verificare il contenuto migrato, in particolare gli articoli con allegati, traduzioni, campi personalizzati o formattazione complessa.
In genere è possibile migrare articoli della knowledge base, categorie, allegati, immagini incorporate, traduzioni, autori e metadati. I record e i campi esatti che è possibile trasferire dipendono da ciò che è supportato sia dalla piattaforma di origine che da quella di destinazione.
È consigliabile mantenere separate le basi di conoscenza quando si rivolgono a pubblici diversi, richiedono livelli di accesso differenti o hanno proprietari ben definiti che le gestiscono in modo indipendente. Il consolidamento è più indicato quando è necessario gestire contenuti identici o sovrapposti in più sedi.
Il consolidamento della knowledge base può causare variazioni temporanee nel posizionamento se gli articoli vengono spostati su nuovi URL, ma la modifica degli URL non implica automaticamente una perdita di posizionamento. È necessario mappare i vecchi URL alle nuove destinazioni, utilizzare reindirizzamenti permanenti, aggiornare i link interni e monitorare l'indicizzazione dopo la migrazione.
Non esiste una tempistica fissa per il consolidamento della knowledge base, poiché dipende dalla quantità e dalla complessità dei contenuti, dalle piattaforme coinvolte e dal livello di pulizia o deduplicazione necessario. Una migrazione di prova può aiutare a identificare eventuali problemi, ma il progetto completo richiede tempo anche per la revisione dei contenuti, la mappatura degli URL, i test e i controlli post-migrazione.
Scegli una destinazione che supporti i contenuti, la struttura, le autorizzazioni, le lingue, i metadati e i flussi di lavoro che devi conservare. Prima di adottare definitivamente la piattaforma, testa alcuni articoli rappresentativi per verificare come verrà trasferita la tua base di conoscenze esistente.