Промокарточка в чате

Промокарточка показывает ваше предложение внутри окна чата, обычно платный тариф. В ней изображение, заголовок, короткий текст, большая кнопка и текстовая ссылка под ней. Появляется вверху разговора, на главном экране чата или в обоих местах.

Карточка — не сообщение: её нет в истории разговора команды, посетитель не может её закрыть. Кнопка и текстовая ссылка открывают цель в новой вкладке.

Настройка

Промокарточка находится в аккаунте в Проект → Внешний вид → Промокарточка. Предпросмотр чата на этой странице показывает её во время ввода.

• Заголовок — обязателен, до 80 символов.
• Текст ниже — необязательно, до 200 символов.
• Изображение — необязательно, адрес начинается с https://. Без него карточка только текстовая.
• Текст кнопки — обязателен, до 40 символов, например «Попробовать бесплатно 30 дней».
• Ссылка кнопки — обязательна, страница перехода.
• Текстовая ссылка — необязательно, до 60 символов, например «Все тарифы». Если есть текст, обязательна и цель ссылки. Стрелку в конце виджет добавляет сам.
• Свой цвет кнопки и акцента — без флажка используется фирменный цвет. Текст кнопки автоматически светлый или тёмный для читаемости.
• Где показывать — «В разговоре, вверху» и/или «На главном экране». Для второго главный экран должен быть включён.
• Кто видит — все посетители или только неидентифицированные (ниже).

Для ссылки кнопки и цели ссылки используйте адреса с https:// в начале. Виджет показывает кнопку и текстовую ссылку только с https-целью.

Карточку можно включить только полностью заполненной: с заголовком, текстом кнопки, ссылкой кнопки и хотя бы одним местом. Если чего-то нет, сохраняется черновик, аккаунт сообщает недостающее.

Тексты действуют на языке проекта по умолчанию. После сохранения изменение доходит до посетителей в течение минуты.

Скрытие от платящих клиентов

Уже платящим клиентам не нужна реклама платного тарифа. reactive.chat не знает тарифы пользователей, но сайт знает. Есть три способа.

1. Аудитория «Только неидентифицированные посетители». Если сайт уже сообщает пользователей через ReactiveChat('identify', …) (с userId или email), они больше не видят карточку. Достаточно, если вход есть только у платящих клиентов.

2. Одна строка в скрипте страницы, как только известно, что пользователь платит:

ReactiveChat('promo', false);

Если она может выполниться до загрузки кода встраивания, добавьте перед ней:

window.ReactiveChat = window.ReactiveChat || function () { (window.ReactiveChat.q = window.ReactiveChat.q || []).push(arguments); };

3. Атрибут кода встраивания, если сервер и так выдаёт платящим клиентам другую страницу:

<script src="https://cdn.reactive.chat/loader.js"
        data-rc-site-key="SITE_KEY"
        data-rc-promo="false"
        async></script>

Оба переключателя действуют только на этой странице и только при текущем просмотре. ReactiveChat('promo', true) снова показывает карточку по настройкам аккаунта.

Изменение карточки для страницы

Вместо true или false можно передать объект. Его поля заменяют настройки аккаунта на этой странице; пропущенное берётся из аккаунта.

ReactiveChat('promo', {
  titel: 'Annual plan: 2 months free',
  knopf: 'Switch now',
  ziel: 'https://www.your-domain.com/pricing?annual=1'
});

Имена полей те же, что в аккаунте (немецкие):

• titel — заголовок (до 80 символов);
• text — текст ниже (до 200 символов);
• bild — адрес изображения с https://,
• knopf и ziel — текст кнопки (до 40 символов) и ссылка;
• link_text и link_ziel — текстовая ссылка (до 60 символов) и её цель;
• farbe — свой цвет как #rrggbb;
• orte — список "gespraech" (в разговоре) и "start" (главный экран); если не задан ни объектом, ни аккаунтом, действует ["gespraech"];
• zielgruppe — "alle" (все) или "anonym" (только неидентифицированные).

Можно также задать тексты по языкам, например titel: { en: 'Annual plan', de: 'Jahrestarif' }. Длинные тексты сокращаются.

Объект показывает карточку на странице, даже если в аккаунте она отключена. Тогда задайте всё самостоятельно: как минимум titel, для кнопки также knopf и ziel.

Показы и нажатия

В аккаунте под карточкой раздел Эффективность показывает показы, нажатия кнопки и ссылки, долю нажатий — суммарно за последние 7 и 30 дней и по дням. На посетителя в день учитывается до одного показа на место и одного нажатия на цель. Предпросмотр в аккаунте не учитывается, как и карточка, показанная только через ReactiveChat('promo', {...}), когда в аккаунте она отключена.

События для собственной аналитики

Два события в скрипте страницы дополнительно сообщают о карточке, например для передачи своей аналитике.

ReactiveChat('on', 'promo:shown', function (e) {
  // e.ort: "gespraech" (conversation) or "start" (start page)
});

ReactiveChat('on', 'promo:click', function (e) {
  // e.ziel: "knopf" (button) or "link" (text link), e.ort: "gespraech" or "start"
});

promo:shown срабатывает один раз на место и просмотр страницы, только когда окно с карточкой открыто. В закрытом чате карточку никто не видел. promo:click срабатывает при каждом нажатии кнопки или текстовой ссылки.

Если карточка не появляется

• Включена ли она? Незаполненная карточка остаётся черновиком.
• После сохранения проходит до минуты, прежде чем изменение увидят посетители.
• Место «Главный экран»: включён ли главный экран чата?
• Аудитория «Неидентифицированные»: если сайт сообщает посетителя через ReactiveChat('identify', …), карточка ему не видна.
• Отключена на странице? Проверьте data-rc-promo="false" в коде встраивания и ReactiveChat('promo', false) в скриптах.
• Нет кнопки или ссылки: цель начинается не с https://.

Открытие чата ссылкой или кнопкой на сайте описано в Открытии чата через собственную ссылку или кнопку. Основы встраивания — в Встраивании виджета.

Подробнее в документации

Подробное описание: Главный экран чата. Все главы собраны в документации.