Toutes les entités de votre catalogue doivent inclure les propriétés suivantes:
@id
: identifiant global du contenu.url
: URL canonique du contenu.name
: nom du contenu.
Exemple de @id
, url
et name
:
"@id": "http://www.example.com/episode/video/432432432",
"url": "http://www.example.com/episode/video/432432432",
"name": "My example episode",
Identifiant
Un identifiant (@id
) doit respecter les conditions suivantes:
- Unique au niveau mondial dans l'ensemble de votre catalogue
- Par exemple, n'utilisez pas le même
@id
pour unTVSeries
et unTVSeason
.
- Par exemple, n'utilisez pas le même
- Statique
- Vous ne pourrez plus modifier
@id
par la suite.
- Vous ne pourrez plus modifier
- Au format URI (Uniform Resource Identifier)
- Si l'identifiant local (ID) de votre contenu n'est pas au format URI, ajoutez votre domaine à l'ID pour répondre à cette exigence. Par exemple, si l'ID de votre contenu est 1234abc et que votre domaine est https://example.com,
@id
peut être https://example.com/1234abc. @id
ne doit pas nécessairement être une URL fonctionnelle. Il doit simplement être au format URI.- Le domaine utilisé dans
@id
(par exemple, https://example.com) doit appartenir à votre organisation.
- Si l'identifiant local (ID) de votre contenu n'est pas au format URI, ajoutez votre domaine à l'ID pour répondre à cette exigence. Par exemple, si l'ID de votre contenu est 1234abc et que votre domaine est https://example.com,
Étant donné que l'url
d'une entité répond à toutes les exigences en tant qu'identifiant (c'est-à-dire qu'il est globalement unique, statique et au format d'un URI), nous vous recommandons d'utiliser l'url
d'une entité comme @id
.
URL canonique
Une URL canonique (url
) permet à Google de faire le rapprochement entre le contenu de votre catalogue et celui de ses bases de données.
"Une URL canonique est l'URL de la page considérée par Google comme la plus représentative de l'ensemble de pages en double sur votre site. Par exemple, si vous avez plusieurs URL pour une même page (par exemple, example.com?dress=1234 et example.com/dresses/1234), Google en choisit une comme URL canonique." (Source: Consolider les URL en double)
Voici les conditions requises pour l'URL canonique:
url
doit être unique.url
doit contenir une URL canonique fonctionnelle que Google peut explorer.- (Actions d'écoute uniquement)
url
doit rediriger vers une page de description de contenu qui n'est pas bloquée par un mur payant.
Collecter l'ID, l'URL et le nom
Procédez comme suit :
- Récupérez les noms des contenus de votre catalogue.
- Identifiez les URL canoniques du contenu. (Nous vous recommandons d'utiliser le
url
du contenu comme@id
.)