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 leva o usuário diretamente ao conteúdo no seu app ou plataforma usando o link direto do conteúdo.

Confira abaixo os requisitos para os links diretos:

  • urlTemplate (de um objeto de destino) requer um link direto.
  • Os links diretos precisam abrir o conteúdo de destino 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 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",
       ...
     },
   ...
   },
   ...
}

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 seguintes requisitos específicos da plataforma:

iOS
Você precisa usar links universais.
Android e Android TV
É possível usar Links do app Android ou links de esquema personalizado.

No Android e no Android TV, também é possível usar links de esquema personalizados. O package_id do app precisa ser incluído no URI do esquema personalizado. Isso garante que o usuário seja direcionado à página do 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 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

Caso o app não esteja instalado e você não tenha um player da Web, configure o servidor da Web para redirecionar automaticamente o usuário para a App Store ou o Android para instalar o app. Para redirecionar, use links dinâmicos do Firebase ou plataformas de link inteligente de terceiros.

Caso seu app não esteja instalado e você tenha um player da Web, forneça um link ou banner inteligente para o Android ou a App Store para que os usuários instalem o app. Confira abaixo um exemplo de banner inteligente implementado:

Exemplo de banner inteligente implementado

A tabela a seguir mostra os requisitos e as limitações para links diretos, como eles se aplicam ao iOS, Android e AndroidTV:

iOS Android e AndroidTV
http:// ou https:// Obrigatório Recomendado se o site para dispositivos móveis for compatível com a reprodução.
android-app:// ou intent:// N/A Recomendado se o site para dispositivos móveis não tiver suporte à reprodução.
foo:// (string arbitrária) Não permitido Não permitido

Tipos de plataforma

Para garantir que seu conteúdo esteja disponível em várias plataformas do Google (Pesquisa, Google Assistente, Android TV e Chromecast), siga os requisitos abaixo:

A tabela a seguir contém uma lista das plataformas que oferecem suporte a Ações de mídia:

Plataforma Descrição
http://schema.org/DesktopWebPlatform Plataforma de pesquisa no navegador da Web para computador.
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 do Android TV no app Android TV.
http://schema.org/IOSPlatform Plataforma de pesquisa no app iOS.
http://schema.googleapis.com/GoogleVideoCast plataformas Cast e Home em um dispositivo Chromecast.
http://schema.googleapis.com/GoogleAudioCast Apenas ações de ouvir. plataformas 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

Na maioria dos casos, quando o Google direciona os usuários ao seu app ou plataforma, exigimos que você reproduza automaticamente o conteúdo selecionado. Isso permite que os usuários comecem a assistir ou ouvir o conteúdo rapidamente.

Comportamento de reprodução das Ações de assistir a vídeos

Para as Ações de visualização, exigimos o seguinte comportamento de reprodução.

Todos os links diretos: filme, episódio de TV, série de TV e temporada de TV

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

  • Reprodução:se o serviço rastreia o estado de um usuário, a reprodução precisa começar a partir 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 proeminente depois que o episódio ou filme de destino 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 acessar o 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 do episódio de destino:é necessário selecionar o episódio de destino correto. Se seu serviço rastreia o estado de um usuário, o episódio de destino precisa ser o que o usuário parou de assistir por último. Ou, se o usuário tiver terminado completamente o episódio que estava assistindo pela última vez, defina o episódio de destino como o próximo episódio. Caso contrário, o episódio de destino precisa ser um dos seguintes de acordo com sua preferência:

    • 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 episódio mais recente. Recomendado para programas diários ou relacionados a notícias.
    • TVSeason
      • O primeiro episódio da temporada. Recomendado para programas serializados.
      • 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 mudar) e resolver no 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:

    O episódio de destino se o usuário tiver assistido a temporada 6, episódio 24 pela última vez Selecionar um episódio se o usuário não tiver assistido nenhum
    Link direto da série
    • S6E24 (se o usuário não tiver concluído a 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 episódio que o usuário assistiu por último nessa temporada ou o primeiro episódio da temporada, se o usuário não tiver assistido nenhum episódio.
    • Primeiro episódio da temporada
    Link direto da temporada (S6)
    • S6E24 (se o usuário não tiver concluído a 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 conteúdo

Para as Ações de ouvir, 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, ele precisa reproduzir o conteúdo imediatamente ou com um clique após o login.
  • O app ou a plataforma precisa oferecer pelo menos uma maneira de todos os usuários ouvirem a música, o álbum, o artista ou a playlist.
    • Para usuários que não podem acessar o conteúdo exato (por exemplo, não têm a assinatura necessária), seu serviço precisa explicar o que o usuário precisa fazer para se qualificar para acessar o conteúdo exato ao chegar no app ou na plataforma.

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

  • Para MusicGroup, toque conteúdo diferente do artista sempre que um usuário selecionar o artista.
  • Para MusicAlbum, reproduza o conteúdo na ordem de aparição no álbum.
  • Para MusicPlaylist, toque conteúdo diferente da playlist sempre que um usuário a selecionar.

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 seu app ou 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 oferece suporte a vários idiomas de legenda?
    • O ponto de entrada oferece suporte a vários ângulos de câmera?
    • O ponto de entrada oferece suporte a vários formatos de vídeo?

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

Anterior
Coletar metadados
Próxima
Identifique o requisito de acesso