Yandex Metrica
Esta integração tem status
@beta. Acompanhe o histórico de alterações do player
.O player pode enviar eventos de visualização à Yandex Metrica. Crie uma meta no seu contador e ative a integração no player ou pela API.
Configurar uma meta na Metrica
Adicione uma meta nas configurações do contador:
| Campo | Valor |
|---|---|
| Nome | Qualquer nome claro |
| Tipo de condição | Evento JavaScript |
| ID da meta | Exatamente kinescope.video_event |
Ativar a integração no player
No painel: ative a integração com a Yandex Metrica nas configurações do player e informe o ID do contador.
Pela IFrame API: passe o ID do contador em settings.yandexMetrics ao chamar create()
:
playerFactory.create('player', {
url: 'https://kinescope.io/VIDEO_ID',
settings: { yandexMetrics: '000000000' },
})
Script de integração para iframe
Se o player é executado em um <iframe> por incorporação simples
ou pela IFrame API
, adicione:
https://player.kinescope.io/latest/iframe.ym.js
Insira o script depois do código da Yandex Metrica. Sem ele, os eventos do iframe não chegam à Metrica.
Exemplo de incorporação simples
<head>
<!-- 1. Yandex Metrica -->
<script>
// Código de inicialização do contador obtido na interface da Metrica
</script>
<!-- 2. Script de integração após a Metrica -->
<script src="https://player.kinescope.io/latest/iframe.ym.js"></script>
</head>
<body>
<iframe
src="https://kinescope.io/embed/VIDEO_ID"
allow="autoplay; fullscreen; picture-in-picture; encrypted-media; gyroscope; accelerometer; clipboard-write; screen-wake-lock;"
style="border: none;"
></iframe>
</body>
Nessa configuração, informe o ID do contador da Metrica nas configurações do player no painel.
Exemplo com a IFrame API
<html>
<head>
<!-- 1. Yandex Metrica -->
<script>
// Código de inicialização da Yandex Metrica
</script>
<!-- 2. Script de integração após a Metrica -->
<script src="https://player.kinescope.io/latest/iframe.ym.js"></script>
<!-- 3. IFrame API -->
<script>
function onKinescopeIframeAPIReady(playerFactory) {
playerFactory.create('player', {
url: 'https://kinescope.io/VIDEO_ID',
settings: { yandexMetrics: '000000000' },
})
}
</script>
<script async src="https://player.kinescope.io/latest/iframe.player.js"></script>
</head>
<body>
<div id="player"></div>
</body>
</html>
Próximos passos
- Google Analytics — envie eventos do player ao GA4 e ao GTM
- Incorporação simples com iframe
- Criar um player
— configure o parâmetro
settings