Publicidade
O player pode exibir anúncios em vídeo por uma tag VAST ou VPAID, ou pelo Google IMA. Configure os anúncios com um parâmetro de URL ou pela IFrame API.
Para uma configuração básica sem a API, consulte Publicidade na documentação do produto. Esta página aborda a configuração programática.
Incorporação simples com adtagurl
<iframe
src="https://kinescope.io/embed/VIDEO_ID?adtagurl=https%3A%2F%2Fexample.com%2Fvast.xml"
allow="autoplay; fullscreen; picture-in-picture; encrypted-media; gyroscope; accelerometer; clipboard-write; screen-wake-lock;"
style="border: none;"
></iframe>
O valor de adtagurl deve ser codificado para URL. Esse parâmetro tem status @experimental.
IFrame API: playlist[].ad
Defina esse campo em create()
ou com setPlaylistItemOptions
.
Pre-roll a partir de uma URL de tag
playerFactory.create('player', {
url: 'https://kinescope.io/VIDEO_ID',
playlist: [
{
ad: {
adTagUrl: 'https://example.com/vast.xml',
},
},
],
})
Você pode passar um array de URLs: adTagUrl: ['https://…/a.xml', 'https://…/b.xml'].
Mid-roll e vários pontos
Para definir os pontos de anúncio, passe um array de itens com trigger:
playlist: [
{
ad: [
{
id: 'preroll',
adTagUrl: 'https://example.com/preroll.xml',
trigger: { percentages: [0] },
},
{
id: 'midroll',
adTagUrl: 'https://example.com/midroll.xml',
trigger: { timePoints: [60, 180] },
},
{
id: 'every-10-min',
adTagUrl: 'https://example.com/recurring.xml',
trigger: { interval: 600 }, // A cada 10 minutos
},
],
},
]
Campo de trigger | Descrição |
|---|---|
percentages | Percentual do tempo de reprodução atual, como [0, 50] |
timePoints | Tempo em segundos, como [60, 600] |
interval | Repete a cada N segundos, como 600 |
Defina um tipo de acionador em cada item de anúncio.
Opções de origem do anúncio
| Campo | Status | Descrição |
|---|---|---|
adTagUrl | Público | URL de tag VAST ou VPAID, ou um array de URLs |
adTag | @experimental | Texto completo da tag ou um array de tags |
adsRequest | @experimental | Objeto de solicitação (adsRequest) do Google IMA |
yaOptions | @experimental | Configurações do Yandex Video Ads SDK |
Use apenas um desses campos em cada item de anúncio.
Exemplo com o texto completo da tag:
ad: {
adTag: `<?xml version="1.0"?><VAST version="3.0">…</VAST>`,
}
Evento de intervalo de anúncio
player.on(player.Events.AdBreakStateChanged, (event) => {
if (event.data.active) {
// Um anúncio está sendo exibido
} else {
// O intervalo de anúncio terminou
}
})
O evento AdBreakStateChanged
tem status @experimental.
Próximos passos
- Controlar o player
— configure
playlist[].ade trate eventos - Criptografia DRM — consulte as limitações de proteção de conteúdo
- Publicidade em modelos de player — configure anúncios sem a API
- Incorporação simples com iframe — conheça outros parâmetros de URL