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

Gdy użytkownik uruchomi Media Actions dotyczące treści (np. kliknie Twoją ikonę w wyszukiwarce Google), Google przekieruje go bezpośrednio do treści w Twojej aplikacji lub na platformie za pomocą precyzyjnego linku do treści.

Precyzyjny link

Wymagania dotyczące precyzyjnych linków:

• urlTemplate (obiektu docelowego) wymaga precyzyjnego linku.
• Precyzyjne linki muszą otwierać docelowe treści na wszystkich określonych platformach.
• Precyzyjne linki mogą zawierać parametry (&) lub tagi kotwicy (#).
  • Jeśli autoodtwarzanie nie jest domyślnie aktywowane, zalecamy dodanie do precyzyjnego linku parametru, np. &autoplay=true, aby włączyć funkcję autoodtwarzania w aplikacji lub na platformie.

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

Używanie precyzyjnych linków do rozpoczynania odtwarzania

Poniższy pseudokod przedstawia oczekiwane 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 działanie odtwarzania, przestrzegaj tych wymagań dotyczących poszczególnych platform:

iOS

Musisz używać uniwersalnych linków.

Android i Android TV

Możesz używać linków aplikacji na Androida lub linków schematu niestandardowego.

Linki do schematu niestandardowego na Androida i Androida TV

Na Androidzie i Androidzie TV możesz też używać linków ze schematem niestandardowym. package_id aplikacji musi być uwzględniony w identyfikatorze URI schematu niestandardowego. Dzięki temu, jeśli aplikacja nie jest zainstalowana, użytkownik zostanie przekierowany na jej stronę w Sklepie Play. Dlatego jedynymi akceptowanymi formatami niestandardowych schematów dla Media Actions są 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 poniższym przykładzie, nie są akceptowanymi linkami do niestandardowych schematów w przypadku Media Actions:

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 WWW tak, aby automatycznie przekierowywał użytkownika do Sklepu Play lub App Store w celu zainstalowania aplikacji. Aby przekierować użytkownika, użyj Linków dynamicznych Firebase lub platform inteligentnych linków innych firm.

Jeśli Twoja aplikacja nie jest zainstalowana, a masz odtwarzacz internetowy, podaj link lub inteligentny baner do sklepu z aplikacjami na Androida lub iOS, aby użytkownicy mogli zainstalować Twoją aplikację. Poniżej znajdziesz przykład wdrożonego inteligentnego banera:

Podsumowanie wymagań i ograniczeń dotyczących linków bezpośrednich

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

Typy platform

Aby Twoje treści były dostępne na różnych platformach Google obsługujących Media Actions, musisz spełniać te wymagania:

• Wszystkie platformy obsługiwane przez partnerów wymagają precyzyjnego linku do Twoich treści.
• W przypadku platform Chromecast musisz utworzyć odbiornik za pomocą najnowszego pakietu SDK odbiornika Cast Application Framework (CAF).
• W przypadku platform mobilnych (Android i iOS) zapoznaj się z wymaganiami w sekcji Używanie precyzyjnych linków do rozpoczynania odtwarzania.

W tabeli poniżej znajdziesz listę platform obsługujących Media Actions:

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

Działanie odtwarzania

W przypadku większości treści, gdy Google przekierowuje użytkowników do Twojej aplikacji lub platformy, wymagamy automatycznego odtwarzania wybranych treści. Dzięki temu użytkownicy mogą szybko rozpocząć oglądanie lub słuchanie treści.

Zachowanie odtwarzania działań związanych z oglądaniem

W przypadku działań związanych z oglądaniem wymagamy następującego zachowania odtwarzania:

Wszystkie precyzyjne linki: Movie, TVEpisode, TVSeries i TVSeason

• Zachowanie podczas logowania lub zakupu: jeśli usługa wymaga zalogowania się lub zakupu, po zalogowaniu lub zakupie musi zostać odtworzony film lub odcinek serialu (w zależności od typu). Więcej informacji znajdziesz w wytycznych dotyczących precyzyjnych linków poniżej.

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

• Autoodtwarzanie: w zależności od platformy wymagane jest, aby usługa odtwarzała treści po wybraniu przez użytkownika docelowego odcinka lub filmu.

  • Wyszukiwarka: autoodtwarzanie jest zdecydowanie zalecane, ale nie jest wymagane. Jeśli autoodtwarzanie nie jest obsługiwane, treści muszą być odtwarzane po jednym kliknięciu, gdy użytkownik zostanie przekierowany do Twojej aplikacji lub usługi.
  • Android TV: autoodtwarzanie jest wymagane w przypadku filmów i odcinków.

Tylko precyzyjne linki do seriali telewizyjnych i sezonów seriali 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ł do końca ostatni odcinek, który oglądał, wybierz następny odcinek. W przeciwnym razie docelowy odcinek musi być jednym z tych odcinków (według Twojego uznania):

  • TVSeries
    • Pierwszy odcinek serialu. Zalecane w przypadku seriali.
    • Pierwszy odcinek najnowszego sezonu. Zalecane w przypadku długich seriali.
    • 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 TVSeries lub TVSeason musi być statyczny (nie może się zmieniać) i prowadzić do docelowego odcinka. Nie używaj precyzyjnego linku do konkretnego odcinka.

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

  	Kierowanie na odcinek, jeśli użytkownik ostatnio oglądał S6E24	Kierowanie na odcinek, jeśli użytkownik nie obejrzał żadnych odcinków
  Precyzyjny link do serialu	S6E24 (jeśli użytkownik nie skończył odcinka S6E24) S6E25 (jeśli użytkownik obejrzał S6E24)	Jedna z tych wartości: Pierwszy odcinek serialu pierwszy odcinek najnowszego sezonu, Najnowszy odcinek
  Precyzyjny link do sezonu (S1–S5)	Ostatni odcinek, który użytkownik obejrzał w danym sezonie, lub pierwszy odcinek sezonu, jeśli użytkownik nie obejrzał żadnego odcinka w tym sezonie.	Pierwszy odcinek sezonu
  Precyzyjny link do sezonu (S6)	S6E24 (jeśli użytkownik nie skończył odcinka S6E24) S6E25 (jeśli użytkownik obejrzał S6E24)	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.

Działanie odtwarzania w przypadku działań słuchania

W przypadku działań związanych ze słuchaniem wymagamy następującego zachowania odtwarzania:

• Treści muszą być odtwarzane po jednym kliknięciu, gdy użytkownik zostanie przekierowany do Twojej aplikacji lub usługi.
• Jeśli Twoja aplikacja lub platforma wymaga zalogowania, musi odtwarzać treści natychmiast lub po jednym kliknięciu po zalogowaniu.
• Aplikacja lub platforma musi oferować co najmniej 1 sposób odtwarzania dokładnego utworu, albumu, wykonawcy lub playlisty przez wszystkich użytkowników.
  • W przypadku użytkowników, którzy nie mogą odtworzyć określonych treści (np. nie mają wymaganej subskrypcji), usługa musi wyjaśnić, co należy zrobić, aby uzyskać możliwość odtworzenia tych treści po otwarciu aplikacji lub platformy.

Zalecamy stosowanie tych sprawdzonych metod w przypadku aplikacji lub platformy:

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

Określ precyzyjne linki

Wykonaj te czynności:

1. Sprawdź, czy poszczególne treści mają różne linki bezpośrednie w zależności od platformy.
2. W przypadku każdego precyzyjnego linku zadaj 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 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 „tak”, musisz podać additionalProperty w przypadku tego linku bezpośredniego. Zobacz przykład additionalProperty.