Die plattformspezifischen Deeplinks Ihrer Inhalte identifizieren

Wenn ein Nutzer Media Actions für Inhalte auslöst (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 die Deeplinks gelten die folgenden Anforderungen:

• urlTemplate (eines Zielobjekts) erfordert einen Deeplink.
• Deeplinks müssen die Inhalte, auf die sie verweisen, auf allen angegebenen Plattformen öffnen.
• 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 Ihrer App oder auf Ihrer 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 mit 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

Damit das gewünschte Wiedergabeverhalten erreicht wird, müssen die folgenden plattformspezifischen Anforderungen erfüllt sein:

iOS

Sie müssen universelle Links verwenden.

Android und Android TV

Sie können entweder Android-App-Links oder Links mit benutzerdefiniertem Schema verwenden.

Links zu benutzerdefinierten Schemas für Android und Android TV

Auf Android- und Android TV-Geräten können Sie auch Links mit benutzerdefinierten Schemas verwenden. Die package_id Ihrer App muss in der benutzerdefinierten Schema-URI enthalten sein. So wird der Nutzer zur Seite Ihrer App im Google Play Store weitergeleitet, wenn Ihre App nicht installiert ist. Daher sind die folgenden URI-Formate die einzigen akzeptablen benutzerdefinierten Schemata für Media Actions:

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 das folgende Beispiel, sind für Media Actions nicht zulässig:

scheme://{path}

Beispiel:

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

Best Practices

Wenn Ihre App nicht installiert ist und Sie keinen Webplayer haben, konfigurieren Sie Ihren Webserver so, dass der Nutzer automatisch zum Android- oder App Store weitergeleitet wird, um Ihre App zu installieren. Verwenden Sie für die Weiterleitung Firebase Dynamic Links oder Smartlink-Plattformen von Drittanbietern.

Wenn Ihre App nicht installiert ist und Sie einen Webplayer haben, stellen Sie einen Link oder ein Smart-Banner zum Android- oder App-Store bereit, damit Nutzer Ihre App installieren können. Das folgende Beispiel zeigt 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:

Plattformtypen

Damit Ihre Inhalte auf den verschiedenen Google-Plattformen verfügbar sind, die Media Actions unterstützen, müssen Sie die folgenden Anforderungen erfüllen:

• Für alle von Partnern unterstützten Plattformen ist ein Deeplink für Ihre Inhalte erforderlich.
• Für Chromecast-Plattformen müssen Sie einen Receiver mit dem neuesten Cast Application Framework (CAF) Receiver SDK erstellen.
• Informationen zu den Anforderungen für mobile Plattformen (Android und iOS) finden Sie im Abschnitt Wiedergabe mit Deeplinks starten.

In der folgenden Tabelle finden Sie eine Liste der Plattformen, die Media Actions unterstützen:

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

Bei den meisten Inhalten muss die ausgewählte Wiedergabe automatisch gestartet werden, wenn Google Nutzer zu Ihrer App oder Plattform weiterleitet. So können Nutzer schnell mit dem Ansehen oder Anhören der Inhalte beginnen.

Wiedergabeverhalten von Wiedergabeaktionen

Für Watch Actions ist das folgende Wiedergabeverhalten erforderlich.

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

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

• Wiedergabe:Wenn dein Dienst den Status eines Nutzers verfolgt, muss die Wiedergabe ab der vorherigen Markierung des Nutzers im Film oder in der Folge beginnen. Andernfalls muss die Wiedergabe am Anfang der Inhalte beginnen.

• Automatische Wiedergabe:Je nach Plattform muss Ihr Dienst die Inhalte nach der Auswahl der Ziel-Episode oder des Ziel-Films durch den Nutzer deutlich wiedergeben.

  • 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 wiedergegeben werden, nachdem der Nutzer zu Ihrer App oder Ihrem Dienst weitergeleitet wurde.
  • Android TV:Die automatische Wiedergabe ist für Filme und Folgen erforderlich.

Nur Deeplinks für TVSeries und TVSeason

• Auswahl der Ziel-Episode:Sie müssen die richtige Ziel-Episode auswählen. Wenn Ihr Dienst den Status eines Nutzers verfolgt, muss die Ziel-Episode die Episode sein, die der Nutzer zuletzt angesehen hat. Wenn der Nutzer die zuletzt angesehene Folge vollständig angesehen hat, wähle stattdessen die nächste Folge als Ziel aus. Andernfalls muss die Ziel-Episode nach Ihrem Ermessen eine der folgenden sein:

  • TVSeries
    • Die erste Folge der Serie. Empfohlen für Serien.
    • Die erste Folge der neuesten Staffel. Empfohlen für Serien mit vielen Folgen.
    • 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 (unveränderlich) sein und zur Zielfolge führen. Verwenden Sie den Deeplink nicht für eine bestimmte Folge.

  In der folgenden Tabelle finden Sie einige Beispiele für die erforderliche Logik zur Auswahl der Ziel-Episoden für die Entitätstypen TVSeries, TVSeason und TVEpisode:

  	Zielfolge, wenn der Nutzer zuletzt S6E24 angesehen hat	Folge ausrichten, wenn der Nutzer noch keine Folgen angesehen hat
  Deeplink zur Serie	S6E24 (wenn der Nutzer S6E24 noch nicht abgeschlossen hat) S6E25 (wenn der Nutzer S6E24 fertig angesehen hat)	Eines der folgenden Betriebssysteme: Erste Folge der Serie Erste Folge der neuesten Staffel Neueste Folge
  Deeplink zur Staffel (S1–S5)	Die Folge, die der Nutzer in dieser Staffel zuletzt angesehen hat, oder die erste Folge der Staffel, wenn der Nutzer noch keine Folgen in dieser Staffel angesehen hat.	Erste Folge der Staffel
  Deeplink zur Staffel (S6)	S6E24 (wenn der Nutzer S6E24 noch nicht abgeschlossen hat) S6E25 (wenn der Nutzer S6E24 fertig angesehen hat)	Eines der folgenden Betriebssysteme: Erste Folge der Staffel Neueste Folge
  Deeplink zur Folge	Die angeklickte Folge.	Die angeklickte Folge.

Wiedergabeverhalten bei Listen Actions

Für Listenaktionen ist das folgende Wiedergabeverhalten erforderlich:

• 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 sofort oder mit nur einem Klick nach der Anmeldung 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 Interpreten oder die gewünschte Playlist abzuspielen.
  • Wenn Nutzer nicht berechtigt sind, die jeweiligen Inhalte abzuspielen (z. B. weil sie nicht das erforderliche Abo haben), muss Ihr Dienst erklären, was sie tun müssen, um berechtigt zu werden, wenn sie Ihre App oder Plattform aufrufen.

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

• Für MusicGroup soll jedes Mal, wenn ein Nutzer den Künstler auswählt, ein anderer Inhalt des Künstlers wiedergegeben werden.
• Bei MusicAlbum werden Inhalte in der Reihenfolge ihrer Darstellung im Album wiedergegeben.
• Bei MusicPlaylist werden jedes Mal, wenn ein Nutzer die Playlist auswählt, unterschiedliche Inhalte aus der Playlist wiedergegeben.

Deeplinks identifizieren

Gehen Sie dazu so vor:

1. Prüfen Sie für jeden Inhalt, ob es je nach Plattform unterschiedliche Deeplinks gibt.
2. Stellen Sie für jeden Deeplink die folgenden Fragen zum 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?
   • Werden im Einstiegspunkt mehrere Videoformate unterstützt?

Wenn Sie eine dieser Fragen mit „Ja“ beantworten, müssen Sie die additionalProperty-Property für diesen Deeplink angeben. additionalProperty