Todas las entidades de tu catálogo deben tener las siguientes propiedades:
@id
: Es un identificador global para el contenido.url
: Es una URL canónica del contenido.name
: Es el nombre del contenido.
A continuación, se muestra un ejemplo de @id
, url
y name
:
"@id": "http://www.example.com/episode/video/432432432",
"url": "http://www.example.com/episode/video/432432432",
"name": "My example episode",
Identificador
Un identificador (@id
) debe cumplir los siguientes requisitos:
- Único a nivel global en todo tu catálogo
- Por ejemplo, no uses el mismo
@id
para unaTVSeries
y unaTVSeason
.
- Por ejemplo, no uses el mismo
- Estáticas
- No puedes cambiar
@id
más adelante.
- No puedes cambiar
- Con el formato de un identificador de recursos unificado (URI)
- Si el identificador local (ID) de tu contenido no está en formato de URI, antepón tu dominio al ID para cumplir con este requisito. Por ejemplo, si el ID de tu contenido es 1234abc y tu dominio es https://example.com,
@id
puede ser https://example.com/1234abc. - No es necesario que
@id
sea una URL en funcionamiento. solo debe estar en formato URI. - El dominio que se utilice en
@id
(por ejemplo, https://example.com) debe ser propiedad de tu organización.
- Si el identificador local (ID) de tu contenido no está en formato de URI, antepón tu dominio al ID para cumplir con este requisito. Por ejemplo, si el ID de tu contenido es 1234abc y tu dominio es https://example.com,
Debido a que el url
de una entidad cumple con todos los requisitos como identificador (es decir, único a nivel global, estático y en forma de URI), te recomendamos que uses el url
de una entidad como @id
.
URL canónica
Una URL canónica (url
) ayuda a Google a conciliar de manera precisa el contenido de tu catálogo con el de las bases de datos de Google.
"Una URL canónica es la URL de la página que Google considera como la más representativa de un conjunto de páginas duplicadas de tu sitio. Por ejemplo, si tienes URLs para la misma página (como example.com?dress=1234 y example.com?dress=1234), Google elegirá una de ellas como canónica. (Fuente: Consolidate duplicate URLs).
A continuación, se indican los requisitos de la URL canónica:
url
debe ser único a nivel global.url
debe contener una URL canónica que funcione y que Google pueda rastrear.- (Solo acciones de escucha)
url
debe apuntar a una página de descripción del contenido que no esté bloqueada por un muro de pago.
Recopila el ID, la URL y el nombre
Puedes hacer lo siguiente:
- Reúne los nombres del contenido de tu catálogo.
- Identifica las URLs canónicas del contenido. (Te recomendamos que uses el
url
del contenido como su@id
).