La ricerca federata Zendesk consente agli utenti finali di vedere contenuti nei risultati di ricerca del centro assistenza esterni al centro assistenza, come Knowledge base esterne, software di gestione dell’apprendimento, blog e pagine del sito web. Puoi implementare la ricerca federata usando l’API di ricerca federata Zendesk o il crawler di ricerca.
Il crawler di ricerca è disponibile nelle impostazioni di ricerca del centro assistenza e ti consente di implementare la ricerca federata nel centro assistenza senza risorse degli sviluppatori (consulta Configurazione del crawler di ricerca). Puoi usare questo articolo per risolvere i problemi di configurazione del crawler e gli errori di pagina che potresti riscontrare durante la configurazione del crawler di ricerca nella tua applicazione.
Questo articolo include i seguenti argomenti:
Errori di configurazione del crawler
Gli errori di configurazione del crawler vengono generati quando il crawler di ricerca non può essere eseguito correttamente a causa di errori nella verifica della proprietà del dominio o nell'elaborazione della mappa del sito. Gli errori di configurazione del crawler generano una notifica email che viene inviata al proprietario del crawler configurato durante la configurazione del crawler di ricerca.
Impossibile verificare la titolarità del dominio
Il crawler di ricerca tenta di verificare la titolarità del dominio ogni volta che viene eseguito, operazione che può richiedere fino a 24 ore. Sebbene il proprietario del crawler riceva una notifica via email se la verifica del dominio non riesce, puoi provare la verifica immediatamente nella pagina di modifica del crawler di ricerca. Consulta Gestione dei crawler di ricerca.
Per risolvere gli errori di verifica del dominio, verifica quanto segue:
- La home page del sito web (detta anche pagina radice o indice) è attiva ed è disponibile al pubblico. La pagina non deve avere alcun accesso utente, password, limitazioni IP o altri requisiti di autenticazione.
- Hai implementato il tag corretto dal crawler. È privo di errori di battitura ed è implementato nella sezione <head> della home page del sito web di cui vuoi eseguire la scansione. Il tag di verifica del dominio deve essere sempre inserito nella home page del sito, anche se il tuo crawler è configurato per la scansione di un sottoinsieme di pagine. Puoi modificare il crawler per visualizzare le informazioni di verifica del dominio correnti. Consulta Gestione dei crawler di ricerca.
Nota: Puoi avere diversi tag di verifica per diversi crawler sullo stesso dominio.
Esempio
<html>
<head>
<meta name="zd-site-verification" content="crawler-verification-token">
<title>Title</title>
<style>
<!-- style info here -->
</style>
</head>
<body>
<!-- body of the page here -->
</body>
</html>
Impossibile elaborare la mappa del sito
Il crawler di ricerca usa la mappa del sito definita durante la configurazione del crawler ogni volta che viene eseguita. Se la mappa del sito non può essere elaborata, il proprietario del crawler riceve una notifica email e il crawler non verrà eseguito. In tal caso, verifica quanto segue:
- Il crawler di ricerca punta all’URL della mappa del sito corretto e può trovarlo. Puoi modificare il crawler per visualizzare l’URL della mappa del sito corrente. Consulta Gestione dei crawler di ricerca.
- La mappa del sito è disponibile e disponibile al pubblico. La pagina non deve essere limitata da alcun accesso utente, password, limitazioni IP o altra autenticazione.
- La mappa del sito è una mappa del sito URL XML che segue il protocollo XMLdelle mappe dei siti.
Registra errori
Gli errori di record si verificano quando non ci sono errori di configurazione, ma il crawler di ricerca non può estrarre e indicizzare le pagine definite nella mappa del sito del crawler (consulta Configurazione del crawler di ricerca). Quando si verifica un errore di record, viene inviata una notifica email al proprietario del crawler con un link a un file CSV che elenca le pagine interessate e gli errori associati.
Impostazioni locali non rilevate
L’errore “Impostazioni locali non rilevate” indica che il crawler di ricerca non è stato in grado di rilevare le impostazioni locali oppure che le impostazioni locali rilevate non corrispondono a nessuna delle attuali impostazioni locali del centro assistenza.
Per determinare le impostazioni locali di un record, il crawler prova i seguenti metodi. La prima strategia riuscita determina le impostazioni locali dei record.
- Estrai le impostazioni locali dall’attributo lang nel tag <html>
- Estrarre le impostazioni locali dall’intestazione Content-Language
- Estrai le impostazioni locali dal tag <meta>
- Analisi testuale del contenuto (CLD - Compact Language Detection)
L’errore “Impostazioni locali non rilevate” deriva da uno dei seguenti problemi:
- Le impostazioni locali o la lingua identificate non corrispondono alle impostazioni locali o alla lingua configurate in nessun Centro assistenza del tuo account. Per vedere quali lingue sono configurate in ciascun centro assistenza nel tuo account, consulta Configurazione del centro assistenza per il supporto di più lingue. Trova i codici locali per le lingue configurate nel supporto linguistico Zendesk in base al prodotto.
- Il crawler di ricerca non è riuscito a determinare le impostazioni locali o la lingua.
Per risolvere il problema, verifica quanto segue:
- L’attributo lang nel tag html corrisponde alle impostazioni locali del centro assistenza.
- L’intestazione HTTP Content-Language corrisponde alle impostazioni locali del Centro assistenza.
- Il metaelemento con l’attributo Content-Language impostato nell’attributo http-equiv corrisponde alle impostazioni locali del centro assistenza.
Consulta Informazioni sulle impostazioni locali del crawler di ricerca.
Titolo non rilevato
L’errore “Titolo non rilevato” indica che il crawler di ricerca non è stato in grado di rilevare il titolo di un record. Il crawler di ricerca usa gli approcci seguenti per determinare il titolo di un record:
- Estrarre il contenuto del tag <title>
- Estrarre il contenuto del tag <h1>
- Estrarre il contenuto testuale dal tag <body>.
La prima strategia riuscita determina le impostazioni locali dei record. Il crawler indicizza i primi 255 caratteri del contenuto estratto come titolo del record se uno dei primi due approcci ha esito positivo. Se queste strategie non determinano un titolo, il record non viene indicizzato.
Per risolvere il problema, assicurati che la pagina interessata abbia uno dei tag elencati sopra.
Corpo non trovato
L’errore “Corpo non trovato” indica che il crawler di ricerca non è stato in grado di rilevare il corpo di una pagina. Per risolvere l’errore, assicurati che la pagina interessata sia contrassegnata correttamente con il tag <body>.
HTTP [codice di stato]
Se il campo del codice di errore nel CSV di un record contiene HTTP e un codice di stato, significa che non è stato possibile indicizzare la pagina perché non è stato possibile accedervi. Se la pagina è stata indicizzata correttamente (HTTP 2xx), non riceverai un errore di codice di stato HTTP.
I codici di errore più comuni sono:
- 404 - Pagina non trovata - La pagina non esiste o è stata spostata a un altro URL. Per risolvere il problema, assicurati che la mappa del sito usata dal crawler sia aggiornata e che tutti gli URL nella mappa del sito rimandino a pagine esistenti.
-
403 - Forbidden - Al crawler è stato impedito l'accesso alla pagina a causa di qualche meccanismo di controllo dell'accesso, come la presenza di limitazioni di accesso o indirizzo IP. Per risolvere il problema, verifica quanto segue:
- Hai aggiunto Zendesk/External-Content, lo user agent del crawler di ricerca, al tuo elenco consentito.
- Le pagine da indicizzare sono accessibili pubblicamente, in quanto il crawler non può eseguire la scansione di pagine con accesso limitato. Se le pagine di cui vuoi eseguire la scansione e l’indicizzazione non possono essere rese accessibili pubblicamente, ti consigliamo di valutarne l’indicizzazione usando l’API di ricerca federata (contenuto esterno). Consulta Configurazione dell’API di ricerca federata Zendesk.
- 5xx - Errore server : non è stato possibile scansionare la pagina a causa di un errore del server. Il sito potrebbe essere temporaneamente non disponibile. Per risolvere il problema, visita una o più pagine con questo errore per assicurarti che il sito sia attivo. Se il sito non è disponibile, contatta l’amministratore del sito. Quando l’errore viene corretto, attendi che il crawler si esegua nuovamente alla cadenza normale (ogni 12-24 ore).
Dominio URL non valido
L’errore “URL dominio non valido” indica che l’URL della pagina elencata nella mappa del sito non è nel dominio configurato durante la configurazione del crawler.
Per risolvere il problema, verifica che il dominio della pagina che ha generato l'errore si trovi nello stesso dominio definito per il crawler di ricerca. Se la pagina collegata nella mappa del sito punta a una pagina che è in hosting su un dominio diverso da quello configurato durante la configurazione del crawler, puoi procedere in uno dei modi seguenti:
Configura un nuovo crawler di ricerca per la pagina interessata
Sposta la pagina dal dominio esterno al dominio configurato per il crawler di ricerca.
Non specificato
L’errore “Indeterminato” può essere causato da uno o più degli elementi seguenti:
-
Superato il limite di record esterni per la tua istanza: il crawler di ricerca ha un limite di 50.000 record esterni. Se hai superato il limite di 50.000 record esterni, gli ultimi record esterni in eccesso non verranno indicizzati o aggiornati. Per visualizzare il numero di record esterni usati dal crawler, consulta le informazioni del crawler di ricerca. Consulta Gestione dei crawler di ricerca. Per risolvere il problema, puoi effettuare una o più delle seguenti operazioni:
- Elimina alcuni dei tuoi crawler. Consulta Gestione dei crawler di ricerca.
- Elimina i singoli record tramite l’ API di ricerca federata. Tuttavia, se il crawler che sta indicizzando questa pagina è ancora attivo o se è attiva un’integrazione API personalizzata che aggiunge questa pagina, la pagina verrà visualizzata di nuovo alla prossima esecuzione del crawler o alla sincronizzazione dell’integrazione.
- Rimuovi dalla mappa del sito le pagine usate da uno o più crawler. La prossima volta che il crawler viene eseguito, reindicizzerà le pagine rimanenti ed eliminerà quelle rimosse dalla mappa del sito.
- Indirizza uno o più crawler a una mappa del sito con meno pagine. La prossima volta che il crawler viene eseguito, reindicizzerà le pagine rimanenti ed eliminerà quelle rimosse dalla mappa del sito.
-
La pagina sta usando i reindirizzamenti di località JavaScript : il crawler di ricerca non osserva i reindirizzamenti di località JavaScript. Se la pagina usa reindirizzamenti di località JavaScript, il crawler non può raggiungere il contenuto della pagina.
Per risolvere il problema, procedi in uno dei modi seguenti:
- Assicurati che la mappa del sito punti direttamente alla pagina da indicizzare.
- Implementa reindirizzamenti HTTP.
Avvertenza sulla traduzione: questo articolo è stato tradotto usando un software di traduzione automatizzata per fornire una comprensione di base del contenuto. È stato fatto tutto il possibile per fornire una traduzione accurata, tuttavia Zendesk non garantisce l'accuratezza della traduzione.
Per qualsiasi dubbio sull'accuratezza delle informazioni contenute nell'articolo tradotto, fai riferimento alla versione inglese dell'articolo come versione ufficiale.