# Яндекс Метрика


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

Интеграция в статусе `@beta`. Следите за [изменениями плеера](https://docs.kinescope.ru/dokumentaciya-pleera/izmeneniya/).



Плеер может сам отправлять события просмотра в Яндекс Метрику. Нужны цель в счётчике и включённая интеграция в плеере (или через API).

## Настройка цели в Метрике {#ym-setup}

В настройках счётчика добавьте цель:

| Поле | Значение |
| :--- | :--- |
| **Название** | Любое понятное вам |
| **Тип условия** | JavaScript-событие |
| **Идентификатор цели** | совпадает с `kinescope.video_event` |

## Включение в плеере {#player-setup}

**В панели управления** — в настройках плеера включите интеграцию с Яндекс Метрикой и укажите номер счётчика.

**Через IFrame API** — передайте номер счётчика в `settings.yandexMetrics` при [`create()`](https://docs.kinescope.ru/dokumentaciya-pleera/vstraivanie/iframe-api-sozdanie-pleera/#create):

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

## Скрипт интеграции для iframe {#PlayerSetupIframe}

Если плеер во `<iframe>` ([простое встраивание](https://docs.kinescope.ru/dokumentaciya-pleera/vstraivanie/prostoe-vstraivanie-iframe/) или [IFrame API](https://docs.kinescope.ru/dokumentaciya-pleera/vstraivanie/iframe-api/)), подключите:

`https://player.kinescope.io/latest/iframe.ym.js`

Скрипт должен идти **после** кода Яндекс Метрики. Без него события из iframe в Метрику не попадут.

### Пример: простое встраивание

```html
<head>
  <!-- 1. Яндекс Метрика -->
  <script>
    // Код инициализации счётчика из интерфейса Метрики
  </script>

  <!-- 2. Скрипт интеграции (после Метрики) -->
  <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>
```

Счётчик Метрики в этом случае задайте в [настройках плеера](#player-setup) в панели управления.

### Пример: IFrame API

```html
<html>
  <head>
    <!-- 1. Яндекс Метрика -->
    <script>
      // Код инициализации Яндекс Метрики...
    </script>

    <!-- 2. Скрипт интеграции (после Метрики) -->
    <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>
```

## Что дальше?

- [Google Analytics](https://docs.kinescope.ru/dokumentaciya-pleera/google-analytics/) — события плеера в GA4 и GTM
- [Простое встраивание](https://docs.kinescope.ru/dokumentaciya-pleera/vstraivanie/prostoe-vstraivanie-iframe/)
- [Создание плеера](https://docs.kinescope.ru/dokumentaciya-pleera/vstraivanie/iframe-api-sozdanie-pleera/) — параметр `settings`

