Carica entità su Yext – Yext Help

Questo articolo spiega come aggiungere e modificare in blocco entità al tuo account caricando un foglio di calcolo con il flusso di lavoro Caricamento di entità.

Per sapere come aggiungere entità una alla volta, consulta Aggiungere una singola entità.

Nota: Caricamento di entità è solo uno dei modi per caricare fogli di calcolo dei dati delle entità nel Knowledge Graph. Puoi anche caricare i dati delle entità in formato .CSV, .XLSX o JSON utilizzando il framework Connectors, che è un processo separato da Caricamento di entità. Per sapere come creare un connettore di caricamento file per caricare dati, consulta la guida Crea un connettore di caricamento file su Hitchhikers.

Prima di iniziare

Assicurati che il tuo foglio di calcolo sia formattato correttamente prima di iniziare il caricamento:

Assicurati che il tuo file sia in formato .XLS, .XLSX o .CSV.
Includi le colonne per l'ID entità e il Paese/l'area geografica, nonché tutti gli altri campi obbligatori per il tipo di entità che stai caricando.
Per visualizzare tutti i campi richiesti per tipo di entità e scaricare i modelli di caricamento di esempio, consulta Modelli di caricamento delle entità e campi richiesti.

Carica entità

Per aggiungere e modificare entità caricando un foglio di calcolo:

Accedi a Ricerca delle entità (Knowledge Graph > Entità) e fai clic su Aggiungi dati.
Scegli Caricamento di entità dalla finestra modale Aggiungi dati.
Si aprirà il passaggio Carica file del flusso Caricamento di entità. Imposta le seguenti opzioni:
- Fai clic su Scegli file per selezionare il tuo foglio di calcolo.
- Se stai utilizzando una configurazione di caricamento salvata per caricare dati in un formato specificato, scegli la configurazione di caricamento salvata dal menu a discesa.
- Se non stai utilizzando una configurazione di caricamento, lascia selezionata l'opzione No, si tratta di un nuovo foglio di calcolo.
- Se stai caricando dati in una lingua diversa da quella predefinita per il tuo account, seleziona la lingua dal menu a discesa.
- Fai clic su Continua.
Nel passaggio Configura File, mappa le colonne del foglio di calcolo ai campi in Yext. Il sistema mapperà automaticamente le colonne quando possibile, ma potrebbe essere necessario selezionare la mappatura appropriata dei campi per alcune colonne.
- Per mappare una colonna a un campo, fai clic sul menu a discesa Mappa questa colonna, digita il nome del campo da mappare e selezionalo dal menu.
- Se non desideri caricare i valori dei campi per nessuna delle colonne non mappate nel tuo foglio di calcolo, fai clic su Ignora tutte le colonne non mappate per saltare la mappatura di queste colonne ai campi.
- Per modificare la mappatura dei campi per qualsiasi colonna mappata automaticamente, fai clic sul menu a discesa contenente il nome del campo mappato e seleziona un campo diverso.
Per impostazione predefinita, ogni colonna mappata avrà le seguenti Regole per la pulizia dei dati impostate:
- Escludi spazi vuoti: escludi gli spazi iniziali o finali dal valore della colonna
- Ignora i valori vuoti: Caricamento di entità ignorerà il caricamento di qualsiasi cella vuota (in modo che i valori dei campi esistenti in Yext non vengano rimossi).
Per modificare una delle regole per la pulizia dei dati, fai clic su Modifica accanto alla colonna che desideri modificare.
- A seconda del tipo di campo che stai modificando, potrebbero essere disponibili diverse regole per la pulizia dei dati tra cui scegliere.
- Una volta finito, fai clic su chiudi.
Utilizza i campi aggiuntivi per impostare eventuali valori di campo aggiuntivi che non hai incluso nel foglio di calcolo. Per impostare un valore di campo aggiuntivo, fai clic su Aggiungi campo.
- Tieni presente che questa impostazione assegnerà lo stesso valore di campo per tutte le entità (ad esempio, l'impostazione di un valore di campo aggiuntivo per il campo "Accetta prenotazioni" imposterà tutte le entità su "Sì" o "No").
- Se desideri impostare valori di campo diversi per entità diverse nel tuo caricamento, dovresti caricare un nuovo file che includa quel campo. Per farlo, rivedi il tuo foglio di calcolo, quindi fai clic su Altre azioni nell'angolo in alto a destra. Seleziona Carica file aggiornato.
Se stai aggiungendo un campo aggiuntivo, scegli il campo che desideri impostare dal menu a discesa Mappa questa colonna .
- Inserisci il valore del campo desiderato per tutte le entità nella casella di testo Valore del campo.
- Se lo desideri, applica eventuali regole per la pulizia dei dati.
- Scegli l'ambito delle entità a cui applicare il campo: qualsiasi nuova entità, qualsiasi entità già esistente nel Knowledge Graph, o tutte le entità nel file.
- Una volta terminato, fai clic su Salva. Ripeti la stessa operazione per tutti gli altri campi che desideri aggiungere.
Utilizza la sezione Azioni aggiuntive per aggiungere le entità nel tuo caricamento a una cartella, applicare etichette o applicare un modello di entità.
- Fai clic su Aggiungi azione accanto all'azione che desideri eseguire.
- Nel menu a discesa Seleziona il tipo di entità , scegli l'ambito della tua azione: qualsiasi nuova entità, qualsiasi entità mancante (entità già presenti nel tuo Knowledge Graph che non fanno parte di questo caricamento), tutte le entità nel tuo file o tutte le entità nel tuo account (incluso il caricamento attuale).
- A seconda dell'azione scelta, seleziona la cartella, l'etichetta o il modello che desideri applicare.
- Per ulteriori informazioni su queste azioni, consulta Creare una cartella, Gestisci e applica etichette di entità, o Creare un template per un'entità.
Dopo aver mappato tutte le colonne e impostato eventuali campi o azioni aggiuntivi, fai clic su Continua in basso a destra.
Nel passaggio Analizza File , il sistema elaborerà il tuo caricamento.
- Se non si verificano problemi con il tuo caricamento, verrai indirizzato al passaggio Controlla modifiche.
- Se invece si verificassero problemi, verrai indirizzato al passaggio Risolvi errori.
Nel passaggio Risolvi errori , esamina e risolvi eventuali problemi relativi ai dati nel tuo foglio di calcolo. La tabella mostrerà le colonne con errori e il numero di righe interessate da ciascun errore.
Scegli uno dei seguenti modi per risolvere gli errori:
- Per scaricare un foglio di calcolo degli errori, correggerli nel file e ricaricarlo: fai clic su Errori di download.
- Per correggere tutti gli errori direttamente nel flusso di Caricamento di entità, fai clic su Correggi tutti gli errori.
- Per correggere un solo tipo di errore alla volta nel flusso di Caricamento di entità, fai clic su Correggi errori nella visualizzazione del foglio di calcolo accanto all'errore scelto.
- Per saltare il caricamento dei valori dei campi con errori, fai clic sulla freccia del menu a discesa sull'errore selezionato e seleziona Ignora questi valori.
Se hai selezionato Correggi tutti gli errori o hai scelto di correggere un singolo errore nella visualizzazione del foglio di calcolo, vedrai le righe con gli errori e una spiegazione dell'errore. Inserisci il valore corretto del campo per ogni riga nella colonna Nuovo valore.
Nel passaggio Controlla modifiche, vedrai una suddivisione di tutte le entità nel tuo caricamento per categoria: nuove entità, entità aggiornate, entità non modificate (presenti nel tuo caricamento, ma nessun dato è stato aggiunto o modificato) ed entità mancanti (entità nel tuo account che non erano presenti nel tuo caricamento).
- Fai clic su ciascun numero Hero per ulteriori dettagli sulle singole entità in ciascuna categoria.
- Fai clic su Scarica il riepilogo completo per scaricare la ripartizione per tutte le categorie di entità
- Fai clic sui singoli pulsanti Download di ogni categoria per scaricarne il riepilogo.
Fai clic su ogni categoria nel passaggio Controlla modifiche. Seleziona la casella di controllo in basso per confermare la modifica (ad esempio, "Confermo che sto aggiungendo [x] entità"), e fai clic su Avanti in basso a sinistra per procedere alla categoria successiva.
- Questa operazione deve essere eseguita per ciascuna categoria, anche nel caso in cui non siano presenti entità.
Dopo aver confermato l'ultima categoria, fai clic su Invia modifiche per confermare tutte le modifiche.
Nel passaggio Riepilogo , il sistema elaborerà e applicherà le modifiche al tuo caricamento. Puoi monitorare queste modifiche nella barra di avanzamento nella parte superiore dello schermo.
- Se desideri salvare questa configurazione di caricamento per caricare più dati utilizzando le stesse opzioni di formattazione in futuro, inserisci un nome per la configurazione accanto all'opzione Nome di configurazione e fai clic su Salva.
- Altrimenti, fai clic su Fatto o Torna ai caricamenti per uscire dal flusso Caricamento di entità.

Nota: se carichi un file radicalmente diverso dai contenuti archiviati all'interno del tuo account, Yext potrà controllarlo manualmente e approvarlo per garantire che tutti gli aggiornamenti siano corretti e voluti.

Dopo l'upload

Per visualizzare i caricamenti di entità passati e le configurazioni di caricamento salvate, vai a Knowledge Graph > Configurazione. Fai clic sul riquadro Configurazioni di caricamento o Caricamenti di file di dati.