# AppMetrica: прямое подключение


{% note warning %}

Часть ресурсов, необходимых для прохождения практического руководства, доступны только в [регионе Россия](../../overview/concepts/region.md).

{% endnote %}


Вы можете визуализировать и исследовать данные AppMetrica в Yandex DataLens, используя следующие подходы:

* Прямой доступ.
  DataLens напрямую подключается к AppMetrica. Этот метод проще и быстрее всего, однако набор поддерживаемых функций [ограничен](../../datalens/function-ref/availability.md).
* Экспорт в режиме реального времени из AppMetrica в Managed Service for ClickHouse®.
  Доступны сырые данные и есть возможность предагрегации и постобработки данных на уровне БД. Для реализации этого варианта [настройте экспорт](https://appmetrica.yandex.ru/docs/common/cloud/about.html) и [создайте подключение](../../datalens/operations/connection/create-clickhouse.md) DataLens к БД ClickHouse®.

В этом сценарии используется прямой доступ. В качестве источника данных будет использовано приложение, которое добавлено в сервис [AppMetrica](https://appmetrica.yandex.ru). Просмотреть список доступных вам приложений можно в разделе [Приложения](https://appmetrica.yandex.ru/application/list).

Если у вас нет доступных приложений, то перед выполнением сценария вам необходимо [добавить приложение](https://appmetrica.yandex.ru/docs/quick-start/concepts/quick-start.html) или использовать стандартный **Дашборд AppMetrica**. 

Для визуализации и исследования данных [подготовьте DataLens к работе](#before-you-begin), затем выполните следующие шаги:

1. [Создайте подключение и стандартный дашборд](#create-dashboard).
1. [Измените стандартный дашборд](#edit-dashboard).

 

## Перед началом работы {#before-you-begin}

Чтобы начать работать с DataLens:


{% list tabs group=datalens_user %}

- Новый пользователь {#new}

  1. [Войдите](https://passport.yandex.ru/auth) в ваш аккаунт на Яндексе. Если у вас еще нет аккаунта, [создайте](https://yandex.ru/support/passport/authorization/registration.html) его.
  1. Откройте [главную страницу](https://datalens.ru/promo) DataLens.
  1. Нажмите **Начать в облаке**.
  1. Подтвердите, что ознакомились с [Условиями использования](https://yandex.ru/legal/cloud_termsofuse/?lang=ru) и принимаете их и нажмите кнопку **Войти**.

- Уже использую Yandex Cloud {#already}

  1. [Войдите](https://passport.yandex.ru/auth) в ваш аккаунт на Яндексе.
  1. Откройте [главную страницу](https://datalens.ru/promo) DataLens.
  1. Нажмите **Начать в облаке**.
  1. Выберите один из вариантов:

     * Если у вас уже есть организация, выберите ее в выпадающем меню на вкладке **Организации** и нажмите **DataLens**.

       {% note info %}

       Для активации экземпляра DataLens пользователю нужна роль `admin` или `owner`. Подробнее про роли смотрите в разделе [Управление доступом в Yandex Identity Hub](../../organization/security/index.md).

       {% endnote %}

     * Если у вас есть облако, но нет организации, нажмите **Добавить новый DataLens**. В открывшемся окне введите название и описание организации и нажмите **Создать организацию и DataLens**. Подробнее о работе с организациями смотрите в разделе [Начало работы с организациями](../../organization/quickstart.md).

{% endlist %}

Если у вас возник технический вопрос по работе сервиса, обратитесь в [службу поддержки](https://kz.center.yandex.cloud/support) Yandex Cloud. Чтобы спросить совета, обсудить решение вашей задачи или лучшие практики работы сервиса, напишите в чат [DataLens](https://t.me/YandexDataLens) в Telegram.


## Создайте подключение и стандартный дашборд {#create-dashboard}

{% note warning %}

Шаг доступен для пользователей, у которых есть приложение в сервисе AppMetrica. Если у вас нет приложений, откройте стандартный **Дашборд AppMetrica** и перейдите к [следующему шагу](#edit-dashboard).

{% endnote %}

1. Перейдите в [DataLens](https://datalens.ru/?skipPromo=true).
1. На панели слева выберите ![image](../../_assets/console-icons/thunderbolt.svg) **Подключения** и нажмите кнопку **Создать подключение**.
1. Выберите подключение **AppMetrica**.

    ![image](../../_assets/datalens/solution-06/03-choose-appmetrica.png)

1. Введите имя подключения `My AppMetrica` и нажмите кнопку **Получить токен**.

    ![image](../../_assets/datalens/solution-06/get-token.png)

    Если вы впервые создаете подключение к приложению в AppMetrica, то предоставьте сервису необходимые разрешения.

1. Выберите необходимое приложение из выпадающего списка.

    ![image](../../_assets/datalens/solution-06/select-an-app.png)
    
1. Задайте настройки подключения:

    ![image](../../_assets/datalens/solution-06/specify-fields.png)

    1. Задайте точность данных (сэмплирование). Вы можете изменить точность после создания подключения.
    1. Выберите тип подключения **Прямой доступ**.
    1. Включите опцию **Автоматически создать дашборд на данном подключении**.

1. В правом верхнем углу нажмите кнопку **Создать**.

    После создания подключения откроется папка с дашбордом и набором датасетов и чартов.

    {% note info %}
    
    * По умолчанию данные из AppMetrica выгружаются за последние 60 дней. Если в чарте добавить фильтр по дате, то фильтр AppMetrica будет сброшен. Рекомендуем добавлять фильтр по дате как смещение относительно текущей даты.
    * На стороне AppMetrica действует квота на количество одновременно исполняемых запросов для одного API key — 3.
    
    {% endnote %}

## Измените стандартный дашборд {#edit-dashboard}

{% note warning %}

Если у вас нет приложения в AppMetrica и вы пропустили предыдущий шаг, используйте **Дашборд AppMetrica**.

{% endnote %}

Вы можете изменять стандартный [дашборд](../../datalens/concepts/dashboard.md) так, как вам удобно. Например, вы можете удалить чарт, изменить его размер, сменить тип визуализации.

1. Откройте дашборд.

1. Нажмите кнопку **Редактировать** в правом верхнем углу.

    ![image](../../_assets/datalens/solution-06/05-edit-dashboard.png)

1. Чтобы удалить виджет **Динамика клик**, нажмите значок ![image](../../_assets/console-icons/xmark.svg) в правом верхнем углу.

    ![image](../../_assets/datalens/solution-06/06-specify-widgets.png)

1. Чтобы изменить размер виджета **Динамика установки**, потяните его за правый нижний угол.

1. Нажмите кнопку **Сохранить** в правом верхнем углу и сохраните дашборд.

     ![image](../../_assets/datalens/solution-06/07-save-dashboard.png)

Вы можете отредактировать любой чарт на дашборде. Например, измените тип визуализации для чарта **Рекламные сети** из раздела **Привлечение пользователей**.

Чтобы поделиться дашбордом или чартом, воспользуйтесь одним из способов:

* [Добавьте](../../datalens/security/add-new-user.md) пользователя в организацию или облако и предоставьте ему доступ к дашборду или чарту.
* [Выгрузите](../../datalens/qa/connections.md#uploading-data-logs-api) данные в кластер [Managed Service for ClickHouse®](../index.md) и используйте подключение к БД ClickHouse® в качестве источника. С тарифами сервиса Managed Service for ClickHouse® можно ознакомиться в разделе [Правила тарификации](../pricing.md).

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