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

Функция автоподстановки имени позволяет автоматически вставлять имя пользователя 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 в «Описание параметров" второй параметр»). Есть словари:

• Общий словарь полных русских имен (без разделения по роду). Если попадается имя из этого списка, то определение рода будет проведено библиотекой lvovich.

• Словарь коротких имен с разделением на мужские и женские (маша, паша, петя). Если попадается имя из этого списка, то род заранее точно определен и библиотека lvovich лишь склонит его в нужный падеж.

Если имя гендерно-нейтральное (например Саша), то оно может попасться в первом списке, тогда род будет определен как нейтральный и склонение сделано верно.

3. Склонение в нужный падеж

4. Бесконечна
   Имя автоматически изменяется по правилам русского языка в зависимости от указанного падежа.
   

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

Формат для указания на сайте

Варианты указания подстановки имени на сайте

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

(может быть полезно, е

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

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

name

- Неизменяемый пДолжен быть ук
- з

Параметр.	Назан всегда. Обозначение
name	*обязатетльный н Название переменной для подстановки.
клиент	Значение по умолчанию, которое подставится в автоподстановке, если скриптмя не смог распознано
1 / 0	Регисть имя пользователя какр выводалидное.: 1 -– формат написания имени: 0– Значение Правило форматирования 1 С большой буквы 0 Сс маленькой буквы не указано К– как в орисходгином талексте dative - падеж: о? •genitive– – – – Ключевое слово Падеж Вопросы nominative Именительный кто? что? genitivedative РПадеж (поди вопросу): •nominative – ктельный – кого? •dative чего? dative Дательный кому? •accusative чему? accusative Винительный кого? •instrumental что? instrumental Творительный кем? •prepositional чем? prepositional Предложный о ком? о чём? Примеры укаиспользования части параметров: • Все параметры -– {{name | клиент | 1 | dative}} • Без второго параметра -– {{name || 0 | dative} • Без третьего параметра -– {{name | клиент || dative}} • Без второго и третьего параметра -– {{name ||| dative }} • Только название -– {{name}} Все параметры, кроме первого (name), являются опциональные Параметры пишутся по порядку. Если следующие параметры не нужны, можно ничего не писать. Если нужно пропустить параметр, – оставимьте на пустоего место пмеждустую строку и указываем разделительями |. Back to top