Die plattformspezifischen Deeplinks Ihrer Inhalte identifizieren

Wenn ein Nutzer Medienaktionen für Inhalte initiiert, z. B. wenn er in der Google Suche auf Ihr Symbol klickt, leitet Google ihn über den Deeplink des Inhalts direkt zu den Inhalten in Ihrer App oder auf Ihrer Plattform weiter.

Für Deeplinks gelten folgende Anforderungen:

  • urlTemplate (eines Zielobjekts) erfordert einen Deeplink.
  • Über Deeplinks müssen die Inhalte, auf die sie ausgerichtet sind, auf allen angegebenen Plattformen geöffnet werden.
  • Deeplinks können Parameter (&) oder Anker-Tags (#) enthalten. <ph type="x-smartling-placeholder">

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",
       ...
     },
   ...
   },
   ...
}

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

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

Beachten Sie für das gewünschte Wiedergabeverhalten Folgendes: plattformspezifischen Anforderungen:

iOS
Sie müssen universelle Links verwenden.
Android und Android TV
Sie können entweder Android-App-Links verwenden oder Links für benutzerdefinierte Schemas.

Unter Android und Android TV können Sie auch Links für benutzerdefinierte Schemas verwenden. Der package_id muss im URI für das benutzerdefinierte Schema enthalten sein. Dadurch wird sichergestellt, 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 Formate für benutzerdefinierte Schemas. für Aktionen für Medien:

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 nicht zulässig Schema-Links für Media Actions:

scheme://{path}

Beispiel:

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

Best Practices

Falls Ihre App nicht installiert ist und Sie keinen Webplayer haben: Ihren Webserver so konfigurieren, dass der Nutzer automatisch an die Android oder App Store, um deine App zu installieren. Verwenden Sie für die Weiterleitung dynamische Firebase-Links oder Smart-Link-Plattformen von Drittanbietern verwenden.

Falls Ihre App nicht installiert ist und Sie einen Webplayer haben, einen Link oder Smart-Banner zum Android- oder App-Shop bereitstellen, damit Nutzer um Ihre App zu installieren. Hier sehen Sie ein Beispiel für ein implementiertes Smart-Banner:

Beispiel für ein implementiertes Smart-Banner

Die folgende Tabelle enthält die Anforderungen und Einschränkungen für Deeplinks gelten für iOS, Android und AndroidTV:

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

Plattformtypen

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

Die folgende Tabelle enthält eine Liste der Plattformen, die Medienaktionen unterstützen:

Plattform Beschreibung
http://schema.org/DesktopWebPlatform Suchplattform im Webbrowser eines Computers.
http://schema.org/MobileWebPlatform Suchplattform in einem mobilen Webbrowser.
http://schema.org/AndroidPlatform Suche 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 Streaming- und Home-Plattform auf einem Chromecast-Gerät.
http://schema.googleapis.com/GoogleAudioCast Nur Audioaktionen: Streaming- und Home-Plattform 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 Google Nutzer zu Ihrer App oder Plattform weiterleitet, benötigen wir für die meisten Inhalte um den ausgewählten Inhalt automatisch wiederzugeben. So können Nutzende schnell mit der das Ansehen oder Anhören von Inhalten.

Wiedergabeverhalten der Smartwatch-Aktionen

Für Wiedergabeaktionen ist das folgende Wiedergabeverhalten erforderlich.

Alle Deeplinks: Film, TV-Folge, TV-Serie und TV-Staffel

  • Anmelde- oder Kaufverhalten:Wenn für den Dienst eine Anmeldung oder muss der Film oder die Folge eingeben. Weitere Informationen finden Sie in den Richtlinien zu Deeplinks folgen.

  • Wiedergabe:Wenn Ihr Dienst den Status eines Nutzers erfasst, muss die Wiedergabe an Die vorherige Markierung des Nutzers für den Film oder die Folge Andernfalls muss die Wiedergabe beginnen Sie am Anfang.

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

    • Suchanzeigen:Autoplay wird dringend empfohlen, ist aber nicht erforderlich. Wenn Autoplay nicht unterstützt wird, muss der Inhalt mit einem Klick wiedergegeben werden, nachdem der Nutzer zu Ihrer App oder Ihrem Dienst weitergeleitet wurde.
    • Android TV:Für Filme und Folgen ist Autoplay erforderlich.

Nur Deeplinks für TVSeries und TVSeason

  • Auswahl der Zielfolge:Sie müssen die richtige Folge auswählen. Wenn der Status eines Nutzers erfasst, muss die Zielfolge die Folge sein die der Nutzer zuletzt angehalten hat. Oder wenn die Nutzenden den Vorgang Folge, die sie sich zuletzt angesehen haben, die Zielfolge zur nachfolgenden . Andernfalls muss die Zielfolge eine der folgenden sein: nach eigenem Ermessen:

    • TVSeries
      • Die erste Folge der Serie. Empfohlen für serialisierte Serien.
      • Die erste Folge der neuesten Staffel. Empfohlen für Serien mit langer Ausführungszeit.
      • Die neueste Folge. Empfohlen für tägliche oder nachrichtenbezogene Sendungen.
    • TVSeason
      • Die erste Folge der Staffel. Empfohlen für serialisierte Serien.
      • Die neueste Folge. Empfohlen für tägliche oder nachrichtenbezogene Sendungen.

    Ein Deeplink für TVSeries oder TVSeason muss statisch sein (sich nicht ändern). bis zur gewünschten Folge. Verwenden Sie den Deeplink nicht für einer bestimmten Folge

    Die folgende Tabelle enthält mehrere Beispiele, die die erforderlichen Logik zur Auswahl der Zielfolge für TVSeries, TVSeason und TVEpisode Entitätstypen:

    Ausrichtung auf Folge, wenn der Nutzer zuletzt S6E24 angesehen hat Ausrichtung auf Folge, wenn der Nutzer noch keine Folgen angesehen hat
    Deeplink für Buchreihe
    • S6E24 (wenn der Nutzer S6E24 noch nicht beendet hat)
    • S6E25 (wenn der Nutzer die Wiedergabe von S6E24 beendet hat)

    Eines der folgenden Betriebssysteme:

    • Erste Folge der Serie
    • Erste Folge der neuesten Staffel
    • Neueste Folge
    Deeplink der Staffel (S1-S5)
    • Die Folge, die sich der Nutzer in dieser Staffel zuletzt angesehen hat, der ersten Folge der Staffel, wenn der Nutzer dieser Staffel verfügbar.
    • Erste Folge der Staffel
    Deeplink der Staffel (S6)
    • S6E24 (wenn der Nutzer S6E24 noch nicht beendet hat)
    • S6E25 (wenn der Nutzer die Wiedergabe von S6E24 beendet hat)

    Eines der folgenden Betriebssysteme:

    • Erste Folge der Staffel
    • Neueste Folge
    Deeplink für Folgen
    • Die angeklickte Folge.
    • Die angeklickte Folge.

Wiedergabeverhalten bei Aktionen für „Anhören“

Für Anhöraktionen ist das folgende Wiedergabeverhalten erforderlich:

  • Inhalte müssen mit einem Klick 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, genau den Titel, das Album, den Künstler oder die Playlist wiederzugeben.
    • Wenn Nutzer nicht den exakten Inhalt wiedergeben können, weil sie z. B. nicht über das erforderliche Abo verfügen, muss in Ihrem Dienst erklärt werden, was der Nutzer tun muss, damit er beim Aufrufen Ihrer App oder Plattform die entsprechenden Inhalte wiedergeben kann.

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

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

Gehen Sie so vor:

  1. Prüfen Sie für jeden Inhalt, ob er je nach Plattform unterschiedliche Deeplinks hat.
  2. Stellen Sie für jeden Deeplink die folgenden Fragen zu seinem Einstiegspunkt, also der Seite in Ihrer App oder auf Ihrer Plattform, zu der Sie über den Deeplink gelangen: <ph type="x-smartling-placeholder">
      </ph>
    • 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“ beantworten können, müssen Sie die Property additionalProperty für diesen Deeplink angeben. Sehen Sie sich das Beispiel additionalProperty an.

Zurück
Metadaten erfassen
Weiter
Zugriffsanforderung ermitteln