Яндекс.Метрика для сайта
Яндекс Метрика
К сайту, созданному в Salebot, можно подключить Яндекс.Метрику. Для этого создайте счётчик в Яндекс.Метрике, создайте цель и укажите данные в настройках сайта:
ID Яндекс Метрики. Укажите ID счётчика Я.Метрики
Идентификатор цели в Яндекс Метрике. Укажите идентификатор цели события.
Если передадите идентификатор цели без нижнего подчеркивания в конце, для всех кнопок на минилендинге будет действовать одинаковая Цель, идентификатор которого передан в поле.
Если передадите идентификатор в виде "button_" со знаком "_" в конце, то цель будет отправлена для каждой кнопки мессенджера разная.
Например, настройка целей в Метрике: "button_0" - для ВКонтакте "button_1" - для Телеграм.
Идентификаторы мессенджеров для настроек на стороне Метрики: 0 - Вконтакте 1 - Телеграм 2 - Viber 3 - FaceBook* 6 - WhatsApp* 8 - Одноклассники 10 - Instagram*
*Facebook, WhatsApp, Instagram принадлежат Meta platform Inc., деятельность которой признана в РФ экстремистской и запрещена.
Пример как настроить на клики по кнопкам разных мессенджеров:
Настройки на стороне Яндекс.Метрика:
Как подключить Яндекс Метрику
Для подключения Метрики необходимо в первое поле вписать ID Яндекс Метрики.
Первое поле принимает в себя ID счетчика Яндекс Метрики, его вы можете увидеть на странице Яндекс Метрики в разделе “Сводка” вверху возле Имения счетчика и Адреса сайта, на рисунке выделено
Вставка ID счетчика равносильна добавлению “Код счетчика” на сайт
Это значительно сокращает время на интеграцию Яндекс Метрики в Ваш минилендинг. Во второе поле, в настройках минилендинга, вы можете вписать идентификатор Цели для отслеживания нажатий по кнопкам мессенджеров. Для этого вам следует создать цель/цели на сайте Яндекс Метрики. Чтобы это сделать, перейдите в раздел “Цели” и нажмите кнопку “Добавить цель”. У вас откроется попап меню для создания новой Цели.
В поле “Название” вы можете написать что угодно. В графе “Тип условия” нужно выбрать “JavaScript-событие”. После этого ниже появится поле “Идентификатор цели”. В него нужно занести идентификатор, который вы позже укажите в настройках минилендинга.
Цель будет срабатывать по нажатию на любую кнопку минилендинга.
Если вы хотите разделить цели по нажитию на разные кнопки минилендинга, название цели должно заканчиваться на знак подчеркивания "_"
Пример: Если вы передадите в наше поле “click_button”, тогда вам в Яндекс Метрику будет передаваться одна Цель по клику на любой из мессенджеров.
Цель с идентификатором “click_button”. Однако, если вы передадите в наше поле “click_button_” (у которого в конце стоит “_” знак нижнего подчеркивания), в вашу Яндекс Метрику будет передаваться разная цель для разного мессенджера,
click_button_0 - по клику на ВКонтакте click_button_1 - по клику на Телеграм click_button_2 - по клику на Viber click_button_3 - по клику на FaceBook* click_button_6 - по клику на WhatsApp* click_button_8 - по клику на Одноклассники click_button_10 - по клику на Instagram*
*Facebook, WhatsApp, Instagram принадлежат Meta platform Inc., деятельность которой признана в РФ экстремистской и запрещена.
Сам идентификатор может быть любой. Главное, чтобы в конце было нижнее подчеркивание. К нему будет добавлен индекс мессенджера.
Пример правильно заполненных полей в настройках сайта и правильно созданных целей в Яндекс Метрике:
Яндекс Метрика - оффлайн конверсии
Как создать счетчик Яндекс.Метрики?
Для начала сбора оффлайн конверсий в Яндекс.Метрику с Salebot необходимо зарегистрировать Яндекс.Метрику.
1. Если у Вас нет аккаунта Яндекс.Метрики, следует войти в ваш аккаунт Яндекс почты (или зарегистрировать новый). Далее перейти в Яндекс.Метрику и нажать добавить счетчик. В настройках счетчика указать следующие данные:
Имя счетчика
Адрес сайта - в примере ссылка на сайт Salebot (и далее пример будет построен на нем).
Автоматические цели и Вебвизор, карта скроллинга и аналитика форм - рекомендуем включить обе галочки для сбора большего количества информации.
После заполнения страницы жмем “Создать счетчик”. На открывшейся странице выбираете html-код и копируете весь код, появившийся внизу. Настройки для “Контентной аналитики” и “Электронной коммерции” устанавливайте на свое усмотрение, если они Вам необходимы. Копируем код и вставляем на сайт (см. чуть ниже). Затем нажимаем кнопку “Начать пользоваться”.
В настройках сайта, добавьте код во вкладке “Настройки” - “CSS и JS” - HTML-код head(или HTML-код body) и сохранить.
Далее нажмите "Сохранить".
Перейдите в меню Метрики, где видим список созданных счетчиков. Забираем номер счетчика и записываем его в переменную проекта ym_counter_id (настройки проекта - константы проекта)
2. Если у Вас есть аккаунт в Яндекс Метрике, то следует зайти в счетчик, по которому Вы хотите собирать статистику и записать его номер в переменную проекта ym_counter_id (настройки проекта - константы проекта). Настраивать счетчик заново Вам не нужно, просто вносим переменную как показано на скриншоте выше и переходим сразу к следующему пункту.
В созданном счетчике следует перейти в настройки - загрузка данных и включить передачу оффлайн конверсий.
Далее выйдет уведомление о том, что учет оффлайн конверсий станет доступен в течение суток. Следует помнить, что на данный момент обработка запросов может занимать до 24 часов и появится в статистике метрики лишь на следующие сутки. Сбор информации по цели доступен в течение 21 дней, далее данные будут затираться.
РЕГИСТРИРУЕМ ПРИЛОЖЕНИЕ ЯНДЕКСА И ПОЛУЧАЕМ ТОКЕН АВТОРИЗАЦИИ ДЛЯ ПОДКЛЮЧЕНИЯ API ЯНДЕКС.МЕТРИКИ К SALEBOT
Ссылка на документацию API Яндекс.Метрики, в которой описан Вызов API Яндекс.Метрики из браузера https://yandex.ru/dev/metrika/doc/api2/intro/browser.html
Для работы с API из браузера необходимо использовать авторизационный токен. Чтобы получить токен:
Создайте приложение, при этом заполните поля:
название — можно указать произвольно;
иконка сервиса — необязательно;
платформы приложения — выберите веб-сервисы;
redirect URI — укажите https://oauth.yandex.ru/verification_code;
доступ к данным — укажите metrika:read и metrika:write.
Нажмите Создать приложение и скопируйте его ClientID (напротив идентификатора нажмите значок
).Добавьте скопированный ClientID в ссылку вида
Перейдите по ссылке и на открывшейся странице скопируйте ваш авторизационный токен.
1) Регистрируем приложение Яндекса
Для получения данных для связи Яндекс Метрики с Salebot необходимо зарегистрировать приложение (по ссылке https://oauth.yandex.ru/client/new)
При переходе по ссылке откроется страница:
Далее заполняем данную форму:
Введите имя приложения. При желании добавьте иконку.
В подпункте “Платформы приложения” выберите веб-сервисы. Укажите
https://oauth.yandex.ru/verification_code
3. В подпункте “Доступ к данным” выберите поочередно metrika:read и metrika:write
ПРИМЕЧАНИЕ
Вы можете по своему усмотрению подключить и другие сервисы для приложения, если собираетесь использовать его где-то еще, однако стоит иметь ввиду, что часть пунктов сокращают жизнь токена авторизации до полугода, а то и до 7 дней
После нажатия на кнопку Создать приложение будет переход на следующую страницу:
Вы получаете данные для получения авторизационного токена для связи с API Salebot - ClientID. (в примере 04cb02016fa54163a9e14b5bb6e*****). Скопируйте его.
2) Получение токена авторизации
Для получения токена авторизации следует перейти по ссылке вида https://oauth.yandex.ru/authorize?response_type=token&client_id={clientID}
где {clientID} в ссылке замените на значение ClientID скопированный в шаге выше
В нашем случае, токен будет располагаться по ссылке "https://oauth.yandex.ru/authorize?response_type=token&client_id=04cb02016fa54163a9e14b5bb******" Перейдя по ней, вы увидите окно авторизации в приложение, и, подтвердив вход, получите окно с токеном. Сохраните его в переменные проекта(настройки проекта - константы проекта).
ВАЖНО!
Время жизни токена - год или меньше: зависит от настроек приложения. Через год необходимо будет заново перепройти по той же ссылке и сохранить новый токен авторизации на новый год.
Если при выполнении функций по связи с метрикой, Вы получите уведомление системы по типу “Expired or wrong token. Please, check or refresh your ym_oath_token”, повторите действия из этого пункта и замените токен.
Проверяем в настройках проекта все внесенные данные. Все готово, приступаем к настройке Целей.
Настройка целей
Итак, вы создали счетчик метрики.
1.Ручное создание цели в Яндекс. Метрике
Нажимаем создать цель - добавить цель.
В меню настройки целей:
задаем название цели - например, старт разговора с ботом.
Выбираем тип JavaScript-событие.
ВНИМАНИЕ!!! Сбор оффлайн-конверсий Яндекса работает только с этим типом целей. Оффлайн сбор информации по другим целям работать не будет!
3. Устанавливаем идентификатор цели - любое значение(цифры) - и ставим маркер на “совпадает”.
В примере идентификатором цели является число 666, этот идентификатор понадобится нам в будущем как переменная ym_js_event_id.
4. По желанию, Вы можете указать доход с цели
Нажимаем “добавить цель”.
2.Создание НОВОЙ цели через функцию в Salebot
Функция (API в калькуляторе) для создания новой цели ym_create_js_event_goal() работает только на тарифе Премиум!
В Salebot есть функция создания цели типа JS-событие, ym_create_js_event_goal(name,price, oauth_token,counter_id), где Обязательный параметр: ! name - это имя цели, обязательный параметр, строка Необязательные параметры: price - стоимость цели, необязательный параметр, число
Если у вас 2 и более аккаунта нужно передавать данные в параметрах:
oauth_token - токен авторизации
counter_id - номер счетчика
Обращаем внимание!
oauth_token и counter_id в параметрах функции приоритетнее тех, что указаны в настройках проекта.
Пример: Создадим две цели, одна(‘Haos goal’) - со стоимостью, другая(‘Free goal’) без нее
Результатом выполнения будет список, состоящий из номера цели (ym_goal_id), ее имени (ym_goal_name) и идентификатора отслеживания события (ym_js_event_id). В переменных также можно найти этот список с характеристиками целей. А в Яндекс Метрике появятся заявленные цели:
Дополнительно. Вывод информации обо всех целях в Salebot Если Вы запамятовали данные о своих целях в Яндекс Метрике и хотите вывести их все в переменную в Salebot, воспользуйтесь функцией ym_info_about_goals(ym_goal_id, oauth_token, counter_id), где
ym_goal_id - необязательный параметр.
Если параметр указан, то информация подгрузится о конкретной цели с данным идентификатором.
Если вы не хотите указывать данный параметр, то вместо него пропишите "None" (в кавычках!).
Если у вас 2 и более аккаунта нужно передавать данные в параметрах:
oauth_token - токен авторизации
counter_id - номер счетчика
Обращаем внимание!
oauth_token и counter_id в параметрах функции приоритетнее тех, что указаны в настройках проекта.
Пример:
Ответом является список, состоящий из словарей с goal_id, name, js_event_id всех целей. Если цель не является JS-событием, то js_event_id будет содержать ссылку/указание на соц. сеть/другой идентификатор. Если указать их при выгрузке конверсий, система Яндекс Метрики их просто не зачтет и вернет ошибку.
Информация об одной конкретной цели содержит словарь с данными.
Отправка оффлайн конверсий в Яндекс метрику
Функция (API в калькуляторе) для передачи офлайн-конверсий из бота ym_send_offline_conversions()
Для того чтобы отправить данные в Яндекс Метрики, следует использовать функцию ym_send_offline_conversions(js_event_id, client_id_type, time_delta, oauth_token, counter_id, comment ), где:
! ym_js_event_id
идентификатор отслеживания события, обязательный параметр, число.
client_id_type
позволяет использовать по выбору yclid или _ym_uid для идентификации пользователя. Для использования yclid в этом параметре передайте 'yclid', во всех иных случаях будет отрабатывать как раньше
time_delta
количество секунд, что необходимо вычесть из времени в которое выполняется функция. Чаще всего не требуется, но в редких случаях может помочь решить вопрос с конверсией, что пришла в "неподходящее" время. Подбирать параметр рекомендуется, начиная с 5.
Если у вас 2 и более аккаунта нужно передавать данные в параметрах:
oauth_token
токен авторизации
counter_id
номер счетчика
comment
необязательный параметр, комментарий. Максимальная длина — 255 символов. Допустимы цифры, латинские и кириллические буквы
Важно!
oauth_token и counter_id в параметрах функции приоритетнее тех, что указаны в настройках проекта.
ВАЖНО!
Отправка оффлайн-конверсий происходит по идентификатору клиента Яндекс. Если у клиента в переменных есть метка _ym_uid (как включить сбор меток в минилендингах смотрите в соответствующем разделе), он автоматически подставится в этот параметр и передаст статистику по данному клиенту.
С момента запуска бота до передачи офлайн-конверсии должно пройти достаточно времени для передачи метки _ym_uid в Метрику, например, от 5-10 минут.
_ym_uid - это clientID посетителя, присваиваемый Яндексом каждому пользователю. Он является уникальным и задается только системой Яндекс. Поэтому, если у клиента нет параметра, статистика по нему передаваться не будет. Однако, если у Вас есть данные о метке посетителя, Вы можете добавить клиенту переменную ya_client_id, и, если такой посетитель существует, статистика передастся.
Если клиента с номером, указанным в ya_client_id, не существует, то и статистика собираться не будет
Пример: Представим, у нас есть цели “Старт чата с ботом” и “клик по кнопке хорошо”
В боте у нас создан стартовый блок с приветствием и предложением нажать на две кнопки, нажатие на одну из которых(“хорошо”) приведет нас во второй блок с поздравлением.
Впишем в калькулятор функцию ym_send_offline_conversions("666"), где 666 - идентификатор(ym_js_event_id) цели “Старт чата с ботом”.
В блоке ниже, куда пользователь попадет при нажатии клавиши “Хорошо”, мы поставим ту же функцию с идентификатором второй цели - “клик по кнопке хорошо”.
Если посетитель с меткой _ym_uid прошел по этим этапам, статистика соберется и отправится в Яндекс Метрику, где потом будет обработана. Статус обработки до появления информации в статистике можно посмотреть в счетчике - настройки -загрузка данных.
Внимание!
Обработка может длиться до 24 часов! По итогу, при успешной загрузке появится значок “Выполнено”, при неуспешной - красная надпись. Это означает, что Яндекс Метрика не обнаружила клиента по заданному _ym_uid в своей системе.
Внимание!
Иногда системы Яндекса сбоят, и засчитывают загрузку на второй день после ее отправки, поэтому ошибочные загрузки могут выполниться через сутки после появления красной надписи, что увеличивает суммарное время обработки загрузок ДО 48 ЧАСОВ. Возможно, в будущем Яндекс починят свои лаги, но пока что следует учитывать их ошибки.
Если офлайн конверсии подключены меньше суток, то в ответ на запрос придет ошибка с указанием даты, когда данные могут быть загружены:
А в Метрике вы увидите ошибку:
Last updated