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.
Precyzyjny link
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.
- Jeśli autoodtwarzanie nie jest domyślnie włączone, zalecamy dodanie do precyzyjnego linku parametru, np.
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",
...
},
...
},
...
}
Używanie precyzyjnych linków do rozpoczynania odtwarzania
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.
Niestandardowe linki do schematów na Androida i Androida TV
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:
Podsumowanie wymagań i ograniczeń dotyczących precyzyjnych linków
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ń:
- Wszystkie platformy obsługiwane przez partnerów wymagają precyzyjnego linku do Twoich treści.
- W przypadku platform Chromecast musisz utworzyć odbiornik przy użyciu najnowszego pakietu SDK Cast Application Framework (CAF) Receiver SDK.
- W przypadku platform mobilnych (Android i iOS) wymagania znajdziesz w sekcji Korzystanie z precyzyjnych linków do inicjowania odtwarzania.
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
lubTVSeason
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
iTVEpisode
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ę.
Zidentyfikuj precyzyjne linki
Wykonaj te czynności:
- Sprawdź, czy w przypadku każdej treści nie ma innych precyzyjnych linków w zależności od platformy.
- 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.