Una volta che hai aggiunto correttamente il tag script al tuo sito web (consulta Aggiungi Knowledge Tag al tuo sito), puoi aggiungere contenuti rivolti ai clienti alle tue pagine utilizzando i codici di incorporamento. In questo modo puoi visualizzare sul tuo sito web i contenuti delle entità memorizzate in Yext. Ciò significa che una volta aggiornato il contenuto di un'entità, l'aggiornamento si rifletterà automaticamente sul tuo sito web.

Nota: devi aggiungere il tag <script> alla tua pagina prima di poter sfruttare i codici incorporati per aggiungere contenuti.

Per aggiungere contenuti rivolti ai clienti al tuo sito:

1. Fai clic su Pagine nella barra di navigazione, quindi su Knowledge Tag.
2. Fare clic sul pulsante Aggiungere Knowledge Tag al sito.
3. Fai clic sul pulsante Seleziona entità e seleziona l'entità desiderata.
4. Ove applicabile, seleziona le impostazioni locali desiderate.
5. Ove applicabile, seleziona le impostazioni di Analytics desiderate. 
6. Ottieni i codici di incorporamento per i campi che desideri potenziare con il Knowledge Graph di Yext. Per visualizzare altri campi entità, fai clic sul link Altri campi. 
7. Aggiungi i codici di incorporamento nel punto del sito in cui preferisci che vengano visualizzati.

Esempio

Puoi utilizzare il seguente tag di incorporamento per visualizzare qualsiasi contenuto delle entità Yext direttamente su una pagina web. 

<span data-yext-field="name"></span>

Per selezionare un campo da Yext, aggiorna il valore di data-yext-field con il nome API del campo che desideri visualizzare. Nell'esempio sopra, viene visualizzato il campo Nome. Consulta Visualizza il nome API per un campo per individuare i nomi API dei campi delle entità.

Pagine con più entità

Se nella tua pagina visualizzi contenuti per più entità, assicurati che i codici di incorporamento includano anche la proprietà data-yext-id che specifica quale entità deve essere utilizzata nel tag. Ad esempio:

Se nella tua pagina visualizzi contenuti per più entità, assicurati che i codici di incorporamento includano anche la proprietà data-yext-id che specifica quale entità deve essere utilizzata nel tag. Ad esempio:

• Se la tua pagina è per un'entità, il codice dell'indirizzo avrà questo aspetto:

 <span data-yext-field="address.line1"></span>

• Se la tua pagina visualizza più campi di indirizzo, il codice dell'indirizzo per ciascun campo sarà simile a questo:

<span data-yext-field="address.line1" data-yext-id="815"></span>

Per recuperare dati da più entità, devi includere un parametro entity_id per ciascuna entità nella tua richiesta di Knowledge Tag (ad esempio entity_id=example1&entity_id=example2).

Campi personalizzati

Per visualizzare i contenuti memorizzati nei Campi personalizzati sulle tue pagine, puoi creare codici di incorporamento utilizzando il seguente formato:

<span data-yext-field="c_myCustomField"></span>

In questo caso, c_myCustomField è il nome API del campo personalizzato e il Tag HTML (ad esempio, <span>), varierà a seconda del tipo di campo.

Campi elenco

Per visualizzare un campo di tipo elenco sulla tua pagina, puoi utilizzare uno qualsiasi dei seguenti tag HTML per mostrare il contenuto dei tipi di campo elenco sulla tua pagina:

• <ul> — elenchi puntati
• <ol> — elenchi numerati
• <span> — elenco separato da virgole su una sola riga
• <div> — crea una serie di elementi <div> , ognuno su una riga separata

Ad esempio, per visualizzare un elenco puntato dei tuoi prodotti, dovresti utilizzare il seguente tag di incorporamento:

<ul data-yext-field=”products”></ul>

Per visualizzare un campo personalizzato che contiene un elenco, si utilizza quanto segue:

<ul data-yext-field="c_listField"></ul>

Campi aggiuntivi

Di seguito troverai un elenco di alcuni dei campi che possono essere utilizzati per incorporare contenuti nelle pagine. Questi campi vengono evidenziati, poiché i Knowledge Tag restituiscono i dati in un formato specifico.

 

Per un elenco completo di come verranno denominati e formattati tutti gli altri dati delle entità, consulta la nostra Documentazione dell'API Content Delivery .