Quando um usuário inicia ações de mídia no conteúdo (por exemplo, um usuário clica no seu ícone na Pesquisa Google), o Google o leva diretamente para o conteúdo no seu app ou plataforma usando o link direto do conteúdo.
Link direto
Confira a seguir os requisitos dos links diretos:
urlTemplate
(de um objeto de destino) requer um link direto.- Os links diretos precisam abrir o conteúdo segmentado em todas as plataformas especificadas.
- Os links diretos podem incluir parâmetros (&) ou tags de âncora (#).
- Se a reprodução automática não estiver ativada por padrão, recomendamos que você anexe um parâmetro, como
&autoplay=true
, ao link direto para ativar o recurso de reprodução automática no seu app ou plataforma.
- Se a reprodução automática não estiver ativada por padrão, recomendamos que você anexe um parâmetro, como
Exemplo de @id
, url
e 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",
...
},
...
},
...
}
Usar links diretos para iniciar a reprodução
O pseudocódigo a seguir representa o comportamento desejado quando um usuário inicia reprodução:
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
Para atingir o comportamento de reprodução desejado, siga as seguintes requisitos específicos da plataforma:
- iOS
- É necessário usar links universais.
- Android e Android TV
- Você pode usar os Links do app Android. ou links de esquema personalizado. .
Links de esquema personalizados para Android e Android TV
No Android e no Android TV, você também pode usar links de esquema personalizados. Do seu app
package_id
precisa ser incluído no URI do esquema personalizado. Isso garante que o
o usuário será direcionado para a página do seu app na Play Store se ele não estiver instalado.
Portanto, os seguintes formatos de URI são os únicos formatos de esquema personalizado aceitáveis
para ações de mídia:
android-app://{package_id}/{scheme}/{path}
-
Exemplo:
android-app://com.partner.mynetworkapp/mynetwork/play?series=20114&title=21141&media=e90c89fa4
Para mais detalhes, consulte a especificação completa.
intent://{package_id}/{scheme}/{path}
-
Exemplo:
intent://com.partner.mynetworkapp/mynetwork/play?series=20114&title=21141&media=e90c89fa4
Outros formatos de URI, como o exemplo abaixo, não são aceitos. esquemas de links para ações de mídia:
scheme://{path}
-
Exemplo:
mynetwork://play?series=20114&title=21141&media=e90c89fa4
Práticas recomendadas
Caso seu app não esteja instalado e você não tenha um web player, configure seu servidor da Web para redirecionar automaticamente o usuário para a Android ou na App Store para instalar o app. Para redirecionar, use os links dinâmicos do Firebase. ou plataformas de links inteligentes de terceiros.
Caso seu app não esteja instalado e você tenha um web player, forneça um link ou banner inteligente para o Android ou a App Store para que os usuários para instalar o app. Este é um exemplo de um banner inteligente implementado:
Resumo dos requisitos e limitações dos links diretos
A tabela a seguir mostra os requisitos e as limitações dos links diretos, já que eles relacionados a iOS, Android e AndroidTV:
iOS | Android e AndroidTV | |
---|---|---|
http:// ou https:// | Obrigatório | Recomendado se o site móvel for compatível com reprodução. |
android-app:// ou intent:// | N/A | Recomendado se o site móvel não for compatível com a reprodução. |
foo:// (string arbitrária) | Não permitido | Não permitido |
Tipos de plataforma
Para garantir que seu conteúdo esteja disponível nas várias plataformas do Google (Pesquisa, Assistente, Android TV e Chromecast), atenda aos seguintes requisitos:
- Todas as plataformas compatíveis com parceiros exigem um link direto para seu conteúdo.
- Para plataformas Chromecast, é necessário criar um receptor usando o SDK do receptor do Cast Application Framework (CAF) mais recente.
- Para plataformas móveis (Android e iOS), consulte os requisitos na seção Usar links diretos para iniciar a reprodução.
A tabela a seguir contém uma lista das plataformas compatíveis com ações de mídia:
Plataforma | Descrição |
---|---|
http://schema.org/DesktopWebPlatform
|
Plataforma de pesquisa em um navegador da Web para computadores. |
http://schema.org/MobileWebPlatform
|
Plataforma de pesquisa em um navegador da Web para dispositivos móveis. |
http://schema.org/AndroidPlatform
|
Plataformas de Pesquisa e PlayGuide no app Android. |
http://schema.org/AndroidTVPlatform
|
Plataforma Android TV no app Android TV. |
http://schema.org/IOSPlatform
|
Plataforma de pesquisa no app iOS. |
http://schema.googleapis.com/GoogleVideoCast
|
Plataformas Google Cast e Home em um dispositivo Chromecast. |
http://schema.googleapis.com/GoogleAudioCast
|
Somente ações de escuta. Plataformas Google Cast e Home em um dispositivo Chromecast. |
Exemplo de uma entidade com dois links diretos diferentes:
"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" ]
}
],
}
],
...
}
Comportamento de reprodução
Para a maioria dos conteúdos, quando o Google direciona os usuários ao seu app ou plataforma, exigimos reproduzir automaticamente o conteúdo selecionado. Isso permite que os usuários comecem a usar assistir ou ouvir o conteúdo.
Comportamento de reprodução das Ações de relógio
Para as Ações de exibição, exigimos o comportamento de reprodução a seguir.
Todos os links diretos: filme, episódio de TV, série de TV e temporada de TV
Comportamento de login ou de compra:se o serviço exigir login ou compra, o filme ou episódio deve ser reproduzido, conforme apropriado para depois. Para mais detalhes, consulte as diretrizes de links diretos que seguir.
Reprodução: se o serviço rastrear o estado de um usuário, a reprodução precisará começar em marcador anterior do usuário no filme ou episódio. Caso contrário, a reprodução precisa começar do início do conteúdo.
Reprodução automática:dependendo da plataforma, é necessário que seu serviço abra o conteúdo em destaque depois que o episódio ou filme for selecionado pelo usuário.
- Pesquisa:a reprodução automática é altamente recomendada, mas não é obrigatória. Se a reprodução automática não for compatível, o conteúdo precisará ser reproduzido com um clique após o usuário ser direcionado ao app ou serviço.
- Android TV:a reprodução automática é necessária para filmes e episódios.
Somente links diretos de TVSeries e TVSeason
Seleção de episódio de destino:você precisa selecionar o episódio de destino correto. Se seu serviço rastreia o estado de um usuário, o episódio alvo deve ser o episódio que o usuário parou de assistir pela última vez. Ou, se o usuário tiver terminado completamente o episódio assistido pela última vez, faça com que o episódio-alvo seja o próximo episódio 4. Caso contrário, o episódio de destino precisa ser um dos seguintes: a seu critério:
TVSeries
- O primeiro episódio da série. Recomendado para programas serializados.
- O primeiro episódio da temporada mais recente. Recomendado para programas serializados de longa duração.
- O último episódio. Recomendado para programas diários ou relacionados a notícias.
TVSeason
- O primeiro episódio da temporada. Recomendado para programas serializados.
- O último episódio. Recomendado para programas diários ou relacionados a notícias.
Um link direto para
TVSeries
ouTVSeason
precisa ser estático (sem mudanças) e resolver para o episódio de destino. Não use o link direto para um episódio específico.A tabela a seguir fornece vários exemplos que demonstram os requisitos lógica de seleção de episódio de destino para
TVSeries
,TVSeason
e Tipos de entidadeTVEpisode
:Segmentar episódio se o usuário assistiu pela última vez a S6E24 Segmentar o episódio se o usuário não tiver assistido nenhum episódio Link direto da série - S6E24 (se o usuário não tiver terminado o S6E24)
- S6E25 (se o usuário tiver terminado de assistir S6E24)
Opções:
- Primeiro episódio da série
- Primeiro episódio da temporada mais recente
- Último episódio
Link direto da temporada (S1-S5) - O episódio que o usuário assistiu pela última vez nessa temporada ou o primeiro episódio da temporada se o usuário não tiver assistido nenhum episódios dessa temporada.
- Primeiro episódio da temporada
Link direto da temporada (S6) - S6E24 (se o usuário não tiver terminado o S6E24)
- S6E25 (se o usuário tiver terminado de assistir S6E24)
Opções:
- Primeiro episódio da temporada
- Último episódio
Link direto do episódio - O episódio específico que foi clicado.
- O episódio específico que foi clicado.
Comportamento de reprodução das ações de ouvir
Para as Ações de escuta, exigimos o seguinte comportamento de reprodução:
- O conteúdo precisa ser reproduzido com um clique após o usuário ser direcionado ao app ou serviço.
- Se o app ou plataforma exigir um login, será necessário reproduzir o conteúdo imediatamente ou com um clique após o login.
- Seu app ou plataforma precisa oferecer pelo menos uma maneira para que todos os usuários toquem a música, o álbum, o artista ou a playlist exatos.
- No caso de usuários não qualificados para assistir o conteúdo exato (por exemplo, não têm a assinatura necessária), o serviço precisa explicar o que é preciso fazer para abrir o conteúdo exato ao chegar no app ou na plataforma.
Recomendamos as seguintes práticas para seu app ou plataforma:
- No
MusicGroup
, abra um conteúdo diferente do artista sempre que um usuário selecioná-lo. - Para
MusicAlbum
, abra o conteúdo na ordem de aparecimento no álbum. - Para
MusicPlaylist
, abra um conteúdo diferente da playlist sempre que um usuário selecionar a playlist.
Identificar os links diretos
Faça o seguinte:
- Para cada conteúdo, verifique se há links diretos diferentes com base nas plataformas.
- Para cada link direto, faça as seguintes perguntas sobre o ponto de entrada (a página no seu aplicativo ou plataforma para a qual o link direto leva):
- O ponto de entrada (não o conteúdo) aceita vários idiomas?
- O ponto de entrada oferece suporte a vários idiomas de legendas?
- O ponto de entrada aceita vários ângulos de câmera?
- O ponto de entrada suporta vários formatos de vídeo?
Se a resposta for sim para alguma dessas perguntas, será necessário fornecer a propriedade additionalProperty
do link direto. Veja o exemplo additionalProperty.