Identifique os links diretos específicos da plataforma do seu conteúdo

Quando um usuário inicia ações de mídia em um conteúdo (por exemplo, clica no seu ícone na Pesquisa Google), o Google o direciona diretamente para o conteúdo no seu app ou plataforma usando o link direto do conteúdo.

Link direto

Confira os requisitos para links diretos:

• urlTemplate (de um objeto de destino) exige um link direto.
• Os links diretos precisam abrir o conteúdo a que se destinam em todas as plataformas especificadas.
• Os links diretos podem incluir parâmetros (&) ou tags âncora (#).
  • Se a reprodução automática não estiver ativada por padrão, recomendamos adicionar um parâmetro, como &autoplay=true, ao link direto para ativar o recurso no app ou na plataforma.

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 a 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 alcançar o comportamento de reprodução desejado, siga os requisitos específicos da plataforma:

iOS

Você precisa usar links universais.

Android e Android TV

Você pode usar Links do app Android ou links de esquema personalizado.

Links de esquema personalizado para Android e Android TV

No Android e no Android TV, também é possível usar links de esquema personalizados. O package_id do app precisa estar incluído no URI do esquema personalizado. Isso garante que o usuário seja direcionado à página do app na Google Play Store se ele não estiver instalado. Portanto, os seguintes formatos de URI são os únicos formatos de esquema personalizados 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 a seguir, não são links de esquema personalizados aceitáveis para ações de mídia:

scheme://{path}

Exemplo:

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

Práticas recomendadas

Se o app não estiver instalado e você não tiver um player da Web, configure o servidor da Web para redirecionar automaticamente o usuário à Play Store ou App Store para instalar o app. Para redirecionar, use Firebase Dynamic Links ou plataformas de links inteligentes de terceiros.

Se o app não estiver instalado e você tiver um player da Web, forneça um link ou banner inteligente para a Play Store ou a App Store para que os usuários instalem o app. Veja um exemplo de banner inteligente implementado:

Resumo dos requisitos e limitações de links diretos

A tabela a seguir mostra os requisitos e as limitações dos links diretos para iOS, Android e AndroidTV:

Tipos de plataforma

Para garantir que seu conteúdo esteja disponível nas várias plataformas do Google que oferecem suporte às ações de mídia, siga estes 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 as ações de mídia:

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 para seu app ou plataforma, exigimos que o conteúdo selecionado seja reproduzido automaticamente. Isso permite que os usuários comecem a assistir ou ouvir o conteúdo rapidamente.

Comportamento de reprodução de ações de assistir

Para ações de assistir, exigimos o seguinte comportamento de reprodução.

Todos os links diretos: Movie, TVEpisode, TVSeries e TVSeason

• Comportamento de compra ou login:se o serviço exigir login ou compra, o filme ou episódio precisa ser reproduzido depois, conforme o tipo de conteúdo. Para mais detalhes, consulte as diretrizes de links diretos a seguir.

• Reprodução:se o serviço rastrear o estado de um usuário, a reprodução precisará começar do 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 reproduza o conteúdo de forma destacada depois que o usuário selecionar o episódio ou filme desejado.

  • 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 depois que o usuário acessar seu app ou serviço.
  • Android TV:a reprodução automática é obrigatória para filmes e episódios.

Apenas links diretos de TVSeries e TVSeason

• Seleção do episódio de destino:selecione o episódio de destino correto. Se o serviço rastrear o estado de um usuário, o episódio de destino precisa ser aquele em que o usuário parou de assistir por último. Ou, se o usuário tiver terminado de assistir o episódio, defina o episódio de destino como o seguinte. 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 seriados.
    • O primeiro episódio da temporada mais recente. Recomendado para séries longas.
    • O episódio mais recente. Recomendado para programas diários ou relacionados a notícias.
  • TVSeason
    • O primeiro episódio da temporada. Recomendado para programas seriados.
    • O episódio mais recente. Recomendado para programas diários ou relacionados a notícias.

  Um link direto para TVSeries ou TVSeason precisa ser estático (não pode mudar) e direcionar para o episódio de destino. Não use o link direto para um episódio específico.

  A tabela a seguir mostra vários exemplos que demonstram a lógica de seleção de episódio de destino necessária para os tipos de entidade TVSeries, TVSeason e TVEpisode:

  	Segmentar o episódio se o usuário tiver assistido o S6E24 por último	Segmentar o episódio se o usuário não tiver assistido nenhum
  Link direto da série	S6E24 (se o usuário não tiver terminado 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 a S5)	O último episódio assistido pelo usuário na temporada ou o primeiro episódio da temporada, caso o usuário não tenha assistido nenhum episódio dela.	Primeiro episódio da temporada
  Link direto da temporada (S6)	S6E24 (se o usuário não tiver terminado 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 escuta

Para ações de escuta, exigimos o seguinte comportamento de reprodução:

• O conteúdo precisa ser reproduzido com um clique depois que o usuário é direcionado ao seu app ou serviço.
• Se o app ou a plataforma exigir um login, o conteúdo precisa ser reproduzido imediatamente ou com um clique após o login.
• Seu app ou plataforma precisa oferecer pelo menos uma maneira para todos os usuários tocarem a música, o álbum, o artista ou a playlist exata.
  • Para usuários que não se qualificam para acessar o conteúdo exato (por exemplo, não têm a assinatura necessária), seu serviço precisa explicar o que eles precisam fazer para se qualificar ao acessar seu app ou plataforma.

Recomendamos as seguintes práticas recomendadas para seu app ou plataforma:

• Para MusicGroup, toque um conteúdo diferente do artista a cada vez que um usuário o selecionar.
• Para MusicAlbum, toque o conteúdo na ordem em que ele aparece no álbum.
• Para MusicPlaylist, reproduza conteúdo diferente da playlist sempre que um usuário a selecionar.

Identificar os links diretos

Faça o seguinte:

1. Para cada conteúdo, verifique se ele tem links diretos diferentes com base nas plataformas.
2. Para cada link direto, faça as seguintes perguntas sobre o ponto de entrada (a página no app ou na plataforma para onde o link direto leva):
   • O ponto de entrada (não o conteúdo) oferece suporte a vários idiomas?
   • O ponto de entrada aceita vários idiomas de legenda?
   • O ponto de entrada aceita vários ângulos de câmera?
   • O ponto de entrada aceita vários formatos de vídeo?

Se a resposta for "Sim" para qualquer uma dessas perguntas, você precisará fornecer a propriedade additionalProperty para esse link direto. Confira o exemplo de additionalProperty.