Автоподстановка имени на сайте, открываемом через прокси-ссылку

Функция автоподстановки имени позволяет автоматически вставлять имя пользователя Telegram в текст сайта при переходе по прокси-ссылке. Это повышает персонализацию и вовлечённость.

Первоначальная настройка

Для корректной работы функции необходимо выполнить два условия:

1. Установите скрипт в HEAD страницы

<script type="text/javascript" src="https://app.vortex.pro/static/webapp_integration.js"></script>

2. Включите передачу системной UTM-метки с именем пользователя в настройках прокси-ссылки.

Подстановка может срабатывать и без этого условия, но если по прокси-ссылке зашел пользователь с новой версией Telegram (Bot API >= 9.0)

Как работает автоподстановка

Система анализирует имя пользователя и применяет следующие правила:

• Перевод с латиницы
  Если имя написано латинскими буквами (например, Ivan, Maria), оно преобразуется в кириллицу, если найдено в словаре.
  
• Проверка по словарю имён:

Общий словарь русских имён – определяет род с помощью библиотеки lvovich.

Словарь коротких имён с указанием пола (Маша, Паша, Петя) – род известен заранее.

Гендерно-нейтральные имена (Саша, Лёша) – обрабатываются как нейтральные, склонение применяется корректно.

Если имя не нашлось в словарях, то будет подставлено значение по умолчанию (см. параметр 2 в «Описание параметров»)

• Склонение в нужный падеж
  Имя автоматически изменяется по правилам русского языка в зависимости от указанного падежа.
  
• Динамическая подстановка
  Функция срабатывает не только при загрузке страницы, но и при любых изменениях в DOM (например, при открытии попапа или переключении вкладки).
  

Формат подстановки на сайте

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

Формат	Когда использовать
{{name | клиент | 1 | dative}}	Основной формат для большинства сайтов
%%name | клиент | 1 | dative%%	Если сайт использует React или блокирует фигурные скобки

Описание параметров

Параметр	Назначение
name	*обязательный Название переменной для подстановки.
клиент	Значение по умолчанию, если имя не распознано
1 / 0	Регистр вывода: 1 – с большой буквы 0 – с маленькой не указано – как в оригинале
dative	Падеж (по вопросу): •nominative – кто? •genitive – кого? •dative – кому? •accusative – кого? •instrumental – кем? •prepositional – о ком?

Примеры использования:

• Все параметры – {{name | клиент | 1 | dative}}

• Без второго параметра – {{name || 0 | dative}

• Без третьего параметра – {{name | клиент || dative}}

• Без второго и третьего параметра – {{name ||| dative }}

• Только название – {{name}}

Все параметры, кроме первого (name), являются опциональными.

Если нужно пропустить параметр – оставьте пустое место между разделителями |