Identyfikowanie precyzyjnych linków na określonej platformie do Twoich treści

Gdy użytkownik zainicjuje działania związane z multimediami w przypadku treści (np. kliknie ikonę w wyszukiwarce Google), Google przekieruje go bezpośrednio do treści w Twojej aplikacji lub na platformie za pomocą precyzyjnego linku.

Precyzyjne linki muszą spełniać te wymagania:

  • urlTemplate (obiektu docelowego) wymaga precyzyjnego linku.
  • Precyzyjne linki muszą otwierać treści, na które są kierowane na wszystkie określone platformy.
  • Precyzyjne linki mogą zawierać parametry (&) lub tagi kotwicy (#).
    • Jeśli autoodtwarzanie nie jest domyślnie włączone, zalecamy dodanie do precyzyjnego linku parametru, np. &autoplay=true, aby aktywować funkcję autoodtwarzania w Twojej aplikacji lub na platformie.

Przykłady właściwości @id, url i 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",
       ...
     },
   ...
   },
   ...
}

Następujący pseudokod reprezentuje oczekiwane działanie po zainicjowaniu przez użytkownika odtwarzanie:

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

Aby zapewnić optymalne działanie odtwarzania, przestrzegaj tych zasad: wymagania dotyczące konkretnej platformy:

iOS
Musisz używać uniwersalnych linków.
Android i Android TV
Możesz używać linków aplikacji na Androida lub linki do niestandardowych schematów.

Na Androidzie i Androidzie TV możesz też używać niestandardowych linków do schematów. W przypadku Twojej aplikacji Identyfikator URI schematu niestandardowego musi zawierać parametr package_id. Dzięki temu użytkownik trafia na stronę aplikacji w Sklepie Play, jeśli nie masz jej zainstalowanej. Dlatego jedynym akceptowanym formatem schematu niestandardowego są poniższe formaty identyfikatora URI w przypadku działań związanych z multimediami:

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

Na przykład:

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

Więcej szczegółów znajdziesz w pełnej specyfikacji.

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

Na przykład:

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

Inne formaty identyfikatorów URI, takie jak w poniższym przykładzie, nie są dopuszczalne niestandardowe. linki do schematów w przypadku działań związanych z mediami:

scheme://{path}

Na przykład:

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

Sprawdzone metody

Jeśli aplikacja nie jest zainstalowana i nie masz odtwarzacza internetowego, skonfiguruj swój serwer WWW, aby automatycznie przekierowywał użytkownika do Android lub App Store, by zainstalować aplikację. Aby ustawić przekierowanie, użyj linków dynamicznych Firebase. i zewnętrznych platform inteligentnych linków.

Jeśli aplikacja nie jest zainstalowana, ale masz odtwarzacz internetowy, udostępni link lub inteligentny baner do sklepu na Androida lub App Store, zainstalować aplikację. Oto przykład wdrożonego banera inteligentnego:

Przykład wdrożonego banera inteligentnego

W tabeli poniżej znajdziesz wymagania i ograniczenia dotyczące precyzyjnych linków, ponieważ dotyczą systemów iOS, Android i AndroidTV:

iOS, Android i Android TV
http:// lub https:// Wymagane Zalecane, jeśli witryna mobilna obsługuje odtwarzanie.
android-app:// lub intent:// Nie dotyczy Zalecane, jeśli witryna mobilna nie obsługuje odtwarzania.
foo:// (dowolny ciąg znaków) Niedozwolone Niedozwolone

Typy platform

Aby mieć pewność, że Twoje treści będą dostępne na wielu platformach Google (wyszukiwarka, Asystent, Android TV i Chromecast), przestrzegaj tych wymagań:

Poniższa tabela zawiera listę platform, które obsługują działania związane z multimediami:

Platforma Opis
http://schema.org/DesktopWebPlatform Platforma wyszukiwania w przeglądarce na komputerze.
http://schema.org/MobileWebPlatform Platforma wyszukiwania w przeglądarce mobilnej.
http://schema.org/AndroidPlatform Platformy wyszukiwania i PlayGuide w aplikacji na Androida.
http://schema.org/AndroidTVPlatform Platforma Android TV w aplikacji na Androida TV.
http://schema.org/IOSPlatform Platforma wyszukiwania w aplikacji na iOS.
http://schema.googleapis.com/GoogleVideoCast Platformy Cast i Home na urządzeniu Chromecast.
http://schema.googleapis.com/GoogleAudioCast Tylko słuchanie. Platformy Cast i Home na urządzeniu Chromecast.

Przykład elementu z 2 różnymi precyzyjnymi linkami:

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

Zachowanie podczas odtwarzania

W przypadku większości treści, gdy Google kieruje użytkowników do Twojej aplikacji lub platformy, wymagamy potwierdzenia, aby automatycznie odtworzyć wybrane treści. Dzięki temu użytkownicy mogą szybko za oglądanie lub słuchanie treści.

Działanie odtwarzania działań związanych z oglądaniem

W przypadku działań związanych z oglądaniem wymagamy poniższego zachowania podczas odtwarzania.

Wszystkie precyzyjne linki: film, odcinek serialu telewizyjnego, serial telewizyjny i sezon telewizyjny

  • Zachowanie podczas logowania się lub zakupów: jeśli usługa wymaga zalogowania się lub zakup, film lub odcinek muszą zostać odtworzone zgodnie ze swoimi typ zapytania. Więcej informacji znajdziesz we wskazówkach dotyczących precyzyjnych linków, obserwuj.

  • Odtwarzanie: jeśli usługa śledzi stan użytkownika, odtwarzanie musi rozpoczynać się od poprzedniego znacznika użytkownika w filmie lub odcinku. W przeciwnym razie odtwarzanie musi: zaczyna się od początku treści.

  • Autoodtwarzanie: w zależności od platformy usługa musi wyraźnie odtwarzać treści po wybraniu przez użytkownika docelowego odcinka lub filmu.

    • Wyszukiwarka: autoodtwarzanie jest zalecane, ale nie jest wymagane. Jeśli autoodtwarzanie nie jest obsługiwane, po przejściu do aplikacji lub usługi użytkownik musi odtworzyć treść po jednym kliknięciu.
    • Android TV: autoodtwarzanie jest wymagane w przypadku filmu i odcinka.

Tylko precyzyjne linki do seriali telewizyjnych i sezonów TV

  • Wybór docelowego odcinka: musisz wybrać odpowiedni odcinek docelowy. Jeśli usługa śledzi stan użytkownika, odcinek docelowy musi być odcinkiem w którym użytkownik ostatnio przestał oglądać. lub jeśli użytkownik zakończył który oglądał ostatnio oglądany odcinek, powinien być kolejnym . W przeciwnym razie odcinek docelowy musi być jednym z tych elementów: według własnego uznania:

    • TVSeries
      • Pierwszy odcinek serialu. Zalecane w przypadku seriali.
      • Pierwszy odcinek najnowszego sezonu. Zalecane dla: długotrwałe seriale i programy.
      • Najnowszy odcinek. Zalecane w przypadku programów codziennych lub związanych z wiadomościami.
    • TVSeason
      • Pierwszy odcinek sezonu. Zalecane w przypadku seriali.
      • Najnowszy odcinek. Zalecane w przypadku programów codziennych lub związanych z wiadomościami.

    Precyzyjny link do platformy TVSeries lub TVSeason musi być statyczny (niezmienny) i przejdź do odcinka docelowego. Nie używaj precyzyjnego linku do konkretnego odcinka.

    W tabeli poniżej znajdziesz kilka przykładów, które pokazują wymagane zasady wyboru odcinka w kodzie TVSeries, TVSeason i TVEpisode typów encji:

    Kierowanie na odcinek, jeśli użytkownik ostatnio oglądał S6E24 Ustaw kierowanie na odcinek, jeśli użytkownik nie widział żadnych odcinków
    Precyzyjny link do serii
    • S6E24 (jeśli użytkownik nie ukończył zadania S6E24)
    • S6E25 (jeśli użytkownik zakończył oglądanie filmu S6E24)

    Jedna z tych wersji:

    • Pierwszy odcinek serii
    • Pierwszy odcinek najnowszego sezonu
    • Najnowszy odcinek
    Precyzyjny link do sezonu (S1-S5)
    • odcinek, który użytkownik ostatnio oglądał w danym sezonie; pierwszy odcinek sezonu, jeśli użytkownik nie oglądał żadnego odcinków tego sezonu.
    • Pierwszy odcinek sezonu
    Precyzyjny link do sezonu (S6)
    • S6E24 (jeśli użytkownik nie ukończył zadania S6E24)
    • S6E25 (jeśli użytkownik zakończył oglądanie filmu S6E24)

    Jedna z tych wersji:

    • Pierwszy odcinek sezonu
    • Najnowszy odcinek
    Precyzyjny link do odcinka
    • Konkretny odcinek, który został kliknięty.
    • Konkretny odcinek, który został kliknięty.

Działanie odtwarzania w przypadku działań związanych z słuchaniem

W przypadku działań związanych z słuchaniem wymagana jest zasada odtwarzania:

  • Treści muszą się odtwarzać w ciągu 1 kliknięcia od przejścia użytkownika do aplikacji lub usługi.
  • Jeśli aplikacja lub platforma wymaga zalogowania się, musi odtworzyć treść natychmiast lub po jednym kliknięciu.
  • Twoja aplikacja lub platforma musi zapewniać wszystkim użytkownikom co najmniej 1 sposób odtwarzania konkretnego utworu, albumu, wykonawcy lub playlisty.
    • W przypadku użytkowników, którzy nie mogą odtwarzać konkretnych treści (na przykład nie mają wymaganej subskrypcji), usługa musi zawierać wyjaśnienie, co użytkownik musi zrobić, aby po otwarciu aplikacji lub platformy odtwarzać konkretne treści.

W przypadku Twojej aplikacji lub platformy zalecamy stosowanie tych sprawdzonych metod:

  • W MusicGroup: za każdym razem, gdy użytkownik wybierze tego wykonawcę, będzie można odtwarzać inne treści od tego wykonawcy.
  • W funkcji MusicAlbum treści są odtwarzane w kolejności występowania w albumie.
  • W aplikacji MusicPlaylist możesz odtwarzać inne treści z playlisty za każdym razem, gdy użytkownik wybierze playlistę.

Wykonaj te czynności:

  1. Sprawdź, czy w przypadku każdej treści nie ma innych precyzyjnych linków w zależności od platformy.
  2. W przypadku każdego precyzyjnego linku zadaj sobie te pytania dotyczące punktu wejścia (strony w aplikacji lub na platformie, do której prowadzi precyzyjny link):
    • Czy punkt wejścia (nie treść) obsługuje wiele języków?
    • Czy punkt wejścia obsługuje wiele języków napisów?
    • Czy punkt wejścia obsługuje kilka kątów kamery?
    • Czy punkt wejścia obsługuje wiele formatów wideo?

Jeśli odpowiedź na którekolwiek z tych pytań jest twierdząca, musisz podać właściwość additionalProperty dla tego precyzyjnego linku. Zobacz przykład additionalProperty.