# Yandex Metrica


> **Информация:**

Esta integração tem status `@beta`. Acompanhe o [histórico de alterações do player](https://docs-br.kinescope.com/player-docs/changelog/).



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 {#configurar-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 {#ativar-integracao-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()`](https://docs-br.kinescope.com/player-docs/embedding/iframe-api-create-player/#create):

```js
playerFactory.create('player', {
  url: 'https://kinescope.io/VIDEO_ID',
  settings: { yandexMetrics: '000000000' },
})
```

## Script de integração para iframe {#script-de-integracao-para-iframe}

Se o player é executado em um `<iframe>` por [incorporação simples](https://docs-br.kinescope.com/player-docs/embedding/simple-iframe-embed/) ou pela [IFrame API](https://docs-br.kinescope.com/player-docs/embedding/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

```html
<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](#ativar-integracao-no-player) no painel.

### Exemplo com a IFrame API

```html
<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](https://docs-br.kinescope.com/player-docs/google-analytics/) — envie eventos do player ao GA4 e ao GTM
- [Incorporação simples com iframe](https://docs-br.kinescope.com/player-docs/embedding/simple-iframe-embed/)
- [Criar um player](https://docs-br.kinescope.com/player-docs/embedding/iframe-api-create-player/) — configure o parâmetro `settings`

