Questo articolo spiega come aggiungere una marcatura Schema.org personalizzata alle pagine create per le tue entità personalizzate. Per impostazione predefinita, le pagine create per i tipi di entità integrati conterranno già la marcatura Schema.org in base al tipo di entità e al contenuto della pagina. Tuttavia, poiché le entità personalizzate possono essere utilizzate per qualsiasi contenuto, non esiste alcuna marcatura predefinita, pertanto dovrai aggiungere una marcatura Schema.org personalizzata alla pagina per le entità personalizzate in modo da essere certo che includa le marcature Schema.org pertinenti per il tipo di pagina e il contenuto.

Per aggiungere una marcatura Schema.org personalizzata alle tue pagine:

1. Fai clic su Pagine nella barra di navigazione, quindi su Tutti i siti.
2. Fai clic su Modifica accanto al sito a cui desideri aggiungere un markup personalizzato. 
3. Fai clic su Modifica accanto al template a cui desideri aggiungere una marcatura personalizzata.
4. Fai clic su Impostazioni nella barra laterale.
5. Fai clic su Personalizza le marcature Schema.org. Si aprirà una sezione Editor del codice e Riferimento di campo.
6. Nell'editor del codice, sostituisci il valore per "@tipo" con il tipo di schema.org adeguato. Questo processo varia a seconda che tu stia creando una marcatura per le pagine relative ai tipi di entità predefiniti o ai tipi di entità personalizzati.
   • Per i tipi di entità personalizzati dovrai eseguire la codifica del "@tipo" o creare un campo personalizzato e utilizzare una variabile per mappare a quel campo. Per la procedura di creazione di un campo personalizzato, vediAggiungere un campo personalizzato.
   • Per i tipi di entità predefiniti, il "@tipo" verrà impostato su $meta.schemaTypes in modo che il suo valore provenga dal campo Categoria nel Knowledge Graph di Yext.
     • Per impostare una categoria specifica per Schema, che può essere diversa da quella del Knowledge Graph di Yext, vedi Gestione avanzata delle categorie e seleziona l'elenco delle categorie Schema per sovrascrivere la categoria
   • Consigliamo di seguire le istruzioni nel documento di riferimento ai dati strutturati di Google per identificare il tipo migliore per la tua pagina.
7. Aggiungi le proprietà per quel "@tipo" in base al contenuto della tua pagina.
   • È importante che tu includa solo la marca per il contenuto presente nella pagina.
   • Per aiutarti a determinare quali campi mappare a quali proprietà di Schema.org, consulta la definizione di Schema.org e il documento di riferimento ai dati strutturati di Google (i link sono per un’entità Prodotto, quindi utilizza le risorse per il tuo particolare tipo di entità).
   • Per nascondere l'anteprima attiva ed espandere le sezioni Editor del codice e Riferimento di campo, fai clic sul link Espandi nell'angolo in alto a destra della sezione Riferimento di campo.
8. Assegna valori a queste proprietà utilizzando il Riferimento di campo.
   • Nell'aggiungere i valori, puoi utilizzare variabili o eseguire la codifica del contenuto statico. Si noti che l'opzione per utilizzare le variabili è disponibile solo quando si aggiunge Schema a un modello di pagina. Passa alla sezione pertinente qui sotto:
     • Usa le variabili:
       1. Inserisci un simbolo "$" seguito dal nome del campo, ad es.
          "accettaPrenotazioni": "$Urlprenotazioni.url"
          • Nota: per la mappatura dinamica saranno disponibili solo i campi nel Riferimento di campo.
     • Eseguire la codifica del contenuto statico:
       1. Inserisci il valore per la proprietà corrispondente, ad es. "accettaPrenotazioni": "Sì"
   • Nota: le variabili non possono essere utilizzate quando si aggiunge il markup Schema.org alle pagine del Finder.
     
9. Dopo aver aggiunto tutti i campi e le proprietà desiderati, fai clic su Salva nell'angolo in basso a sinistra.
   • Nota: non potrai salvare il tuo schema in caso di errori si sintassi.
10. Verifica che lo schema della pagina sia corretto.
    1. Fai clic sul link URL di anteprima nella parte superiore della pagina.
    2. Copia il link di anteprima.
    3. Consulta lo strumento Test dei risultati avanzati di Google.
    4. Inserisci il link di anteprima nella casella di testo e fai clic su TEST URL.
    5. Controlla che i contenuti abbiano l'aspetto desiderato e che Google non visualizzi alcun errore.
       

Ad esempio, il markup Schema.org per la nostra entità di prodotto personalizzata potrebbe apparire come segue. Google richiede che mappiamo il logo, il nome e uno tra review, aggregateRating o offers. 

{
  "@context": "https://schema.org",
  "@type": "Product",
  "description": "$description",
  "logo": "$logo.image.url",
  "name": "$name",
  "offers": {
    "@type": "Offer",
      "availability": "https://schema.org/InStock",
    "price": "0",
    "priceCurrency": "USD"
  },
  "url": "$websiteUrl.url"
}

Il risultato del Test dei risultati avanzati di Google dovrebbe essere simile a questo: