Die plattformspezifischen Deeplinks Ihrer Inhalte identifizieren

Wenn ein Nutzer Aktionen für Medien auf Inhalte ausführt (z. B. auf Ihr Symbol in der Google Suche klickt), leitet Google ihn über den Deeplink des Inhalts direkt zu den Inhalten in Ihrer App oder auf Ihrer Plattform weiter.

Deeplink

Für Deeplinks gelten die folgenden Anforderungen:

• urlTemplate (eines Zielobjekts) erfordert einen Deeplink.
• Über Deeplinks müssen die Inhalte auf allen angegebenen Plattformen geöffnet werden.
• Deeplinks können Parameter (&) oder Anker-Tags (#) enthalten.
  • Wenn Autoplay nicht standardmäßig aktiviert ist, empfehlen wir, dem Deeplink einen Parameter wie &autoplay=true hinzuzufügen, um die Autoplay-Funktion in deiner App oder auf deiner Plattform zu aktivieren.

Beispiel für @id, url und urlTemplate:

{
   "@context": ["http://schema.org", {"@language": "en"}],
   "@type": "Movie",
   "@id": "http://www.example.com/my_favorite_movie",
   "url": "http://www.example.com/my_favorite_movie",
   "name": "My Favorite Movie",
   "potentialAction": {
     "@type": "WatchAction",
     "target": {
       "@type": "EntryPoint",
       "urlTemplate": "http://www.example.com/my_favorite_movie&autoplay=true",
       ...
     },
   ...
   },
   ...
}

Wiedergabe über Deeplinks starten

Der folgende Pseudocode stellt das gewünschte Verhalten dar, wenn ein Nutzer die Wiedergabe startet:

if your app is installed
  open app and initiate playback
elseif your website supports playback
  open your website and initiate playback
else
  take user to your app's install page on the Play or App store and then
  initiate playback after your app is installed

Beachte die folgenden plattformspezifischen Anforderungen, um das gewünschte Wiedergabeverhalten zu erzielen:

iOS

Sie müssen universelle Links verwenden.

Android und Android TV

Sie können entweder Android-App-Links oder Links für benutzerdefinierte Schemas verwenden.

Ziel :Sowohl universelle iOS-Links als auch Android-App-Links können so konfiguriert werden, dass Nutzer zur App weitergeleitet werden, wenn sie installiert ist, oder zur Website, wenn sie nicht installiert ist. Wenn Ihr Dienst keinen webbasierten Player hat, konfigurieren Sie Ihren Webserver so, dass Nutzer automatisch zum entsprechenden Store weitergeleitet werden, um Ihre App zu installieren.

Benutzerdefinierte Schema-Links für Android und Android TV

Auf Android- und Android TV-Geräten können Sie auch benutzerdefinierte Schemalinks verwenden. Die package_id Ihrer App muss im URI des benutzerdefinierten Symbols enthalten sein. So wird der Nutzer zur Seite Ihrer App im Play Store weitergeleitet, wenn Ihre App nicht installiert ist. Daher sind die folgenden URI-Formate die einzigen zulässigen benutzerdefinierten Schemaformate für Media-Aktionen:

android-app://{package_id}/{scheme}/{path}

Beispiel:

android-app://com.partner.mynetworkapp/mynetwork/play?series=20114&title=21141&media=e90c89fa4

Weitere Informationen finden Sie in der vollständigen Spezifikation.

intent://{package_id}/{scheme}/{path}

Beispiel:

intent://com.partner.mynetworkapp/mynetwork/play?series=20114&title=21141&media=e90c89fa4

Andere URI-Formate wie im folgenden Beispiel sind keine zulässigen Links mit benutzerdefiniertem Schema für Media-Aktionen:

scheme://{path}

Beispiel:

mynetwork://play?series=20114&title=21141&media=e90c89fa4

Best Practices

Wenn deine App nicht installiert ist und du keinen Webplayer hast, konfiguriere deinen Webserver so, dass Nutzer automatisch zum Google Play Store oder App Store weitergeleitet werden, um deine App zu installieren. Verwende dazu Firebase-dynamische Links oder Smartlink-Plattformen von Drittanbietern.

Wenn deine App nicht installiert ist und du einen Webplayer hast, stelle einen Link oder ein Smart Banner zum Google Play Store oder App Store bereit, damit Nutzer deine App installieren können. Unten siehst du ein Beispiel für ein implementiertes Smart Banner:

Zusammenfassung der Anforderungen und Einschränkungen für Deeplinks

In der folgenden Tabelle sind die Anforderungen und Einschränkungen für Deeplinks für iOS, Android und Android TV aufgeführt:

	iOS	Android und Android TV
http:// oder https://	Erforderlich	Empfohlen, wenn die Wiedergabe auf der mobilen Website unterstützt wird.
android-app:// oder intent://	–	Empfohlen, wenn die Wiedergabe auf der mobilen Website nicht unterstützt wird.
foo:// (beliebiger String)	Nicht zulässig	Nicht zulässig

Plattformtypen

Damit Ihre Inhalte auf den verschiedenen Plattformen von Google (Suche, Assistant, Android TV und Chromecast) verfügbar sind, müssen Sie die folgenden Anforderungen erfüllen:

• Für alle von Partnern unterstützten Plattformen ist ein Deeplink für deine Inhalte erforderlich.
• Für Chromecast-Plattformen müssen Sie einen Empfänger mit dem neuesten CAF Receiver SDK (Cast Application Framework) erstellen.
• Für mobile Plattformen (Android und iOS) findest du die Anforderungen im Abschnitt Wiedergabe über Deeplinks starten.

In der folgenden Tabelle sind die Plattformen aufgeführt, auf denen Media-Aktionen unterstützt werden:

Plattform	Beschreibung
http://schema.org/DesktopWebPlatform	Suchplattform in einem Desktop-Webbrowser
http://schema.org/MobileWebPlatform	Suchplattform in einem mobilen Webbrowser
http://schema.org/AndroidPlatform	Such- und PlayGuide-Plattformen in der Android-App
http://schema.org/AndroidTVPlatform	Android TV-Plattform in der Android TV App
http://schema.org/IOSPlatform	Suchplattform in der iOS-App
http://schema.googleapis.com/GoogleVideoCast	Cast- und Home-Plattformen auf einem Chromecast-Gerät
http://schema.googleapis.com/GoogleAudioCast	Nur Anhör-Aktionen Cast- und Home-Plattformen auf einem Chromecast-Gerät

Beispiel für eine Entität mit zwei verschiedenen Deeplinks:

"potentialAction": {
  "@type": "WatchAction",
  "target": [
    {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/standardView",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform"
      ]
    },
    {
      "@type":"EntryPoint",
      "urlTemplate":"http://example.com/multipleViews",
      "actionPlatform": [
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ],
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "videoFormat",
          "value": [ "HD", "4K" ]
        }
      ],
    }
  ],
  ...
}

Wiedergabeverhalten

Wenn Nutzer von Google zu Ihrer App oder Plattform weitergeleitet werden, müssen die ausgewählten Inhalte in den meisten Fällen automatisch wiedergegeben werden. So können Nutzer die Inhalte schnell ansehen oder anhören.

Wiedergabeverhalten von Anseh-Aktionen

Für Wiedergabeaktionen ist das folgende Wiedergabeverhalten erforderlich.

Alle Deeplinks: „Movie“, „TVEpisode“, „TVSeries“ und „TVSeason“

• Anmelde- oder Kaufverhalten:Wenn für deinen Dienst eine Anmeldung oder ein Kauf erforderlich ist, muss der Film oder die Folge danach entsprechend dem jeweiligen Typ abgespielt werden. Weitere Informationen finden Sie in den folgenden Deeplink-Richtlinien.

• Wiedergabe:Wenn dein Dienst den Status eines Nutzers erfasst, muss die Wiedergabe an der vorherigen Markierung des Nutzers im Film oder in der Folge beginnen. Andernfalls muss die Wiedergabe vom Anfang der Inhalte aus gestartet werden.

• Autoplay:Je nach Plattform muss dein Dienst die Inhalte gut sichtbar abspielen, nachdem der Nutzer die gewünschte Folge oder den gewünschten Film ausgewählt hat.

  • Suche:Die automatische Wiedergabe wird dringend empfohlen, ist aber nicht erforderlich. Wenn die automatische Wiedergabe nicht unterstützt wird, müssen die Inhalte innerhalb eines Klicks nach der Weiterleitung des Nutzers zu Ihrer App oder Ihrem Dienst wiedergegeben werden.
  • Android TV:Autoplay ist für Filme und Folgen erforderlich.

Nur Deeplinks für TVSeries und TVSeason

• Ziel-Folge auswählen:Du musst die richtige Ziel-Folge auswählen. Wenn dein Dienst den Status eines Nutzers erfasst, muss die Zielfolge die Folge sein, die der Nutzer zuletzt pausiert hat. Wenn der Nutzer die letzte Folge, die er sich angesehen hat, bis zum Ende angesehen hat, kannst du als Zielfolge stattdessen die nächste Folge festlegen. Andernfalls muss die Zielfolge eine der folgenden sein:

  • TVSeries
    • Die erste Folge der Serie. Empfohlen für Serien.
    • Die erste Folge der aktuellen Staffel. Empfohlen für langlebige Serien.
    • Die neueste Folge. Empfohlen für tägliche oder nachrichtenbezogene Sendungen.
  • TVSeason
    • Die erste Folge der Staffel. Empfohlen für Serien.
    • Die neueste Folge. Empfohlen für tägliche oder nachrichtenbezogene Sendungen.

  Ein Deeplink für TVSeries oder TVSeason muss statisch (d. h. unveränderlich) sein und auf die Zielfolge verweisen. Verwende den Deeplink nicht für eine bestimmte Folge.

  In der folgenden Tabelle findest du mehrere Beispiele für die erforderliche Logik zur Auswahl der Zielfolge für die Entitätstypen TVSeries, TVSeason und TVEpisode:

  	Zielfolge, wenn sich der Nutzer zuletzt Folge 24 der 6. Staffel angesehen hat	Zielfolge, wenn sich der Nutzer noch keine Folgen angesehen hat
  Deeplink zur Serie	S6E24 (wenn der Nutzer S6E24 noch nicht angesehen hat) S6E25 (wenn sich der Nutzer S6E24 angesehen hat)	Eines der folgenden Betriebssysteme: Erste Folge der Serie Erste Folge der aktuellen Staffel Neueste Folge
  Deeplink zur Staffel (S1–S5)	Die Folge, die sich der Nutzer in dieser Staffel zuletzt angesehen hat, oder die erste Folge der Staffel, wenn sich der Nutzer in dieser Staffel noch keine Folgen angesehen hat.	Erste Folge der Staffel
  Deeplink zur Staffel (S6)	S6E24 (wenn der Nutzer S6E24 noch nicht angesehen hat) S6E25 (wenn sich der Nutzer S6E24 angesehen hat)	Eines der folgenden Betriebssysteme: Erste Folge der Staffel Neueste Folge
  Deeplink zur Folge	Die bestimmte Folge, auf die geklickt wurde.	Die bestimmte Folge, auf die geklickt wurde.

Wiedergabeverhalten von Anhör-Aktionen

Für Wiedergabeaktionen ist das folgende Wiedergabeverhalten erforderlich:

• Die Inhalte müssen innerhalb eines Klicks wiedergegeben werden, nachdem der Nutzer zu Ihrer App oder Ihrem Dienst weitergeleitet wurde.
• Wenn für Ihre App oder Plattform eine Anmeldung erforderlich ist, müssen die Inhalte nach der Anmeldung sofort oder mit nur einem Klick wiedergegeben werden.
• Ihre App oder Plattform muss allen Nutzern mindestens eine Möglichkeit bieten, den gewünschten Titel, das gewünschte Album, den gewünschten Künstler oder die gewünschte Playlist abzuspielen.
  • Wenn Nutzer die gewünschten Inhalte nicht abspielen können (z. B. weil sie kein Abo haben), muss in Ihrem Dienst erklärt werden, was sie tun müssen, um die gewünschten Inhalte abspielen zu können.

Wir empfehlen die folgenden Best Practices für Ihre App oder Plattform:

• Bei MusicGroup werden jedes Mal, wenn ein Nutzer den Künstler auswählt, andere Inhalte des Künstlers wiedergegeben.
• Bei MusicAlbum werden Inhalte in der Reihenfolge abgespielt, in der sie im Album angezeigt werden.
• Bei MusicPlaylist werden jedes Mal, wenn ein Nutzer die Playlist auswählt, andere Inhalte aus der Playlist abgespielt.

Deeplinks identifizieren

Gehen Sie dazu so vor:

1. Prüfe für jeden Inhalt, ob es je nach Plattform unterschiedliche Deeplinks gibt.
2. Stellen Sie sich für jeden Deeplink die folgenden Fragen zu seinem Einstiegspunkt (der Seite in Ihrer App oder auf Ihrer Plattform, zu der der Deeplink führt):
   • Unterstützt der Einstiegspunkt (nicht der Inhalt) mehrere Sprachen?
   • Unterstützt der Einstiegspunkt mehrere Untertitelsprachen?
   • Unterstützt der Einstiegspunkt mehrere Kamerawinkel?
   • Unterstützt der Einstiegspunkt mehrere Videoformate?

Wenn Sie eine dieser Fragen mit „Ja“ beantwortet haben, müssen Sie für diesen Deeplink die Property additionalProperty angeben. Weitere Informationen finden Sie im Beispiel für additionalProperty.