Ativar anúncios puláveis em transmissões VOD

Este guia demonstra como usar a API DAI para solicitar uma transmissão de VOD com anúncios ignoráveis, renderizar o botão de pular de acordo com os requisitos do Google Ads e enviar os eventos de acompanhamento associados.

Pré-requisitos

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

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

endpoint de 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 do stream.

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 transmissão 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 por transmissões DASH:

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

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

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

Processar pular anúncios

Para processar a omissão de anúncios, use as informações na estrutura Ad ou AdBreak dependendo se você está pulando o anúncio atual ou todo o intervalo de anúncios. Pegue o valor start e adicione o valor duration. Em seguida, procure esse ponto no stream. A submensagem SkipMetadata também inclui o valor offset, que é um valor em segundos do tempo antes que o anúncio possa ser pulado. A submensagem SkipMetadata só será incluída em anúncios puláveis.

ad_breaks Uma lista de intervalos de anúncio.
start (número) Posição no stream em que o intervalo começa, em segundos.
duration (número) Duração do intervalo de anúncio, em segundos.
ads (object(Ad)): uma lista de anúncios no fluxo.
start (número) Posição no stream em que o anúncio começa, em segundos.
duration (número) Duração do anúncio, em segundos.
skip_metadata (object(SkipMetadata)) Metadados opcionais para anúncios puláveis. Se definido, indica que o anúncio pode ser pulado e inclui instruções sobre como processar a IU de pular e o evento de acompanhamento.
offset (número) O deslocamento indica o tempo em segundos que o player precisa esperar para renderizar o botão "Pular". Omitido se não for fornecido no VAST.
tracking_url (string) Um URL que precisa receber um ping no evento de salto.

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

Depois que o anúncio for pulado, envie um ping para o URL do evento de pulo incluído na resposta do fluxo. Ela está incluída na submensagem SkipMetadata.

Requisitos do botão de pular

Para anúncios puláveis, renderize o botão de pular com os seguintes requisitos de design. O não cumprimento desses requisitos pode resultar em restrições na veiculação de anúncios do Google no seu site ou app.

Timer de contagem regressiva

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

Posição do botão de pular

Para um idioma da esquerda para a direita, coloque o botão de pular no canto inferior direito do player de vídeo. Para um idioma da direita para a esquerda, coloque o botão de 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 legíveis em uma experiência de relaxamento.

Texto e ícone

O botão de pular precisa ter texto e ícones. Você pode usar o ícone de pular o próximo material como sua iconografia.

Acessibilidade

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

Internacionalização

É recomendável traduzir o texto de pular para o idioma do usuário.

Conjuntos de anúncios

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

Traduções de "Pular anúncio"

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