Puoi esportare i dati delle entità dal Knowledge Graph in qualsiasi momento. Le esportazioni possono essere eseguite una tantum, oppure possono essere salvate e programmate per la consegna automatica su base regolare. 

Può utilizzare lo strumento Esporta entità nel Knowledge Graph per selezionare le entità da esportare in un file .csv o .xlsx.

Ci sono alcuni componenti principali di un'esportazione di entità:

• Formato dei dati: include quali entità esportare, il linguaggio (puoi sovrascrivere questo nel passaggio dello schema di esportazione), la data da cui vuoi esportare i dati e come gestire i campi incorporati.
• Formato dei file: include il tipo di file e il layout del file.
• Schema di esportazione: include quali campi vuoi esportare e come formattarli.

Seleziona le entità da esportare

1. Acceda a Knowledge Graph > Entità.
2. Seleziona le entità che desideri esportare.
   • Usa le caselle sul lato sinistro dello schermo per selezionare più entità o tutte le entità nella vista corrente.
   • Puoi anche applicare un filtro salvato e selezionare tutte le entità nel filtro. Per creare un filtro salvato, consulta la sezione Creare e utilizzare i filtri salvati.
   • Se non selezioni alcuna entità, verranno incluse tutte le entità nel Knowledge Graph.
3. Fai clic sul pulsante Altre azioni nella parte superiore della schermata Entità e seleziona Esporta entità.
   
   

Informazioni di base

Nel passaggio Informazioni di base del flusso di esportazione delle entità, verifica il formato Dati e File della tua esportazione. Fai clic sul pulsante Modifica accanto a una delle sezioni per apportare modifiche.

1. Entità da esportare: questo passaggio confermerà il numero di entità di ciascun tipo che hai scelto di esportare.
   • Puoi deselezionare i tipi di entità per rimuovere tutte le entità di quel tipo dall'esportazione.
   • Per aggiungere tipi di entità o apportare altre modifiche alle entità specifiche incluse nell'esportazione, torna al Knowledge Graph e seleziona nuovamente le tue entità.
2. Lingua dell'entità: per impostazione predefinita, i dati dell'entità verranno esportati nel profilo linguistico principale. Se preferisci, seleziona profili linguistici alternativi da includere nell'esportazione.
   • L'aggiunta di profili in lingue alternative esporterà i dati per tutte le entità selezionate che dispongono di un profilo nella lingua scelta.
3. Lingua dell'intestazione: selezioni la lingua per le intestazioni delle colonne nel foglio di calcolo esportato.
4. Esporta dati a partire da: esporta i dati delle entità selezionate a partire da oggi, esporta i dati passati o esporta gli aggiornamenti dei dati previsti per una data futura.
   • Oggi
   • Data passata: scegli una data fino a 30 giorni fa
   • Data futura: i dati di esportazione rifletteranno gli aggiornamenti pianificati fino alla data scelta
   • Tutti gli aggiornamenti programmati: i dati di esportazione rifletteranno tutti i futuri aggiornamenti programmati
5. Campi incorporati: scegli come desideri visualizzare i dati dei campi incorporati nell'esportazione.
   • Valori dei campi di esportazione: l'esportazione conterrà il valore del campo incorporato (ad esempio, "Prova il nostro hamburger dal gusto indimenticabile a Genova!")
   • Esporta etichetta del campo incorporato: l'esportazione conterrà l'etichetta del campo incorporato (ad esempio, "Prova la [promozione del ristorante] a [città]!".
6. Formato del file di esportazione: scegli CSV o Excel (.xlsx)
7. Layout di esportazione: è impostato su Orizzontale per impostazione predefinita (per visualizzare un'entità per riga nel foglio di calcolo). Nella maggior parte dei casi, non avrai bisogno di modificarlo.
   • Se preferisci, seleziona Verticale per visualizzare un'entità per colonna.
8. Set di caratteri: è impostato su Unicode per impostazione predefinita. Nella maggior parte dei casi, non avrai bisogno di modificarlo.
   • Se preferisci, seleziona ASCII.

Una volta finito, fai clic su Continua.

Schema di esportazione

Nella scheda Schema di esportazione, puoi modificare i campi dell'entità inclusi nell'esportazione, l'ordine in cui i campi vengono visualizzati nell'esportazione e il formato di esportazione dei dati da determinati campi.Seleziona i campi che desideri includere nell'esportazione dal pannello a sinistra.

Qualsiasi campo selezionato apparirà nella tabella a destra. Fai clic sul menu a discesa Azioni in qualsiasi campo per riordinarlo nella tabella, rimuoverlo o configurarne la formattazione. 

1. Per aggiungere o rimuovere i campi inclusi nell'esportazione, seleziona o deseleziona le caselle di spunta nel pannello a sinistra.
   • Per rimuovere un campo, puoi anche cliccare sul menu a discesa Azioni su un campo della tabella e selezionare Rimuovi.
2. Per riordinare i campi nella tua esportazione, utilizza uno dei seguenti metodi:
   • Fai clic e trascina le tre linee orizzontali a sinistra del campo nella tabella.
   • Fai clic sul menu a discesa Azioni in un campo della tabella e seleziona Porta in alto o Porta in basso.
3. Per configurare il formato di esportazione dei dati da un determinato campo, fai clic sul menu a discesa Azioni del campo nella tabella e seleziona Configura. Verranno visualizzate diverse opzioni di configurazione a seconda del tipo di campo:
   • I campi di testo consentono di specificare un limite di caratteri, il modo in cui il testo deve essere tagliato a quel limite di caratteri e se aggiungere un puntino di sospensione (...) dopo il taglio.
   • I campi data e ora consentono di specificare il formato data e ora (ad esempio, MM/GG/AAAA vs. GG/MM/AAAA o 1:30 PM vs. 13:30)
   • I campi di tipo elenco o struttura ti permetteranno di scegliere se visualizzare le voci dell'elenco nelle rispettive colonne nell'esportazione o nella stessa colonna come un elenco separato da virgole.
   • I campi binari consentono di scegliere se visualizzare i valori come Sì/No, True/False o 1/0.

Per generare un’esportazione in un formato specifico per un publisher (ad esempio, se desideri caricare un insieme di entità come sedi sul Profilo dell'attività di Google), fai clic sul menu a discesa accanto a Schema di esportazione e scegli il formato desiderato:

• Profilo dell'attività su Google
• Yelp
• Snapchat
• Bing Places
• Caricamento di entità (Yext)

Una volta terminato, fai clic su Continua e l'esportazione verrà scaricata automaticamente.

Salva un'esportazione di entità

Se desideri riutilizzare questa configurazione di esportazione o impostare la consegna automatica, inserisci un nome per l'esportazione e fai clic su Salva esportazione.Altrimenti, fai clic su Fine.

Visualizza e modifica le esportazioni di entità salvate

Per vedere tutte le configurazioni di esportazione salvate, vai a Knowledge Graph > Configurazione. Scorri fino alla sezione Gestione delle entità e fai clic sul riquadro Esportazioni delle entità salvate .
 

Fai clic sul pulsante Modifica nella configurazione di esportazione delle entità alla quale desideri apportare modifiche. Da qui, puoi impostare la consegna automatica o apportare altre modifiche alla configurazione di esportazione.

In questa schermata puoi modificare le stesse impostazioni mostrate quando hai creato l'esportazione.

Applica i criteri di filtro delle entità alle esportazioni di entità salvate

Per modificare i criteri che determinano quali entità devono essere incluse in un'esportazione entità salvata, dovrai ricreare i criteri di filtro nel Knowledge Graph e applicarli nuovamente all'esportazione entità salvata.

1. Vai a Knowledge Graph > Entità.
2. Fai clic sulle opzioni di filtro predefinite nella barra dei filtri in alto oppure fai clic su Aggiungi filtro per visualizzare altre opzioni.
3. Seleziona i criteri di filtro desiderati. Accertati di includere tutti i criteri che desideri siano applicati all'esportazione dell'entità salvata.
4. Fare clic su Applica filtro.
5. Fai clic sul menu a discesa Altre azioni nella parte superiore della tabella Entità e seleziona Applica la ricerca all'esportazione salvata.
   
   
   
    
6. Nella finestra modale che appare, seleziona l'esportazione dell'entità salvata che desideri dal menu a discesa.

7. Fai clic su Applica il filtro attivo all'esportazione salvata.
   
   

    

Imposta la distribuzione automatica su un'esportazione di entità salvata

Puoi configurare la consegna automatica su un'esportazione salvata in due modi:

• E-mail
• FTP/SFTP (File Transfer Protocol o Secure File Transfer Protocol).

Per impostare la consegna automatica delle esportazioni di entità:

1. Vai a Knowledge Graph > Configurazione. Scorri fino alla sezione Gestione delle entità e fai clic sul riquadro Esportazioni delle entità salvate.
   
   
    
2. Fai clic sul pulsante Modifica nella configurazione di esportazione delle entità che desideri automatizzare.
   • Per creare una nuova configurazione di esportazione di entità, fai clic sul pulsante Aggiungi esportazione personalizzata in alto a destra.
3. Nella schermata Gestisci l'esportazione delle entità salvate, fai clic su Modifica nella sezione Consegna automatica.
4. Nel menu a discesa Tipo, scegli come desideri che venga inviata l'esportazione della tua entità: Email, o trasferimento di file tramite FTP o SFTP.
   
   

A seconda del tipo di invio scelto, segui la procedura corrispondente qui sotto.

Configura l'invio tramite e-mail

1. Nel campo Indirizzo email, inserisci gli indirizzi dei destinatari scelti, separati da virgole.
   • Fai clic su Invia a me per includere il tuo indirizzo email (questa operazione compilerà in automatico l'indirizzo email con cui sei attualmente connesso a Yext).
2. Nel campo Riga dell'oggetto, puoi inserire una riga dell'oggetto per l'email di consegna automatica.
3. Imposta le opzioni di frequenza in base a quanto spesso desideri che l'esportazione venga inviata ai tuoi destinatari:
   • Scegli tra Oraria, Giornaliera, Settimanale, Bisettimanale o Mensile.
   • Seleziona una data di inizio, un'ora e un fuso orario per la prima consegna. Tieni presente che i fusi orari relativi non sono un'opzione e tutti i destinatari riceveranno l'esportazione alla stessa ora, indipendentemente dalla loro posizione o dal loro fuso orario.
4. Ignora file vuoto: scegli come dovrebbe rispondere la consegna dell'esportazione se non ci sono dati disponibili che corrispondono ai filtri di esportazione per l'intervallo di tempo scelto (ad esempio, se hai scelto la consegna settimanale e l'esportazione di questa settimana non contiene entità basate sui filtri della configurazione di esportazione salvata).
   • Sì: i file vuoti vengono ignorati e la consegna dell'esportazione viene saltata per quell'intervallo di tempo
   • No: i file vuoti non vengono ignorati e la consegna dell'esportazione verrà inviata secondo i tempi previsti, con un file vuoto all'interno.
5. Fai clic su Salva.

Quando i tuoi destinatari riceveranno l'email automatica, questa conterrà un link per scaricare il file contenente i dati di esportazione, come nell'esempio seguente. I link per il download hanno una validità di sette giorni dal momento in cui vengono inviati.

Dopo aver impostato le preferenze di recapito delle email, puoi inviare una versione di prova della tua email esportata. Per farlo, fai clic sul pulsante Invia Test nella sezione Consegna automatica delle impostazioni di esportazione delle entità salvate.



 

Configura la consegna tramite FTP/SFTP

Contatta l'amministratore di sistema o il team IT per inserire l'host, il nome utente, la password e il percorso della cartella corretti per la tua organizzazione.

1. Host: inserisci l'indirizzo host FTP o SFTP per il tuo server. Non includere il protocollo ("ftp://" o "sftp://").
2. Porta: la porta predefinita è 21 per FTP e 22 per SFTP.
3. Inserisci il nome utente e la password.
4. Inserisci il percorso della cartella in cui desideri che venga consegnato il trasferimento di file.
5. Fai clic sul menu a discesa Opzioni per la consegna per scegliere come desideri che venga gestito il trasferimento dei file:
   1. Rinomina il file al termine del trasferimento: il file verrà inviato come file temporaneo ".tmp". Una volta che il trasferimento è completato, il file verrà rinominato automaticamente per rimuovere l'estensione del file temporaneo.
   2. Invia il file 'Done' al termine del trasferimento: una volta completato il trasferimento, Yext invia un file con un estensione ".done" (ad esempio, "filename.csv.done").
   3. Trasferimento del file: Yext trasferisce il file senza alcuna indicazione aggiuntiva che il trasferimento sia stato completato. La scelta di questa opzione potrebbe causare problemi se un utente tenta di aprire o leggere il file prima che il trasferimento sia completato.
6. Imposta le opzioni di frequenza in base a quanto spesso desideri che l'esportazione venga inviata ai tuoi destinatari:
   1. Scegli tra Oraria, Giornaliera, Settimanale, Bisettimanale o Mensile.
   2. Seleziona una data di inizio, un'ora e un fuso orario per la prima consegna. Tieni presente che i fusi orari relativi non sono un'opzione e tutti i destinatari riceveranno l'esportazione alla stessa ora, indipendentemente dalla loro posizione o dal loro fuso orario.
7. Ignora file vuoto: scegli come dovrebbe rispondere la consegna dell'esportazione se non ci sono dati disponibili che corrispondono ai filtri di esportazione per l'intervallo di tempo scelto (ad esempio, se hai scelto la consegna settimanale e l'esportazione di questa settimana non contiene entità basate sui filtri della configurazione di esportazione salvata).
   1. Sì: i file vuoti vengono ignorati e la consegna dell'esportazione viene saltata per quell'intervallo di tempo
   2. No: i file vuoti non vengono ignorati e la consegna dell'esportazione verrà inviata secondo i tempi previsti, con un file vuoto all'interno.
8. Fai clic su Salva.

I file contenenti i dati di esportazione della tua entità saranno denominati come segue: (Nome configurazione esportazione)-(Data AAAA-MM-GG)-(Timestamp in millisecondi)

Ad esempio, il nome del file per un'esportazione salvata denominata "URL di generazione di recensioni per il ristorante", esportata in formato CSV il 7 aprile 2025 alle 10:52 (EST) sarebbe simile a: "URL-di-generazione-di-recensioni-per-il-ristorante-20250407-1744037536284.csv".

Visualizza la cronologia di consegna per le esportazioni salvate

Dopo aver configurato la consegna automatica, puoi visualizzare la cronologia delle consegne per avere un registro di tutte le consegne delle tue esportazioni salvate e lo stato di ciascuna consegna.

Dalla schermata Esportazioni delle entità salvate , fai clic su Visualizza cronologia delle consegne nell'angolo in alto a destra.

Qui vedrai una tabella di tutte le consegne automatiche di esportazione delle entità, inclusi il Tipo (Email, FTP o SFTP), lo Stato e la Data di Esportazione.

Fai clic sul menu a discesa Tutte le esportazioni salvate per filtrare e visualizzare solo le consegne relative a una specifica esportazione salvata.