Anúncios puláveis de streaming de VOD

Neste guia, demonstramos como usar a API DAI para solicitar um stream de VOD com anúncios puláveis, renderizar o botão "Pular" de acordo com os requisitos do Google Ads e enviar os eventos de rastreamento associados.

Pré-requisitos

Fazer uma solicitação de anúncios puláveis

Para solicitar um stream de VOD com anúncios puláveis, é necessário transmitir o parâmetro dai-sas na sua solicitação de stream.

Endpoint da API

POST: /ondemand/v1/hls/content/{CMS_ID}/vid/{VIDEO_ID}/stream
Host: dai.google.com
Content-Type: application/x-www-form-urlencoded

Parâmetros de caminho

{CMS_ID} O ID do CMS do stream.
{VIDEO_ID} O ID do vídeo da transmissão.

Parâmetros do corpo

dai-sas Defina dai-sas=1 para ativar anúncios puláveis.

Exemplo de solicitação (cURL)

Para solicitações de stream HLS:

curl -X POST \
     -d 'dai-sas=1' \
     -H 'Content-Type: application/x-www-form-urlencoded' \
https://dai.google.com/ondemand/v1/hls/content/{CMS_ID}/vid/{VIDEO_ID}/stream

Substitua 'dash' no URL dos streams DASH:

https://dai.google.com/ondemand/v1/dash/content/{CMS_ID}/vid/{VIDEO_ID}/stream

Use o seguinte formato para incluir vários parâmetros de stream no corpo da solicitação:

-d 'dai-sas=1&cust_params=key1%3dvalue1%26key2%3dvalue2' \

Processar anúncios ignorados

Para processar anúncios pulados, use as informações no struct Ad ou AdBreak, dependendo se você está pulando o anúncio atual ou o intervalo de anúncio inteiro. Use o valor start, adicione o valor duration e procure esse ponto no fluxo. A submensagem SkipMetadata também inclui o valor offset, que é um valor em segundos antes de o anúncio ser ignorado. A submensagem SkipMetadata será incluída somente em anúncios puláveis.

ad_breaks Lista de intervalos de anúncio.
start (number) Posição no stream em que o intervalo começa, em segundos.
duration (number) Duração do intervalo de anúncio, em segundos.
ads (object(Ad)) Uma lista de anúncios no fluxo.
start (number) Posição no stream que o anúncio inicia, em segundos.
duration (number) Duração do anúncio, em segundos.
skip_metadata (object(SkipMetadata)) Metadados opcionais para anúncios puláveis. Se definido, isso indica que o anúncio é pulável e inclui instruções sobre como lidar com a interface de pulo e o evento de rastreamento.
offset (number) O deslocamento indica o tempo em segundos no anúncio que o player precisa aguardar para renderizar o botão "Pular". Omitido se não for fornecido no VAST.
tracking_url (string) Um URL que deve receber um ping no evento "skip".

Exemplo de resposta

{
  ...
  "ad_breaks":[
    {
      ...
      "start":0,
      "duration":10,
      "ads":[
        {
          ...
          "start":0,
          "duration":10,
          "skip_metadata":{
            "offset": 5,
            "tracking_url": "https://example_skip_url.com"
          }
        }
    }
}

Assim que o anúncio for pulado, dê um ping no URL do evento "pular" incluído na resposta do stream. Está incluída na submensagem SkipMetadata.

Requisitos do botão "Pular"

Para anúncios puláveis, renderize o botão "Pular" com os requisitos de design a seguir. O não cumprimento dessas exigências pode resultar em restrições para a veiculação de anúncios do Google no seu site ou aplicativo.

Contagem regressiva

O anúncio não pode ser pulável até o skipoffset horário especificado no VAST. Durante esse período, você precisa exibir um aviso ao usuário informando que o anúncio pode ser pulado em X segundos. O aviso precisa estar traduzido para o idioma do usuário.

Posição do botão "Pular"

Para usar idiomas escritos da esquerda para a direita, coloque o botão "Pular" no canto inferior direito do player de vídeo. Para idiomas escritos da direita para a esquerda, coloque o botão "Pular" no canto inferior esquerdo do player de vídeo.

Tamanho do botão "Pular"

O botão e o texto precisam ser grandes o suficiente para serem claramente legíveis em uma experiência relaxada.

Texto e ícone

O botão "Pular" precisa ter texto e iconografia. Você pode usar o ícone "Pular próximo material" como iconografia.

Acessibilidade

O usuário precisa conseguir navegar até o botão "Pular" usando um teclado ou controle remoto. O app vai focar no botão "Pular" quando a contagem regressiva for concluída.

Internacionalização

Recomendamos que você traduza o texto a ser pulado para o idioma do usuário.

Conjuntos de anúncios

O botão "Pular" pode ser usado para pular o anúncio atual no conjunto de anúncios ou ignorar todo o conjunto.

Traduções da opção "Pular anúncio"

Use o arquivo skipAdTranslations.json para traduzir o texto "Pular anúncio" com base na localidade do usuário.