ID, URL und Name der Inhalte erfassen

Inhaltsentitäten in Ihrem Katalog erfordern in der Regel die folgenden Properties:

  • @id: Eine globale Kennung für die Entität.
  • url: Eine kanonische URL für den Inhalt. Verwenden Sie url nicht für BroadcastEvent-, SportsEvent- oder Kanalaufstellungsentitäten (TelevisionChannel und CableOrSatelliteService).
  • name: Der Name des Inhalts.

Beispiel für @id, url und name:

"@id": "http://www.example.com/episode/video/432432432",
"url": "http://www.example.com/episode/video/432432432",
"name": "My example episode",

ID

Eine Kennung (@id) muss die folgenden Anforderungen erfüllen:

  • Global eindeutig in Ihrem Katalog
    • Verwenden Sie beispielsweise nicht dieselbe @id für ein TVSeries und ein TVSeason.
  • Statisch
    • Sie können @id später nicht mehr ändern.
  • In Form eines Unified Resource Identifier (URI)
    • Wenn die lokale ID Ihres Inhalts nicht im URI-Format vorliegt, stellen Sie der ID Ihre Domain voran, um diese Anforderung zu erfüllen. Wenn die ID Ihres Inhalts beispielsweise 1234abc und Ihre Domain https://example.com lautet, kann @id https://example.com/1234abc sein.
    • @id muss keine funktionierende URL sein, sondern nur im URI-Format vorliegen.
    • Die in @id verwendete Domain (z. B. https://beispiel.de) muss Ihrer Organisation gehören.

Da die url einer Entität alle Anforderungen an eine Kennung erfüllt (d. h. global eindeutig, statisch und in Form eines URI), empfehlen wir, die url einer Entität als @id zu verwenden.

Kanonische URL

Eine kanonische URL (url) hilft Google, die Inhalte in Ihrem Katalog genau mit den Inhalten in den Google-Datenbanken abzugleichen.

„Eine kanonische URL ist die URL der Seite, von der Google annimmt, dass sie die repräsentativste von mehreren duplizierten Seiten auf deiner Website ist. Wenn du beispielsweise mehrere URLs für dieselbe Seite hast, z. B. beispiel.de?kleid=1234 und beispiel.de/kleider/1234, wählt Google eine davon als kanonische URL aus.“ (Quelle: Doppelte URLs zusammenfassen)

Für die kanonische URL gelten die folgenden Anforderungen:

  • url muss global eindeutig sein.
  • url muss eine funktionierende kanonische URL enthalten, die von Google gecrawlt werden kann.
  • (Nur Listen Actions) url muss auf eine Seite mit einer Inhaltsbeschreibung verweisen, die nicht durch eine Paywall blockiert ist.
  • (Live-TV) Verwende keine url-Entitäten für BroadcastEvent-Entitäten. Gib für TV- und Filmübertragungen url für die zugrunde liegende Movie-, TVSeries- oder TVEpisode-Entität an.
  • (Sport) Verwende keine url für SportsEvent-Entitäten. Geben Sie Wiedergabelinks mit SportsEvent.potentialAction an.
  • (Live-TV und Sport) Achte darauf, dass sich die BroadcastEvent.@id von der @id der referenzierten Movie-, TVSeries-, TVEpisode- oder SportsEvent-Entität unterscheidet.

ID, URL und Name erfassen

Gehen Sie dazu so vor:

  1. Sammeln Sie die Namen der Inhalte in Ihrem Katalog.
  2. Ermitteln Sie die kanonischen URLs der Inhalte. (Wir empfehlen, die url des Inhalts als @id zu verwenden.)