Eigenschaften von Inhalts-Markup von Musikplaylists

In diesem Abschnitt finden Sie Details zu den Inhalts-Markup-Properties für den Entitätstyp MusicPlaylist.

Tabelle mit Spezifikationen

Attribut Erwarteter Typ Beschreibung
@context Text Erforderlich: Muss immer auf ["http://schema.googleapis.com", {"@language": "xx"}] gesetzt sein.
  • Dabei steht „xx“ für die Sprache der Strings im Feed. Für jeden Stammentitätskontext sollte @language auf den entsprechenden Sprachcode im BCP 47-Format festgelegt sein. Wenn die Sprache beispielsweise auf Spanisch eingestellt ist, wird davon ausgegangen, dass die Namen auf Spanisch sind, auch wenn die Sprache der Untertitel oder Synchronisation Englisch ist.
@type Text Erforderlich: Für Mixe muss immer MusicPlaylist festgelegt werden.
@id URL Erforderlich: Die Kennung des Inhalts im URI-Format, z. B. https://example.com/1234abc.
@id muss die folgenden Anforderungen erfüllen:
  • Sie muss in Ihrem gesamten Katalog eindeutig sein.
  • Statisch: Die ID muss immer gleich bleiben und darf sich im Laufe der Zeit nicht ändern, auch wenn sich die URL-Eigenschaft der Sendung ändert. Sie wird als opaker String behandelt und muss kein funktionierender Link sein.
  • In Form eines Uniform Resource Identifiers (URI)
  • Die für den @id-Wert verwendete Domain muss Ihrer Organisation gehören.
Da die url einer Entität alle Anforderungen als Kennung erfüllt, empfehlen wir, die url einer Entität als @id zu verwenden. Weitere Informationen finden Sie im Abschnitt Kennung.
url URL Erforderlich: Die kanonische URL der Inhalte, anhand derer Google die Inhalte in Ihrem Feed mit den Inhalten in den Google-Datenbanken abgleicht.
url muss die folgenden Anforderungen erfüllen:
  • url muss global eindeutig sein
  • url muss eine funktionierende kanonische URL enthalten, die von Google gecrawlt werden kann.
  • url muss auf eine Seite mit einer Inhaltsbeschreibung verweisen, die nicht durch eine Paywall blockiert ist.
Den Deeplink für die Wiedergabe findest du stattdessen im Attribut urlTemplate des Ziel-Objekts.
name Text Erforderlich: Der Name der Playlist, z. B. „Funky Jazz Mix“.
genre Text Erforderlich, wenn die Playlist ein Genre-Mix ist: Eine Liste von Keywords, die für das Genre der Playlist spezifisch sind. Wenn dieses Attribut vorhanden ist, weiß Google, dass es sich bei dieser Playlist um eine Genre-Playlist handelt.
numTracks Ganzzahl Erforderlich, wenn es sich bei der Playlist um einen kuratierten Mix handelt: Die Anzahl der Titel in der Playlist. Durch diese Property wird Google mitgeteilt, dass diese Playlist von Hand zusammengestellt wurde. Wenn dieses Attribut nicht vorhanden ist, ist die Playlist eine endlose, automatisch erstellte Playlist.
potentialAction ListenAction Erforderlich: Ein Aktions-Markup-Objekt mit den Details zur Aktion. Weitere Informationen finden Sie unter Eigenschaften für das Aktions-Markup.
image ImageObject Ein Playlist-Bild, das die Playlist oder den Musikmix repräsentiert. Weitere Informationen finden Sie unter Bild-Markup-Attribute.
creator Organisation oder Person Empfohlen, wenn der Creator von großem Interesse ist. Verwenden Sie diese Property, um die Playlists anzugeben, die mit Ihrem Dienst erstellt wurden (Typ Organisation mit der Property name für Ihren Dienst) oder einen Nutzer mit hohem Interesse an Ihrem Dienst (Typ Person mit der Property name für den Nutzer mit hohem Interesse).
keywords Text Eine Liste mit Keywords („Rock“, „Pop“), Stimmungen („fröhlich“, „launisch“), Aktivitäten („Sport“, „Entspannung“) oder anderen Begriffen, die sich auf die Playlist beziehen.
description Text Eine kurze Beschreibung der Playlist. Die maximale Zeichenanzahl beträgt 300.
isFamilyFriendly Boolesch Gibt an, ob diese Inhalte familienfreundlich sind, d. h. für alle Familienmitglieder geeignet, einschließlich Kindern. In Google-Produkten wird isFamilyFriendly möglicherweise verwendet, um zu bestimmen, welcher Song abgespielt werden soll.
popularityScore PopularityScoreSpecification Empfohlen Warum? Ein Wert, der von Google zusammen mit anderen Signalen verwendet wird, um zu bestimmen, welche Medien für Nutzer wiedergegeben werden. Dieser Wert gibt die Beliebtheit der Inhalte im Vergleich zu anderen Inhalten in deinem Katalog an. Daher muss die Skala für die Bewertung in allen Feeds und für alle Entitäten in deinem Katalog einheitlich sein. Standardmäßig ist der Beliebtheitswert einer Entität auf 0 gesetzt.
popularityScore.@type Text Immer auf PopularityScoreSpecification gesetzt.
popularityScore.value Number Ein nicht negativer numerischer Wert, der die Beliebtheit des Elements angibt. Je höher der Wert, desto beliebter ist das Element.
popularityScore.eligibleRegion Land Regionen, in denen dieser Beliebtheitsrang gilt. Wenn der Beliebtheitsfaktor global gilt, legen Sie EARTH fest. Standardmäßig ist diese Eigenschaft auf EARTH eingestellt.
Note: Die länderspezifische Beliebtheit hat Vorrang vor der globalen Beliebtheit (EARTH)

Beispiel

Beispiel für eine von Hand zusammengestellte Playlist mit Popsongs aus den 2010er-Jahren:

{
  "@context":["http://schema.googleapis.com/", {"@language": "en"}],
  "@type":"MusicPlaylist",
  "@id":"http://www.example.com/playlist/top-pop-songs/",
  "url":"http://www.example.com/playlist/top-pop-songs/",
  "name":"Top Pop Songs of the 2010s",
  "image":[
  {
    "@type": "ImageObject",
    "contentUrl" : "http://www.example.com/playlist/top-pop-songs/1x1/photo1.jpg",
    "dateModified" : "2018-01-05T22:11:33+00:00",
    "regionsAllowed" : ["US","UK","MX"]
  },
  {
    "@type": "ImageObject",
    "contentUrl" : "http://www.example.com/playlist/top-pop-songs/1x1/photo2.jpg",
    "dateModified" : "2018-01-05T22:11:33+00:00",
    "regionsAllowed" : ["UA", "IR"]
  }],
  "genre": [
     "pop",
     "2010s"
  ],
  "numTracks":"46",
  "potentialAction":{
    "@type":"ListenAction",
    "target":[
      {
        "@type":"EntryPoint",
        "urlTemplate":"http://www.example.com/playlist/top-pop-songs?autoplay=true",
        "actionPlatform":[
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/IOSPlatform",
          "http://schema.org/AndroidPlatform",
          "http://schema.org/AndroidTVPlatform",
          "http://schema.googleapis.com/GoogleAudioCast",
          "http://schema.googleapis.com/GoogleVideoCast"
        ]
      },
      {
        "@type": "EntryPoint",
        "urlTemplate": "android-app://com.app.example/playlist/top-pop-songs?autoplay=true",
        "actionPlatform": "http://schema.org/AndroidPlatform"
      }
    ],
    "expectsAcceptanceOf":{
      "@type":"Offer",
      "category":"free",
      "eligibleRegion": {
        "@type":"Country",
        "name":"US"
      }
    }
  },
  "creator": {
    "@type": "Organization",
    "name": "example.com"
  },
  "keywords": [
    "pop",
    "Party music"
  ],
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 78,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "CA"
      }
    ]
  },
  "description":"Top pop songs from the last decade."
}

Auf den folgenden Seiten finden Sie Informationen zu diesen Properties: