Tutte le entità nel catalogo richiedono le seguenti proprietà:
@id
: un identificatore globale dei contenuti.url
: un URL canonico per i contenuti.name
: il nome dei contenuti.
Esempio di @id
, url
e name
:
"@id": "http://www.example.com/episode/video/432432432",
"url": "http://www.example.com/episode/video/432432432",
"name": "My example episode",
Identificatore
Un identificatore (@id
) deve soddisfare i seguenti requisiti:
- Univoco a livello globale nel tuo catalogo
- Ad esempio, non utilizzare lo stesso
@id
perTVSeries
eTVSeason
.
- Ad esempio, non utilizzare lo stesso
- Statica
- Non puoi modificare
@id
in un secondo momento.
- Non puoi modificare
- Sotto forma di URI (Unified Resource Identifier)
- Se l'identificatore locale (ID) dei contenuti non è in formato URI, anteponi il tuo dominio all'ID per soddisfare questo requisito. Ad esempio, se l'ID dei tuoi contenuti è 1234abc e il tuo dominio è https://example.com,
@id
può essere https://example.com/1234abc. @id
non deve essere necessariamente un URL funzionante. deve essere solo in formato URI.- Il dominio utilizzato in
@id
(ad esempio, https://example.com) deve essere di proprietà della tua organizzazione.
- Se l'identificatore locale (ID) dei contenuti non è in formato URI, anteponi il tuo dominio all'ID per soddisfare questo requisito. Ad esempio, se l'ID dei tuoi contenuti è 1234abc e il tuo dominio è https://example.com,
Poiché l'elemento url
di un'entità soddisfa tutti i requisiti come identificatore (ovvero univoco a livello globale, statico e sotto forma di URI), ti consigliamo di utilizzare url
di un'entità come @id
.
URL canonico
Un URL canonico (url
) consente a Google di riconciliare in modo accurato i contenuti del tuo catalogo con i contenuti nei database di Google.
"Un URL canonico è l'URL della pagina che Google ritiene più rappresentativa tra un insieme di pagine duplicate sul tuo sito. Ad esempio, se hai degli URL per la stessa pagina (come example.com?dress=1234 e example.com/abiti/1234), Google ne sceglie uno come canonico." (Fonte: Consolidare gli URL duplicati)
Di seguito sono riportati i requisiti per l'URL canonico:
url
deve essere univoco a livello globale.url
deve contenere un URL canonico funzionante di cui Google possa eseguire la scansione.- (Solo azioni di ascolto)
url
deve indirizzare a una pagina di descrizione dei contenuti non bloccata da un paywall.
Raccogli l'ID, l'URL e il nome
Segui questi passaggi:
- Riunisci i nomi dei contenuti del tuo catalogo.
- Identifica gli URL canonici dei contenuti. Ti consigliamo di utilizzare
url
dei contenuti come@id
.