Skip to main content

Интеграция с Prodamus XL. Запуск воронок для пользователей Telegram-ботов

image.png

Для онлайн-школ и проектов, использующих Prodamus XL, появилоась решевозможние дляость запускать Сценарии напрямую чев с помощьюрез прокси-ссылок.и Vortex.

Возможности интеграции:

1)1. ЗАвтоматический запуск "Сценариев" для каждого ктопри открываетии прокси-ссылкуи или переходит внутри неё на страницыу конверсии:.

image.pngimage.png

2)2. Передача UTM-меток (уки URL-азанныхдресов:

  • startURL – с птартомощью нвашего сервиса) ия страница
  • conversionURL – страница, которыеуда посетирешёл пользователь
  • startURL, conversionURL

3)3. ИнРаботаеграцият с любым Telegram Telegram-ботом, разверподключёнутным нак платформеProdamus prodamus xlXL.

Инструкция по подключению:

Настройка на сторонев Prodamus XL:XL

1)Шаг Сфо1. Пермейдировать API ключе в "раздел «Настройках"и» и сформируйте API-ключ с правами:

доступа:
    "
  • Запуск Сценария",
  • "
  • Управление каналами чата".

Сам ключ сохранитье и скопируйте ключ – он понадобится вать. Vortex.

image.pngimage.png

2)Шаг 2. Проверьте подключение Telegram-ботьа

или у

Убедитесься, что нужный Telegram бот добавлен в разделе «Каналы чата».

Если его нет – подключитен в "Каналах чата".

image.pngimage.png

3)Шаг Пере3. Создайте пользовательские ватрибуты

Откройте карточку любого контакта в➡️ системе, "«Управление пользовательскими атрибутами"» и➡️ создайтье тдвам 2 доп.олнительных поля.
Н

Вазважниео: уключ них мдолжетн быть любое, указано поле "ключ" должно быть точно ткак указано ним же:

Для

    с
  • Стартовой страницы (основной) - startURL
    Для страницыа – startURL
  • Страница конверсии (куда переход)conversionURL
  • - conversionURL

Если допустить здесь оОшибка в значении ключа нарушит работу интеграция может быть нарушенаи!

image.pngimage.png

4)Шаг 4. Создайть нужные сСценарий

1. Перейдите во вкладкеу "«Настройки"» ➡️ «Сценарии».

После2. его сСозданияйте нужноый усценарий.

3. Убедитесься, что он включеён",.

а

4. затем сСкопировауйтье уникальный IdID сценария. – он будет использоваться в Vortex.

Важно! Сценарии из других вкладок вызывать не получддерживаются. ПриИспользуйте этомлько те, сцечто нарииходятся в "разделе «Настройках"и» – они работают дгля обалюбьной части проекта.

image.png

Настройка нав стороне Vortex:Vortex

image.png

0)0. Выберите тип интеграции

При создании прокси -ссылки выберите вариант "«Собственный бот".»


Убедитесь, что это тот же самый бот, с которым вый подклаючёнируете работать вк Prodamus XL!XL.

1)1. Вставьте ранее созданный и сохраненный API API-токен с нужными правами.

2)В Даполее «API-ключ Prodamus XL» вы можеставьте указать от 1 до 2 сценариев, которые нужно запускать. Для этого скопированный ранее токен.

2. Настройте запуск Сценариев

Вы можете запустить до эдвух сценариев по разным условиям:

  • При открытии WebApp
  • После перехода на страницу конверсии

Для каждого idукажите:

  • ID сценария
  • нужно вставить в поле с соответствующим условием и указать з
  • Задержку (в секундах), через которую он запустится

Пример:

  • Если пользователь не перешёл на страницу благодарности вр темчени.

    и X секунд после открытия webapp ➡️ запустить сценарий №123 через 10 секунд
  • Через X секунд после перехода пользователя на страницу благодарности ➡️ запустить сценарий №456 через 5 секунд

ЭГотово! всё, что нужно для иИнтеграциия настроена.

Передача UTM-меток

Если вЧтобы хотите передавать UTM-метки,:

  • Укажитое их нужно указывать либо внутри лURL прибо созданаружии прокси-ссылки, как делаили
  • д
  • Добавьте эснаружи, используя формат:
    t.me/ваш_богт/прило.

    жение?startapp=ID__utm_source=telegram__utm_medium=post

image.png

 пПоддерживаются все стандартные UTM-метки:

  • utm_source
  • utm_medium
  • utm_campaign
  • utm_term
  • utm_content

Для Ваш

Провего удобстврка мыподключения

р

Используйтеализовали кнопку "Пр«Обноверить статус подключения".» в интерфейсе Vortex.

Она позволякажет, быустро прановлерна лит связь, что между vortexVortex и вашим Prodamus XLXL.

настр

Рекомена связь и она работает. Обратите внимание, что перед использованием вам следуетм самостоятельно проверить, что все данные приходят и приходят корректно!:

• Откройте прокси-ссылку
• Пройдите путь клиента
• Проверьте карточку контакта в Prodamus XL

Как данные приходят нав prodamusProdamus XL:XL

После того как совершится конверсия тои в карточке контакта вы обнаружвидите:

заданны
  • Поле startURL – с главной страницы
  • Поле conversionURL – куда перешёл поля:

    ьзователь

image.pngimage.png

аА так же последние UTM-метки в раздеслие нажать на "«Источник"»:

image.pngimage.png

image.pngimage.png

Пр

Если возникновенили трудностейи обращайтесь в напишуите в тех.поддержку: https://t.me/televortex_support_bot@televortex_support_bot