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

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

Wymagania dotyczące precyzyjnych linków:

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

Przykłady znaczników @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",
       ...
     },
   ...
   },
   ...
}

Poniższy pseudokod przedstawia żądane działanie, gdy użytkownik rozpoczyna 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 uzyskać pożądane zachowanie odtwarzania, przestrzegaj tych wymagań dotyczących poszczególnych platform:

iOS
Musisz używać uniwersalnych linków.
Android i Android TV
Możesz użyć linków aplikacji na Androida lub linków schematu niestandardowego.

Na Androidzie i Androidzie TV możesz też używać niestandardowych linków schematu. W identyfikatorze URI schematu niestandardowego musi być uwzględniony identyfikator package_id Twojej aplikacji. Dzięki temu użytkownik zostanie przekierowany na stronę aplikacji w Sklepie Play, jeśli aplikacja nie jest zainstalowana. Dlatego w przypadku działań związanych z multimediami akceptowane są tylko te formaty identyfikatorów URI:

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

Na przykład:

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

Więcej informacji 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 przykładzie poniżej, nie są akceptowanymi linkami niestandardowymi w ramach schematu działań związanych z multimediami:

scheme://{path}

Na przykład:

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

Sprawdzone metody

Jeśli aplikacja nie jest zainstalowana, a nie masz odtwarzacza internetowego, skonfiguruj serwer internetowy tak, aby automatycznie przekierowywał użytkownika do sklepu Google Play lub App Store, gdzie może zainstalować aplikację. Do przekierowania możesz użyć linków dynamicznych Firebase lub zewnętrznych platform inteligentnych linków.

Jeśli aplikacja nie jest zainstalowana, a masz odtwarzacz internetowy, podaj link lub baner inteligentny do sklepu Google Play lub App Store, aby użytkownicy mogli zainstalować aplikację. Poniżej znajdziesz przykład zaimplementowanego banera inteligentnego:

Przykład zaimplementowanego inteligentnego banera

W tabeli poniżej znajdziesz wymagania i ograniczenia dotyczące precyzyjnych linków w przypadku iOS, Androida 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 są dostępne na różnych platformach Google (wyszukiwarka, Asystent, Android TV i Chromecast), musisz spełnić te wymagania:

Poniższa tabela zawiera listę platform, które obsługują akcje dotyczące multimediów:

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 Search i PlayGuide w aplikacji na Androida.
http://schema.org/AndroidTVPlatform platforma Android TV w aplikacji na Androida TV.
http://schema.org/IOSPlatform Wyszukaj platformę w aplikacji na iOS.
http://schema.googleapis.com/GoogleVideoCast platformy Cast i Home na urządzeniu Chromecast.
http://schema.googleapis.com/GoogleAudioCast Tylko ListenActions. platformy Cast i Home na urządzeniu Chromecast.

Przykład encji 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 przekierowuje użytkowników do Twojej aplikacji lub platformy, wymagamy, aby wybrane treści były odtwarzane automatycznie. Dzięki temu użytkownicy mogą szybko zacząć oglądać lub słuchać treści.

Zachowanie podczas odtwarzania filmów z funkcją Watch Action

W przypadku działań związanych z oglądaniem wymagamy takiego zachowania odtwarzania.

Wszystkie precyzyjne linki: film, odcinek serialu, serial i sezon serialu.

  • Zalogowanie lub zakup: jeśli usługa wymaga zalogowania lub zakupu, film lub odcinek musi się odtwarzać zgodnie z odpowiednim typem. Więcej informacji znajdziesz w poniższych wskazówkach dotyczących precyzyjnych linków.

  • 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 rozpoczynać się od początku treści.

  • Autoodtwarzanie: w zależności od platformy Twoja usługa musi odtwarzać treści w sposób widoczny po wybraniu przez użytkownika konkretnego odcinka lub filmu.

    • Wyszukiwanie: autoodtwarzanie jest zdecydowanie zalecane, ale nie jest wymagane. Jeśli autoodtwarzanie nie jest obsługiwane, treści muszą odtwarzać się w ciągu 1 kliknięcia po tym, jak użytkownik wejdzie do aplikacji lub usługi.
    • Android TV: autoodtwarzanie jest wymagane w przypadku filmów i odcinków.

tylko precyzyjne linki do seriali i sezonów telewizyjnych,

  • Wybór odcinka docelowego: musisz wybrać odpowiedni odcinek docelowy. Jeśli Twoja usługa śledzi stan użytkownika, docelowy odcinek musi być odcinkiem, który użytkownik ostatnio oglądał. Jeśli użytkownik obejrzał cały ostatni odcinek, możesz ustawić jako docelowy kolejny odcinek. W przeciwnym razie docelowy odcinek musi być wybrany przez Ciebie spośród tych opcji:

    • TVSeries
      • Pierwszy odcinek serii. Zalecane w przypadku seriali.
      • Pierwszy odcinek najnowszego sezonu. Zalecane w przypadku długotrwałych seriali.
      • Najnowszy odcinek. Zalecane w przypadku programów informacyjnych lub codziennych.
    • TVSeason
      • Pierwszy odcinek sezonu. Zalecane w przypadku seriali.
      • Najnowszy odcinek. Zalecane w przypadku programów informacyjnych lub codziennych.

    Precyzyjny link do TVSeries lub TVSeason musi być statyczny (niezmieniający się) i prowadzić do wybranego odcinka. Nie używaj precyzyjnego linku do konkretnego odcinka.

    W tabeli poniżej znajdziesz kilka przykładów, które pokazują wymaganą logikę wyboru odcinka docelowego w przypadku typów encji TVSeries, TVSeason i TVEpisode:

    Odcinek docelowy, jeśli użytkownik ostatnio oglądał odcinek 24 z szóstego sezonu kierować reklamy na odcinki, jeśli użytkownik nie obejrzał jeszcze żadnego z nich;
    Precyzyjny link do serii
    • S6E24 (jeśli użytkownik nie obejrzał odcinka S6E24)
    • S6E25 (jeśli użytkownik obejrzał już odcinek 24 z szóstego sezonu),

    Jedna z tych wartości:

    • Pierwszy odcinek serii
    • Pierwszy odcinek najnowszego sezonu
    • Najnowszy odcinek
    Precyzyjny link do sezonu (S1–S5)
    • Ostatni obejrzony odcinek w danym sezonie lub pierwszy odcinek sezonu, jeśli użytkownik nie obejrzał jeszcze żadnego odcinka w danym sezonie.
    • Pierwszy odcinek sezonu
    Precyzyjny link do sezonu (S6)
    • S6E24 (jeśli użytkownik nie obejrzał odcinka S6E24)
    • S6E25 (jeśli użytkownik obejrzał już odcinek 24 z szóstego sezonu),

    Jedna z tych wartości:

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

Zachowanie podczas odtwarzania ListenAction

W przypadku akcji odtwarzania wymagamy następującego zachowania odtwarzania:

  • Treści muszą się odtwarzać w ciągu 1 kliknięcia po przekierowaniu użytkownika do aplikacji lub usługi.
  • Jeśli aplikacja lub platforma wymaga zalogowania, musi odtwarzać treści natychmiast lub w ciągu 1 kliknięcia po zalogowaniu.
  • Aplikacja lub platforma musi oferować co najmniej 1 sposób odtwarzania przez wszystkich użytkowników konkretnego utworu, albumu, wykonawcy lub playlisty.
    • W przypadku użytkowników, którzy nie mogą odtworzyć określonych treści (np. nie mają wymaganej subskrypcji), usługa musi wyjaśniać, co użytkownik musi zrobić, aby móc odtworzyć określone treści po zalogowaniu się w aplikacji lub na platformie.

W przypadku aplikacji lub platformy zalecamy stosowanie tych sprawdzonych metod:

  • W przypadku MusicGroup odtwarzaj różne treści wykonawcy za każdym razem, gdy użytkownik wybierze tego wykonawcę.
  • W przypadku MusicAlbum treści są odtwarzane w kolejności, w jakiej występują na albumie.
  • W przypadku MusicPlaylist odtwarzaj różne treści z playlisty za każdym razem, gdy użytkownik ją wybierze.

Wykonaj te czynności:

  1. Sprawdź, czy w przypadku poszczególnych treści występują różne precyzyjne linki na podstawie platform.
  2. W przypadku każdego precyzyjnego linku zadaj te pytania o punkt wejścia (stronę w aplikacji lub na platformie, na którą prowadzi precyzyjny link):
    • Czy punkt wejścia (nie treści) obsługuje wiele języków?
    • Czy punkt wejścia obsługuje napisy w wielu językach?
    • Czy punkt wejścia obsługuje wiele kątów kamery?
    • Czy punkt wejścia obsługuje wiele formatów wideo?

Jeśli na którekolwiek z tych pytań odpowiesz twierdząco, musisz podać usługę additionalProperty dla tego linku. Zobacz przykład additionalProperty.

Wstecz
Zbieranie metadanych
Dalej
Określenie wymagań dotyczących dostępu