Anúncios puláveis de streaming de VOD

Este guia demonstra como usar a API DAI para solicitar um stream de VOD com anúncios puláveis, renderize o botão "Pular" de acordo com Requisitos do Google Ads, e envie 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, você precisa transmitir o parâmetro dai-sas na sua solicitação de transmissão.

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 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 na solicitação corpo:

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

Processar anúncios ignorados

Para lidar com anúncios pulados, use as informações no Ad struct ou AdBreak struct, dependendo de você pular o anúncio atual ou todo o intervalo de anúncio. Pegue o valor start, adicione o valor duration e vá até esse ponto no fluxo. O SkipMetadata também inclui o valor offset, que é um valor em em segundos antes que o anúncio possa ser ignorado. A submensagem SkipMetadata só serão incluídas 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 anúncios. Se definido, indica que o anúncio é pulável e inclui instruções sobre como lidar com a interface de pular e o evento de acompanhamento.
offset (number) O deslocamento indica a quantidade de tempo em no anúncio, o player deve 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 ao pular evento.

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 o seguinte design e cumprimento de requisitos regulatórios. O não cumprimento desses requisitos pode resultar em restrições posicionados em anúncios do Google veiculados no seu site ou app.

Timer de contagem regressiva

O anúncio não pode ser pulável até o skipoffset horário especificado no VAST. Durante esse período, que não pode ser pulado, você precisa mostrar um aviso 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 "Pular"

Para um idioma da esquerda para a direita, coloque o botão "Pular" no canto inferior direito do o player de vídeo. Para um idioma da direita para a esquerda, coloque o botão "Pular" na 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 um local inclinada do usuário.

Texto e ícone

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

Acessibilidade

O usuário deve ser capaz de navegar até o botão "Pular" usando um teclado ou controle remoto. O app vai focar no botão "Pular" quando a contagem regressiva terminar. concluído.

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 em todo o conjunto.

"Pular anúncio" traduções

Usar O arquivo skipAdTranslations.json para traduzir a frase "Pular anúncio" com base na localidade do usuário.