Esempi JSON-LD per ambito

È possibile creare una regola JSON-LD in qualsiasi ambito supportato dai metatag di pagina. Ogni ambito espone dati diversi ai token ${...}. Inserire i token senza racchiudere le virgolette; B2C Commerce cita ogni valore risolto come stringa JSON. Per l'elenco completo degli oggetti e degli operatori disponibili in ciascun ambito, vedere Sintassi metatag.

In questi esempi vengono utilizzati tipi di Schema.org comuni con alcuni attributi di prodotto, categoria, contenuto e sito. Regolare gli attributi in modo che corrispondano al catalogo e al contenuto e convalidare l'output.

Pagina dettagli prodotto

Emettere un prodotto per il prodotto sulla pagina.

 { "@context": "https://schema.org",
 "@type": "Prodotto",
    "nome": ${Product.name},
    "marca": ${Product.brand},
    "offerte": {
        "@type": "Offerta",
        "prezzo": ${ProductPrice.min},
        "priceCurrency": ${ProductPrice.currency}
    }
}

Pagina elenco prodotti

Creare un oggetto CollectionPage per la categoria. Una regola viene risolta in base a un singolo oggetto, pertanto non è possibile elencare tutti i prodotti sulla pagina, ma descrivere la categoria.

 { "@context": "https://schema.org",
 "@type": "CollectionPage",
    "name": ${Category.displayName},
    "url": ${OriginalRequestURL}
}

Pagina dettagli contenuto

Emettere un articolo, o un altro tipo appropriato, per l'asset di contenuto sulla pagina.

 { "@context": "https://schema.org",
 "@type": "Articolo",
    "titolo": ${Content.name},
    "url": ${OriginalRequestURL}
}

Pagina elenco contenuti

Creare un oggetto CollectionPage per la cartella dei contenuti.

 { "@context": "https://schema.org",
 "@type": "CollectionPage",
    "name": ${Folder.displayName},
    "url": ${OriginalRequestURL}
}

Pagina principale

Creare un sito Web per lo storefront.

 { "@context": "https://schema.org",
 "@type": "Sito Web",
    "nome": ${Site.displayName},
    "url": ${OriginalRequestURL}
}

Fallback con operatori

B2C Commerce omette l'intero blocco se il contenuto risolto non è JSON valido. Utilizzare l'operatore ELSE per eseguire il fallback su un valore sempre presente quando un token può essere risolto a vuoto. Il nome localizzato di un prodotto può essere vuoto in alcune impostazioni locali, ma il relativo ID è sempre impostato, pertanto Product.ID è un fallback sicuro per il nome:

 { "@context": "https://schema.org",
 "@type": "Prodotto",
    "nome": ${Product.name ELSE Product.ID},
    "offerte": {
        "@type": "Offerta",
        "prezzo": ${ProductPrice.min},
        "priceCurrency": ${ProductPrice.currency}
    }
}

Scegliere un fallback che sia costituito da dati accurati. Non sostituire un segnaposto, ad esempio un nome di marca costante, a meno che tu non sia sicuro che sia corretto in tutti i casi. Gli operatori sostituiscono un valore, ma non rimuovono un'intera riga " key": value e la sua virgola finale, quindi per un campo che è veramente facoltativo, lascialo fuori dal modello piuttosto che creare un valore.