# Передача данных из эндпоинта-источника Яндекс Метрика

{% note warning %}

Этот документ не применим для пользователей Yandex Cloud в [регионе Казахстан](../../../../overview/concepts/region.md). Смотрите полный перечень [поддерживаемых эндпоинтов](../../../transfer-matrix.md) в Data Transfer.

{% endnote %}

С помощью сервиса Data Transfer вы можете перенести данные из счетчика [Яндекс Метрика](https://metrika.yandex.ru/) в управляемую базу данных Yandex Cloud.

1. [Ознакомьтесь с возможными сценариями передачи данных](#scenarios).
1. [Настройте эндпоинт-источник](#endpoint-settings) в Yandex Data Transfer.
1. [Настройте один из поддерживаемых приемников данных](#supported-targets).
1. [Создайте](../../transfer.md#create) и [запустите](../../transfer.md#activate) трансфер.
1. Выполняйте необходимые действия по работе с базой и [контролируйте трансфер](../../monitoring.md).
1. При возникновении проблем, [воспользуйтесь готовыми решениями](../../../troubleshooting/index.md) по их устранению.

## Сценарии передачи данных из Яндекс Метрика {#scenarios}

С помощью сервиса Data Transfer вы можете перенести данные из счетчика [Яндекс Метрика](https://metrika.yandex.ru/) в кластер ClickHouse®. Такой перенос обеспечивает полноту переносимых данных из Яндекс Метрика и предоставляет возможности для:

* обработки данных средствами ClickHouse®;
* стриминга из ClickHouse® в другие локации;
* визуализации с помощью [Yandex DataLens](https://datalens.ru/promo) или других сервисов.

Смотрите [практическое руководство](../../../tutorials/metrika-to-clickhouse.md) по переносу данных из счетчика Яндекс Метрика в кластер ClickHouse®.

Подробное описание остальных возможных сценариев передачи данных в Yandex Data Transfer читайте в разделе [Практические руководства](../../../tutorials/index.md).

## Настройка эндпоинта-источника Metrica {#endpoint-settings}

{% note info %}

Передача данных из источника Яндекс Метрика возможна при подключении пакета [Метрика Про](https://yandex.ru/support/metrica/pro/intro.html) или использовании Data Streaming из Яндекс Метрики.

{% endnote %}

При [создании](../index.md#create) или [изменении](../index.md#update) эндпоинта задайте настройки доступа к сервису [Яндекс Метрика](https://metrika.yandex.ru/).

{% list tabs group=instructions %}

- Консоль управления {#console}

    * **Счётчики** — укажите [номера счетчиков](https://yandex.ru/support/metrica/general/tag-id.html), из которых будут поступать данные.
    * **Токен** — укажите токен для подтверждения доступа к счетчикам. Его можно получить по [ссылке](https://oauth.yandex.ru/authorize?response_type=token&client_id=36b7fc9aa96c4fa09158bcacbbdc796a).
    * (Опционально) укажите временной интервал, для которого надо произвести выгрузку данных. Эта возможность поддержана для трансферов типа **Копирование**. Конечная дата должна быть позже начальной даты на семь дней.
    * **Хиты** — выберите, передавать ли информацию о хитах.
        * **Поля** — выберите поля хита, которые нужно экспортировать. Помимо выбранных полей, всегда экспортируется несколько обязательных полей.
    * **Визиты** — выберите, передавать ли информацию о визитах.
        * **Поля** — выберите поля визита, которые нужно экспортировать. Помимо выбранных полей, всегда экспортируется несколько обязательных полей.

- Terraform {#tf}

    * Тип эндпоинта — `metrika_source`.

    * `counter_ids` — [номера счетчиков](https://yandex.ru/support/metrica/general/tag-id.html), из которых будут поступать данные.

    * `token.raw` — токен для подтверждения доступа к счетчикам. Его можно получить по [ссылке](https://oauth.yandex.ru/authorize?response_type=token&client_id=36b7fc9aa96c4fa09158bcacbbdc796a).

    * `streams` — параметры передаваемых данных:
      
      * `type` — тип данных. Укажите одно из значений:
      
          * `METRIKA_STREAM_TYPE_HITS` — хиты (необновляемые, устарело);
          * `METRIKA_STREAM_TYPE_HITS_V2` — хиты;
          * `METRIKA_STREAM_TYPE_VISITS` — визиты.
      
      * `columns` — список полей, которые нужно экспортировать. Их можно посмотреть в консоли управления. Помимо указанных полей всегда экспортируется несколько обязательных полей.

    Пример структуры конфигурационного файла:

    ```hcl
    resource "yandex_datatransfer_endpoint" "<имя_эндпоинта_в_Terraform>" {
      name = "<имя_эндпоинта>"
      settings {
        metrika_source {
          counter_ids = [<номера_счетчиков>]
          token {
            raw = "<токен>"
          }
          streams {
            type    = "<тип_данных>"
            columns = ["<список_полей>"]
          }
        }
      }
    }
    ```

- API {#api}

    * `counterIds` — [номера счетчиков](https://yandex.ru/support/metrica/general/tag-id.html), из которых будут поступать данные.

    * `token.raw` — токен для подтверждения доступа к счетчикам. Его можно получить по [ссылке](https://oauth.yandex.ru/authorize?response_type=token&client_id=36b7fc9aa96c4fa09158bcacbbdc796a).

    * `streams` — параметры передаваемых данных:
      
      * `type` — тип данных. Укажите одно из значений:
      
          * `METRIKA_STREAM_TYPE_HITS` — хиты (необновляемые, устарело);
          * `METRIKA_STREAM_TYPE_HITS_V2` — хиты;
          * `METRIKA_STREAM_TYPE_VISITS` — визиты.
      
      * `columns` — список полей, которые нужно экспортировать. Их можно посмотреть в консоли управления. Помимо указанных полей всегда экспортируется несколько обязательных полей.

{% endlist %}

Подробнее о настройках в [документации сервиса](https://yandex.ru/support/metrica/index.html).

## Настройка приемника данных {#supported-targets}

Настройте поддерживаемый приемник данных:

* [ClickHouse®](../target/clickhouse.md).

Полный список поддерживаемых источников и приемников в сервисе Yandex Data Transfer читайте в разделе [Доступные трансферы](../../../transfer-matrix.md).

После настройки источника и приемника данных [создайте и запустите трансфер](../../transfer.md#create).

_ClickHouse® является зарегистрированным товарным знаком [ClickHouse, Inc](https://clickhouse.com)._