Все приведенное ниже можно посмотреть в бизнесе 1 РЕХАУ Сервис в боте [Рехау Бот (ОСНОВНОЙ)](https://bots1.metabot24.com/bot/1010).
## Общая схема интеграции 1. **Настройка Яндекс.Метрики** — создаем счетчик и настраиваем цели для отслеживания; 2. **Добавление кода на сайт** — устанавливаем счетчик и специальный код на страницу с кнопкой перехода в Telegram; 3. **Настройка платформы Metabot** — создаем таблицу, маршрут, скрипт и плагин для обработки и передачи данных; 4. **Передача данных** — данные о конверсиях передаются обратно в Яндекс.Метрику для анализа.**Важно!** В текущей версии связь осуществляется через аккаунт Павла (@mr\_result). Для подключения новых счетчиков необходимо предоставить полный доступ к нужным счетчикам для пользователя **pavel.borisov@metabot.org** в настройках Яндекс Метрики.
## Шаги по настройке интеграции ### Создание счетчика и целей в Яндекс Метрике #### Создание счетчика 1. Перейдите на сайт[ Яндекс.Метрики](https://metrika.yandex.ru/) и войдите в свой аккаунт. 2. Нажмите на кнопку **Добавить счетчик**. 3. Заполните необходимые поля и получите код счетчика. 4. Установите код счетчика на все страницы вашего сайта, где планируется отслеживание. #### Создание цели 1. В настройках вашего счетчика перейдите в раздел **Цели** и нажмите **Добавить цель**. 2. Выберите тип цели **JavaScript-событие**. 3. Укажите **Название цели** и **Идентификатор цели** (например, tg\_bot). Идентификатор цели потребуется в дальнейшем. Пример настройки цели: - **Тип условия** — JavaScript-событие; - **Идентификатор цели** — tg\_bot; - **Название** — переход в Telegram-бот.**Примечание****:** Название и идентификатор цели могут быть любыми, но важно использовать корректный идентификатор в дальнейшем коде.
[](https://docs.metabot24.ru/uploads/images/gallery/2024-09/29TONqTH1V0FEtKV-image.png) ### Добавление кода на страницу Добавьте следующий код на страницу, с которой осуществляется переход в Telegram-бота: ```HTML ``` Пояснения: - **ВАШ\_НОМЕР\_СЧЕТЧИКА** — замените на номер вашего счетчика Яндекс Метрики; - **telegramBtn** — убедитесь, что кнопка перехода в бота имеет **id="telegramBtn"**. Если у нее другой id, измените его в коде; - **ВАШ\_БОТ** и **ВАШ\_ХЭШ** — замените на соответствующие значения вашего бота и хэша диплинка; - **ВАШ\_ИЦ** — укажите идентификатор цели, созданной ранее; Пример для нескольких кнопок: Если у вас есть несколько кнопок с разными целями, используйте следующий код: ```JavaScript // Кнопка 1 let telegramBtnLearning = document.getElementById('telegramBtnLearning'); if (telegramBtnLearning) { telegramBtnLearning.onclick = function () { window.location.href = 'https://bots1.metabot24.com/deeplink/telegram/ВАШ_БОТ/ХЭШ1?ym_client_id=' + clientID + '&ym_counter_id=' + ВАШ_НОМЕР_СЧЕТЧИКА + '&ym_target_name=ЦЕЛЬ1'; }; } else { console.error('Telegram button not found'); } // Кнопка 2 let telegramBtnBuyOriginal = document.getElementById('telegramBtnBuyOriginal'); if (telegramBtnBuyOriginal) { telegramBtnBuyOriginal.onclick = function () { window.location.href = 'https://bots1.metabot24.com/deeplink/telegram/ВАШ_БОТ/ХЭШ2?ym_client_id=' + clientID + '&ym_counter_id=' + ВАШ_НОМЕР_СЧЕТЧИКА + '&ym_target_name=ЦЕЛЬ2'; }; } else { console.error('Telegram button not found'); } ``` Пояснения: - Каждая кнопка имеет свой id и ссылается на разный диплинк и цель; - Замените **ХЭШ1**, **ХЭШ2**, **ЦЕЛЬ1**, **ЦЕЛЬ2** на соответствующие значения. ### Получение параметров в Metabot При переходе по диплинку в Metabot в атрибут **sys\_last\_script\_request\_params** запишутся следующие значения: ```JSON { "deeplink": { "hash": "ВАШ_ХЭШ", "name": "Название диплинка", "ym_client_id": "ИДЕНТИФИКАТОР_КЛИЕНТА", "ym_counter_id": "ВАШ_НОМЕР_СЧЕТЧИКА", "ym_target_name": "ВАШ_ИЦ" } } ``` ### Создание таблицы В Metabot создайте кастомную таблицу **ym\_conversion** со следующими полями: - **lead\_id** — ID лида; - **client\_id** — идентификатор клиента в Яндекс Метрике; - **counter\_id** — номер счетчика Яндекс Метрики; - **target** — идентификатор цели; - **is\_uploaded** — статус загрузки (0 — не загружено, 1 — загружено); - **created\_at** — дата и время создания записи. [](https://docs.metabot24.ru/uploads/images/gallery/2024-09/AhldlcweonIDalc1-image.png) ### Код для маршрутов Добавьте следующий код в соответствующий маршрут: ```JavaScript // Получение параметров последнего запроса let params = lead.getJsonAttr("sys_last_script_request_params"); // Извлечение данных из параметров let ymClientId = params?.deeplink?.ym_client_id || 0; let ymCounterId = params?.deeplink?.ym_counter_id || 0; let ymTargetName = params?.deeplink?.ym_target_name || ''; if (ymClientId !== 0) { lead.setAttr("ym_client_id", ymClientId); table.createItem("ym_conversion", { "lead_id": leadId, "client_id": ymClientId, "counter_id": ymCounterId, "target": ymTargetName }); } ``` Пояснения: - Извлекаем данные из **sys\_last\_script\_request\_params**; - Сохраняем данные в таблицу **ym\_conversion**. [](https://docs.metabot24.ru/uploads/images/gallery/2024-09/0nliuwBgfOihkBMY-1.jpg) ### Скрипт для отправки данных Создайте скрипт **send\_request\_ym** со следующим кодом: ```JavaScript const moment = require("moment"); // Подключение плагина YandexMetrika let yandexMetrika = snippet("Business.Integrations.YandexMetrika"); // Массив счетчиков let metrikaCounterIds = [ВАШ_НОМЕР_СЧЕТЧИКА1, ВАШ_НОМЕР_СЧЕТЧИКА2]; // Добавьте свои счетчики // Обработка каждого счетчика for (let metrikaCounterId of metrikaCounterIds) { // Получение данных для загрузки let conversionData = table.find("ym_conversion", [], [ ["is_uploaded", "=", 0], ["counter_id", "=", metrikaCounterId] ]); let processedData = []; if (conversionData.length) { for (let record of conversionData) { // Преобразование даты в Unix-время let unixTimestamp = moment(record.created_at).unix(); // Формирование объекта данных processedData.push({ "UserId": Number(record.lead_id), "ClientId": record.client_id.toString(), "Target": record.target, "DateTime": unixTimestamp }); } // Загрузка данных в Яндекс Метрику let uploadResponse = yandexMetrika.uploadData(processedData, metrikaCounterId); // Проверка статуса загрузки if (JSON.parse(uploadResponse?.body)?.uploading?.status === "UPLOADED") { for (let record of conversionData) { // Обновление статуса записи record.update({ "is_uploaded": 1 }); } } bot.sendMessage(JSON.stringify(uploadResponse)); } } // Перезапуск скрипта через 6 часов bot.runScriptByCodeForLead("send_request_ym", leadId, null, false, { "run_after_sec": 21600 }); ``` Пояснения: - Скрипт отправляет данные о конверсиях в Яндекс Метрику; - Использует плагин **YandexMetrika** для взаимодействия с API; - Запишите в маршрут с регулярным выражением **/metrika**; - Отключите опцию **Обрабатывать Deep Link**; - Перезапускается автоматически каждые 6 часов. ### Код плагина YandexMetrika 1\. В разделе **Плагины** перейдите в **Плагины бизнеса** — **Integrations**. 2\. Создайте плагин **YandexMetrika** (если он отсутствует) и добавьте ниже представленный код. ```JavaScript { _token: bot.getAttr("sys_yandex_metrika_token"), get token() { return this._token; }, set token(token) { this._token = token; }, uploadData: function(csvData, counterId, clientIdType = "CLIENT_ID") { require("Common.Integrations.Utils"); const utils = CommonIntegrationsUtils; const fileData = { "file_path": "file", "file_name": "data.csv" }; const headers = { "Authorization": `OAuth ${this._token}` }; const method = 'POST'; let uri = `https://api-metrika.yandex.net/management/v1/counter/${counterId}/offline_conversions/upload?client_id_type=${clientIdType}`; const jsonBody = {}; let response = utils.sendCsvFile(method, uri, jsonBody, csvData, fileData, headers); return response; } } ``` Пояснения: - Плагин обеспечивает взаимодействие с API Яндекс Метрики; - Необходимо указать OAuth-токен доступа. ### Добавление OAuth-токена Перейдите в настройки бота и добавьте атрибут **sys\_yandex\_metrika\_token** со значением вашего OAuth-токена Яндекс Метрики. ## Завершение настройки После выполнения всех шагов вы настроите интеграцию Яндекс Метрики с платформой Metabot. Теперь вы сможете отслеживать конверсии и переходы пользователей из вашего сайта в Telegram-бота. Примечания: - **Безопасность** — храните OAuth-токен в безопасности и не распространяйте его публично; - **Тестирование** — после настройки рекомендуем протестировать работу системы, чтобы убедиться в корректности данных. # OAuth-токен для Яндекс Метрики ### Зарегистрируйте приложение в Яндекс OAuth 1. Перейдите на [страницу регистрации](https://oauth.yandex.ru/client/new) приложений Яндекса. 2. Войдите в свой аккаунт Яндекса, если вы еще не авторизованы. ### Создайте новое приложение - **Название приложения** — укажите понятное название вашего приложения или проекта; - **Описание** — кратко опишите назначение приложения (опционально); - **Платформы** — выберите платформу, например, **Веб-сервисы**; - **Callback URI** — если требуется, укажите URL для обратного вызова (для серверных приложений это не обязательно). ### Укажите права доступа (Scope) 1. В разделе **Доступ к данным** выберите необходимые права для работы с Яндекс Метрикой: - **Яндекс Метрика (metrika)**: - **Метрика: чтение статистики** — для доступа к статистике; - **Метрика: редактирование счетчиков** — если нужно создавать или изменять счетчики; - **Метрика: управление конфигурацией** — для управления целями, фильтрами и прочими настройками; 2. Убедитесь, что выбранные права соответствуют вашим потребностям. ### Сохраните приложение 1. Нажмите кнопку **Создать приложение**. 2. После сохранения вы будете перенаправлены на страницу с информацией о вашем приложении. ### Получите идентификаторы - **ID приложения (Client ID)** — уникальный идентификатор вашего приложения; - **Пароль приложения (Client Secret)** — секретный ключ вашего приложения.**Важно!** Бережно храните **Client Secret** и не передавайте его третьим лицам.
### Получите OAuth-токен Существует два способа получения OAuth-токена: вручную через веб-интерфейс или программно через OAuth-протокол. #### Способ 1: Получение токена через веб-интерфейс (для личного использования) 1\. Перейдите по ссылке для получения токена, заменив **YOUR\_CLIENT\_ID** на ваш **Client ID**: