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

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.

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.

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

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.
.

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:

Exemplo de um banner inteligente implementado

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:

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 ou TVSeason 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 entidade TVEpisode:

    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.

Faça o seguinte:

  1. Para cada conteúdo, verifique se há 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 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.