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

Промокартка показує власну пропозицію всередині вікна чату — зазвичай платний тариф. Вона складається із зображення, заголовка, короткого тексту, великої кнопки й текстового посилання під нею. З’являється вгорі розмови, на головному екрані або в обох місцях.

Картка не є повідомленням: її немає в історії розмови для команди, а відвідувачі не можуть її закрити. Кнопка й текстове посилання відкривають ціль у новій вкладці.

Налаштування

Промокартка є в обліковому записі в розділі Проєкт → Вигляд → Промокартка. Попередній перегляд чату показує її під час введення.

• Заголовок — обов’язковий, до 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://.

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

Докладніше в документації

Докладно: Головний екран чату. Усі розділи є в документації.