Todas as entidades no catálogo exigem as seguintes propriedades:
@id
: um identificador global do conteúdo.url
: um URL canônico do conteúdo.name
: o nome do conteúdo.
Exemplo de @id
, url
e name
:
"@id": "http://www.example.com/episode/video/432432432",
"url": "http://www.example.com/episode/video/432432432",
"name": "My example episode",
Identificador
Um identificador (@id
) precisa atender aos seguintes requisitos:
- Exclusivo globalmente no seu catálogo
- Por exemplo, não use o mesmo
@id
para umTVSeries
e umTVSeason
.
- Por exemplo, não use o mesmo
- Estático
- Não será possível alterar
@id
depois.
- Não será possível alterar
- Na forma de URI (Identificador de recurso unificado)
- Se o identificador local (ID) do seu conteúdo não estiver em um formato de URI, inclua seu domínio no ID para atender a esse requisito. Por exemplo, se o ID do conteúdo for 1234abc e o domínio for https://example.com,
@id
poderá ser https://example.com/1234abc. @id
não precisa ser um URL em funcionamento. ele só precisa estar em um formato de URI.- O domínio usado no
@id
(por exemplo, https://example.com) precisa ser da sua organização.
- Se o identificador local (ID) do seu conteúdo não estiver em um formato de URI, inclua seu domínio no ID para atender a esse requisito. Por exemplo, se o ID do conteúdo for 1234abc e o domínio for https://example.com,
Como o url
de uma entidade atende a todos os requisitos como identificador (ou seja, globalmente exclusivo, estático e na forma de URI), recomendamos que você use o url
de uma entidade como @id
.
URL canônico
Um URL canônico (url
) ajuda o Google a reconciliar com precisão o conteúdo do seu catálogo com o dos bancos de dados.
"Um URL canônico é o URL da página que o Google considera a mais representativa de um conjunto de páginas duplicadas no seu site. Por exemplo, se você tiver URLs para a mesma página (por exemplo: example.com?dress=1234 e example.com/vestidos/1234), o Google escolherá um deles como canônico. (Fonte: Consolidar URLs duplicados)
Confira a seguir os requisitos para URLs canônicos:
url
precisa ser globalmente exclusivo.url
precisa conter um URL canônico em funcionamento que possa ser rastreado pelo Google.- (Somente ações de escuta)
url
precisa direcionar para uma página de descrição do conteúdo que não esteja bloqueada por um paywall.
Coletar o ID, o URL e o nome
Faça o seguinte:
- Reúna os nomes do conteúdo do seu catálogo.
- Identifique os URLs canônicos do conteúdo. Recomendamos que você use o
url
do conteúdo como o@id
.