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
- Um app que implementa chamadas de API DAI para streams VOD. Consulte o Guia de stream de VOD da API DAI para mais informações.
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.
|
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.