Modifica il markup Schema – Yext Help

Il markup Schema è un dato strutturato incorporato nel codice della pagina che aiuta i motori di ricerca e i sistemi di IA a comprendere i contenuti. Ogni pagina del sito include automaticamente il markup Schema JSON-LD nel <head>. Usa l'editor del markup Schema per rivedere e personalizzare lo Schema generato e avere un maggiore controllo sulla SEO tecnica.

Accedi all'Editor del markup Schema

Vai all'editor di layout del tuo gruppo di pagine.
Fai clic su Pagina nella barra di navigazione in alto.
Seleziona Impostazioni avanzate.

Markup Schema predefinito

I gruppi di pagine della sede includono automaticamente il markup Schema LocalBusiness. Il modello predefinito appare così:

{
  "@context": "https://schema.org",
  "@type": "LocalBusiness",
  "@id": "[[siteDomain]]/[[path]]",
  "name": "[[name]]",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "[[address.line1]]",
    "addressLocality": "[[address.city]]",
    "addressRegion": "[[address.region]]",
    "postalCode": "[[address.postalCode]]",
    "addressCountry": "[[address.countryCode]]"
  },
  "openingHours": "[[hours]]",
  "image": "[[photoGallery]]",
  "description": "[[description]]",
  "telephone": "[[mainPhone]]",
  "paymentAccepted": "[[paymentOptions]]",
  "hasOfferCatalog": "[[services]]"
}

I gruppi di pagine di directory e localizzatori includono un markup Schema specifico per i tipi di pagina.

Modifica il template del markup Schema

Il template del markup Schema utilizza i segnaposto del campo Knowledge Graph per inserire dinamicamente valori specifici di entità nei dati strutturati di ogni pagina.

Sintassi dei segnaposto dei campi: usa la notazione con doppie parentesi per fare riferimento ai campi Knowledge Graph:

"name": "[[name]]",
"telephone": "[[mainPhone]]",
"streetAddress": "[[address.line1]]"

Il sistema sostituisce questi segnaposto con valori reali delle entità quando genera le pagine.

Selettore di campo: invece di digitare manualmente i nomi API dei campi, usa il menu a tendina del selettore di campi nell'editor per navigare e inserire i campi per nome visualizzato — gli stessi nomi che vedi nel Knowledge Graph. Dopo aver selezionato un campo, il nome API corretto viene inserito automaticamente nel template.

Gestione dei campi null: se un campo del Knowledge Graph è vuoto o nullo per un'entità, quella coppia chiave-valore viene automaticamente omessa dall'output finale del markup Schema. Non è richiesta alcuna manipolazione manuale.

Personalizzazione del modello: è possibile modificare il modello del markup Schema in base alle proprie esigenze:

Modifica @type in modo che corrisponda al tipo di attività
Aggiungi ulteriori proprietà schema.org
Rimuovi le proprietà che non si applicano alle tue entità

Importante: il modello di markup Schema si applica a tutte le pagine del gruppo. Un markup Schema non valido può influire sulla visibilità nei risultati di ricerca, quindi utilizza gli strumenti di convalida sottostanti prima di pubblicare le modifiche.

Aggiunte automatiche al markup Schema

Il sistema aggiunge automaticamente due tipi aggiuntivi di markup Schema a ogni pagina:

BreadcrumbList — Mostra la gerarchia delle pagine per la navigazione
AggregateRating — Visualizza i punteggi medi delle recensioni quando disponibili

Queste aggiunte sono incluse nell'output finale della pagina ma al momento non sono visibili nell'editor del markup Schema. Un aggiornamento futuro le renderà visibili come riferimento.

Il modello modificato e le aggiunte automatiche sono combinate in un array @graph nella <head> della pagina:

<script type="application/ld+json">
  {
    "@graph": [
      {
        /* Markup Schema LocalBusiness modificato */
      },
      {
        /* Markup Schema BreadcrumbList automatico*/
      },
      {
        /* Markup Schema AggregateRating automatico (se applicabile) */
      }
    ]
  }
</script>

Convalida e gestisci il tuo markup Schema

L'editor del markup Schema fornisce due strumenti di validazione e opzioni aggiuntive nel menu dell'editor:

Validazione JSON: l'editor valida la sintassi JSON prima di salvare. Non è possibile salvare un modello con sintassi JSON non valida.

Commutazione modello / anteprima: passa tra il modello di markup Schema grezzo e un'anteprima popolata con valori di entità effettivi per una specifica entità. Utilizza l'anteprima per verificare che i segnaposto campo vengano risolti correttamente prima di pubblicare.

Il menu Editor contiene tre opzioni:

Test con i risultati avanzati di Google — apre il markup Schema nel test Risultati avanzati di Google per confermare che è valido e idoneo per i risultati avanzati nella Ricerca Google.
Visualizza le best practice per il markup Schema — apri la guida di schema.org per aiutarti a strutturare ed estendere correttamente il tuo markup Schema.
Ripristina il markup Schema predefinito — Ripristina il modello originale predefinito per questo tipo di gruppo di pagine. Utilizza questa opzione se le modifiche apportate hanno prodotto errori e desideri ricominciare da capo.

Nota: le modifiche al markup Schema vengono salvate localmente e non vengono rese effettive finché non fai clic su Pubblica nell'editor di layout.