Raccogliere l'ID, l'URL e il nome dei tuoi contenuti

Tutte le entità del tuo catalogo richiedono le seguenti proprietà:

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 per un TVSeries e un TVSeason.
  • Statico
    • Non puoi modificare @id in un secondo momento.
  • Sotto forma di URI (Uniform Resource Identifier)
    • Se l'identificatore locale (ID) dei tuoi 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 un URL funzionante, ma deve essere in formato URI.
    • Il dominio utilizzato in @id (ad esempio https://example.com) deve essere di proprietà della tua organizzazione.

Poiché il url di un'entità soddisfa tutti i requisiti di un identificatore (ovvero è univoco a livello globale, statico e sotto forma di URI), ti consigliamo di utilizzare il url di un'entità come @id.

URL canonico

Un URL canonico (url) aiuta Google a riconciliare con precisione i contenuti del tuo catalogo con quelli dei 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 più URL per la stessa pagina (ad esempio example.com?dress=1234 ed example.com/dresses/1234), Google ne sceglie uno come canonico." (Fonte: Raggruppare 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 che Google può eseguire la scansione.
  • (Solo azioni di ascolto) url deve puntare a una pagina di descrizione dei contenuti non bloccata da un paywall.

Raccogliere l'ID, l'URL e il nome

Segui questi passaggi:

  1. Raccogliere i nomi dei contenuti nel tuo catalogo.
  2. Identifica gli URL canonici dei contenuti. Ti consigliamo di utilizzare il url dei contenuti come @id.