Работа с шаблонами
Добро пожаловать
В Личный кабинет
новые возможности
Управляйте своими картами с любого устройства!
маркетинг
Управляйте и планируйте события при помощи удобных инструментов!
простота в использовании
ВВедение
В данном документе описана общая инструкция по работе с личным кабинетом ОСМИ (OSMICards) и с электронными картами Wallet. Затронуты основные способы создания электронных карт, необходимые для успешной работы с маркетинговыми инструментами, предоставленными сервисом по созданию и настройке электронных карт.
Документ не является инструкцией для конкретного бизнеса, но может использоваться для работы с электронными картами ОСМИ, а также указывает на общие принципы работы в личном кабинете OSMI Cards.
Что такое электронные карты?
Рис. 2
1. Прекращение работы с картой и возврат ее в список других доступных карт;
2. Переход на оборотную сторону карты;
3. Возврат на лицевую сторону карты;
4. Поделиться картой, например, по электронной почте. Данная функция может отсутствовать если возможность поделиться картой была запрещена в шаблоне карты;
5. Время последнего обновления карты, когда информация на карте изменилась. (Не путать со временем последней проверки на наличие обновлений).
6. Настроить карту получать уведомления (push) от сервера о наличии доступных к загрузке обновлений. Если выключено, то обновить карту можно только вручную, протянув ее пальцем вниз на оборотной стороне.
7. Скрытный режим загрузки обновлений карты с сервера. Запрещает показ уведомлений на заблокированном экране телефона при обновлении карты с новым содержимым.
8. Удалить карту с телефона. Стирает карту с телефона, но не удаляет карту ни в CRM, ни на сервере ОСМИ.
9. Логотип. Картинка в формате PNG. Задается как часть дизайна карты (см. Шаблоны).
10. Центральная картинка. Картинка в формате PNG. Задается как часть дизайна карты (см. Шаблоны).
11. Название поля на карте - "Ярлык". Задается как часть дизайна карты (см. Шаблоны).
12. Содержимое поля на карте - "Данные".
a. На лицевой стороне карты строка данных распознается телефоном только как текст и не может содержать в себе активные элементы, такие как ссылки на сайты и активные телефонные номера, при нажатии начинающие звонок.
b. На оборотной стороне карты в тексте поля возможны активные элементы, такие как ссылки на сайты, телефонные номера, адреса. При нажатии на них откроется браузер для перехода на сайт, или телефон, чтобы сделать звонок, или карта.
13. Описание карты. Задается как часть дизайна карты (см. Шаблоны).
14. Баркод.
a. Вид баркода (Code128, PDF417, QR, Aztec), кодировка текста в нем и показ/запрет показа его на карте глобально задаются как часть дизайна карты (см. Шаблоны).
b. Тип содержимого (т.е. какую информацию можно занести в баркод) задаётся как часть дизайна карты (см Шаблоны). Доступны либо Произвольный Текст (Данные), либо Серийный Номер электронной карты ОСМИ (не путать со штрих кодом в 1С).
c. Если показ баркода в шаблоне включен, то на карте его можно выключить, но не наоборот.
15. Подпись под баркодом.
a. Показ/запрет показа подписи на карте глобально задаются как часть дизайна карты (см. Шаблоны).
b. Если содержимое баркода отсутствует или его показ запрещен, то и подпись под баркодом показана не будет независимо от ее типа и содержания.
c. Если показ подписи под баркодом в шаблоне включен, то на карте его можно выключить, но не наоборот.
Структура и формат данных, дизайн и шаблоны
Каждому созданному в ЛК ОСМИ дизайну присваивается уникальное имя, и обращение к этому дизайну из CRM идет по этому имени. Другое название созданного дизайна с уникальным именем – Шаблон карты. Далее в документе для описания такого дизайна используется термин Шаблон Карты.
Шаблон карты можно представить себе как лист бумаги формата А4, у которого есть лицевая и оборотная стороны. Лист бумаги на обеих сторонах разделен на секции. В одной из секций (в нижней зоне лицевой стороны) может быть размещен баркод, если он разрешен к показу и у него есть содержимое, то есть имеется что показывать. Другие секции на лицевой и оборотной стороне называются Полями. Каждое поле предназначено для вывода текстовой информации в определенную позицию карты. Каждое поле имеет Имя (ярлык), по которому можно обращаться к этому полю. У каждого поля есть свойство (Сообщение), которое напрямую влияет, будет ли показано всплывающее сообщение на заблокированном экране телефона (его еще не корректно называют пушем) при обновлении содержимого данного поля.
В поля на лицевой стороне карты можно выводить только текстовую информацию. Вывод активных ссылок в поля на лицевой стороне карты не поддерживается. Но можно выводить все существующие эмодзи.
В поля на оборотной стороне можно выводить информацию, содержащую эмодзи, активные ссылки на вебсайты, телефоны и адреса.
Так как имена полей (ярлыки) используются для доступа к соответствующему полю, то эти имена полей в шаблоне должны быть уникальны. При доступе к полю нужно абсолютно точно указывать его название как оно прописано в шаблоне карты. Например, если в шаблоне карты есть поле "Баланс", то и обратиться к нему из CRM можно только по имени "Баланс". Если же обратиться к нему по имени "баланс" с маленькой буквой "б", то вернется ошибка, так как такого поля в шаблоне карты нет. Иными словами, название поля (ярлык) является регистрозависимым.
Еще следует учитывать тот факт, что при отображении на телефоне названия полей на лицевой стороне карты всегда переводятся в верхний регистр самим телефоном. То есть, если в шаблоне карты поле называется "Владелец", то и обращаться к нему из CRM надо с использованием имени поля "Владелец", хотя на телефоне это поле будут показано как "ВЛАДЕЛЕЦ." На оборотной стороне карты такого перевода названия поля в верхний регистр не происходит и названия полей всегда отображаются так же, как и в шаблоне карты.
Создание электронных карт
Если позже в Личном Кабинете сервиса OSMICards, маркетолог/сотрудник изменит название поля в шаблоне карты, то CRM система сама по себе об этом не узнает и могут быть проблемы, например с обновлением или отображением баланса на карте.
Установка на телефон
Для того, чтобы установить уже созданную электронную карту на телефон, ссылку на ее установку можно отправить клиенту по СМС, по электронной почте или, например, через вебсайт.
Если планируется отправлять ссылки на карты клиентам по СМС и/или использовать функцию проверки номера телефона при электронном анкетировании, то у бизнеса должен уже быть в наличии действующий СМС провайдер для отправки СМС, и его параметры необходимо настроить в Личном Кабинете сервиса OSMICards. Сам сервис OSMICards может работать более чем с полусотней СМС провайдеров, но сам СМС провайдером не является.
При получении ссылки на установку карты, клиент должен открыть ее на мобильном телефоне и пройти по ней. Далее процесс зависит от модели телефона (iPhone или Android).
В случае с iPhone на экране телефона отобразится электронная карта с предложением ее установить (добавить). Если клиент добавит карту, то далее она доступна в приложении Wallet для просмотра и предъявления на кассе.
В случае с Андроид клиенту будет предложено добавить карту либо в одну из четырех установленных программ (см выше), либо автоматически перейти на Google Play, один раз установить приложение и открыть его. Далее карта появится в приложении автоматически.
РАБОТА с Личным кабинетом
ДОМАШНЯЯ СТРАНИЦА ЛК
Также хочется отметить, что теперь вы будете получать уведомления о крупных обновления личного кабинета и другую важную информацию. Данные уведомление можно посмотреть, если нажать на конверт в правом углу экрана. После прочтения, вы можете убрать данное уведомление нажав кнопку "В Архив", в том случае если вы хотите оставить данное сообщение просто нажмите на крестик либо нажмите по затемненному фону.
Выберете интересующий вас раздел, что бы изучить его поподробнее!
Работа с картами
Работа с Push Событиями
В этом разделе мы вам расскажем, как создать и изменить динамическую акцию а также о работе с PUSH уведомлениями
работа с отчетами и кабинетом
В этом разделе мы вам расскажем, как работать с кабинетом и отчетами по вашим картам
РАБОТА С ГРАФИКОЙ
При подготовке графики для создания шаблонов типа "Карта" следует руководствоваться следующими требованиями:
- Push-иконка: обязательно на непрозрачном фоне, размер картинки 114х114 px (ширина, высота), формат файла – PNG, вес файла – не более 1 Мб.
- Логотип: желательно на прозрачном фоне, размер картинки от 100х100 px до 100х320 px (ширина, высота), формат файла – PNG, вес файла – не более 1 Мб.
- Центральный банер: фон – в зависимости от стратегии, выбранной дизайнером (можно прозрачный, можно сплошной), размер картинки 624x246 px (ширина, высота), формат файла – PNG, вес файла – не более 1 Мб.
Если же вы хотите создать карту другого подтипа, то вам придется использовать следующие параметры:
КАРТА
- Пуш иконка 114х114. Обязательна
- Логотип От 100х100 до 320х100. Не обязателен
- Центральная картинка 624х246. Не обязательна
КУПОН
- Пуш иконка 114х114. Обязательна
- Логотип От 100х100 до 320х100. Не обязателен
- Центральная картинка 624х246. Не обязательна
БИЛЕТ
- Пуш иконка 114х114. Обязательна
- Логотип От 100х100 до 320х100. Не обязателен
- Центральная картинка 750х196. Не обязательна
БИЛЕТ С ФОНОМ И ВСТАВКОЙ
- Пуш иконка 114х114. Обязательна
- Логотип От 100х100 до 320х100. Не обязателен
- Бэкграунд 180х220. Не обязателен. При отображении автоматически размывается.
- Вставка 90х90. Не обязательна
ПОСАДОЧНЫЙ ТАЛОН
- Пуш иконка 114х114. Обязательна
- Футер 572х30. Не обязателен
Чтобы добавить изображение нажмите на выделенную серым цветом область под наименованием назначения изображения.
Чтобы заменить изображение вам нужно нажать по подлежащему замене графическому элементу и выбрать в замен ему другой элемент
Чтобы удалить тот или иной графический Элемент вам нужно всего лишь нажать на кнопку "Сбросить" под выбранным вами элементом, помните что система не позволит сохранить шаблон без наличия загруженной PUSH иконки!
В том случае, если при загрузке графики вы увидели красный значок оповещающий о превышении разрешения или о не корректном формате, вы можете воспользоваться встроенным графическим редактором, который поможет вам в пару кликов из JPG сделать PNG изображение, подогнать его под необходимое разрешение, а так же выставить правильный ракурс у вашего изображения.
Для выставления нужного для графики разрешения поставьте галочку в соответствующем пункте, затем передвиньте в нижней части экрана рамку и с помощью верхнего ползунка поправьте ракурс изображения при необходимости.
Чтобы изменить цвета Фона, Текста и Ярлыка необходимо нажать на область с примером цвета и выбрать необходимый вам цвет.
Справа на экране мы с вами можем увидеть окно предпросмотра графики, с помощью него мы можем увидеть, как будет выглядеть ваша карта c лицевой и оборотной стороны, на устройствах участников вашей программы лояльности.
Обратите внимание! :
Если не следовать рекомендуемым размерам, то телефон все равно отобразит картинки, только они могут быть автоматически обрезаны и/или растянуты в непредсказуемой пропорции.
Обязательно создавайте иконку с непрозрачным фоном, иначе телефон сам выберет максимально контрастный фон для иконки при ее отображении в PUSH-сообщении.
Будьте особенно внимательны при выборе дизайна иконки для Push-уведомлений. Сменить дизайн позже для всех пользователей ваших карт может стать достаточно трудоемкой задачей, так как iPhone запоминает иконку из первой карты конкретного шаблона, если у вас стоят две карты разных шаблонов, то они могут иметь разные push иконки, но если вы поменяете Push иконку, она не обновиться на устройствах где уже установлена карта, но на тех устройствах, куда карты будут установлены после смены Push иконки, получат карту с новой push иконкой. Для смены Push иконки ваших старых клиентов, необходимо переустановить карту в Wallet. Для телефонов на базе Android нет трудностей с обновлением Push Иконки.
Файл иконки обязательно загружать в процессе создания шаблона карты! Если не загрузить иконку для PUSH-уведомлений, то электронная карта НЕ УСТАНОВИТСЯ на iPhone. Если не загрузить графику для иконки, в настройке шаблона карты появится предупреждение.
РАБОТА С ПОЛЯМИ
На электронных картах есть несколько видов полей:
ЗАГОЛОВОЧНЫЕ ПОЛЯ
При нажатии кнопки "Добавить Поле" у нас появляется активная вкладка "Поле #..", всего таких вкладок в "Заголовочном поле" может быть до трех штук. Для начала редактирования данного поля нам достаточно просто на него нажать, теперь мы с вами можем видеть такие поля как Ярлык, Данные и Сообщение.
при необходимости вы можете скрыть поле ярлык, поставив галочку в поле "Скрыть ярлык"
Если вы скрыли поле "Ярлык" оно не будет отображаться на карте, но данные из вашей CRM будут выводиться в поле "Данные" на вашем шаблоне.
Поле сообщение - это поле, данные из которого будут отображаться в пуше при обновлении данных в указанном вами поле. Например к полю ярлык у вас привязан бонусный баланс вашего клиента и при обновлении в CRM бонусного баланса по данному клиенту ему придет сообщение - "Ваш бонусный баланс: 100 баллов" для того что бы баллы отобразились в данном оповещении необходимо указать в поле сообщения, на том месте где должны быть данные по клиентскому балансу формулу "%@", как указано в примере в поле "Сообщение", только в этом случае баланс клиента отобразиться в пуше.
Просим обратить внимание:
Если в тексте сообщения не указаны символы %@, то Push-сообщение при изменении поля данных не появится.
Отображение этого поля осуществляется в верхней части Вашей карты, это можно увидеть на нижеприведенном примере.
Основные поля
Данные из поля "Ярлык" и поля "Данные" накладываются поверх "Центрального изображения", и не имеют возможности смены цвета, по умолчанию, цвет для данного поля белый!
Второстепенные поля
Настройка Баркода
Оборотная сторона
Оборотная сторона поддерживает кликабельные ссылки, для создания гиперссылки вам нужно выделить ту часть текста, которую вы хотите превратить в ссылку и нажать на значок цепочки, в открывшемся окне введите данные для ссылки, в случае с номерами телефона вам необходимо ввести данные в следующем формате - tel: ваш номер телефона, так же вы можете выводить ссылку на email, но тогда потребуется ввести следующую формулу - mailto: ваш адрес электронной почты. Также доступна возможность скрывать поле "Ярлык".
Обратите внимание!
Если вы ввели ссылку в формате "mysite.com" она не будет кликабельна на устройствах Iphone, корректный вид ссылки "https://mysite.com" в данном случае ссылка будет работать на оборотной стороне карты.
Помните, что при открытии wallet быстрым вызовом (двойное нажатие кнопки блокировки, либо двойное нажатие кнопки HOME) ссылки на оборотной стороне становятся неактивными, для полноценной работы с картами вам нужно перейти в приложение Wallet.
Помните, если вы не заполните поле "Ярлык", но заполните поле "Данные", то сохранить шаблон будет невозможно!
Настройка Приложений
Если вдруг по каким то причинам у вас пропало соединение с интернетом и ваша работа прервалась, не переживайте вы всегда можете вернуться и продолжить работу над созданием и редактированием шаблона, для этого нажмите кнопку Создать шаблон, а затем Продолжить создание.
Редактирование Шаблона
Для более удобного поиска по шаблонам вы всегда можете переключить их вид отображения на список нажав на переключатель, который расположен в левом верхнем углу рядом с надписью "Список доступных шаблонов".
Обратите внимание, что если Вы работаете на CRM IIko card5 или Rkeeper CRM7, и Вы планируете внести изменение в поле Ярлык, то просим вас создать заявку на Support, что бы мы сменили привязку на новое поле, в том случае, если Вы смените наименование поля и не сообщите нам об этом, оно не будет обновляться и отображать текущую информацию!
Для того что бы удалить гео-метку, перейдите в соответствующий пункт меню редактирования шаблонов, а именно "Настройка геолокации" нажмите на значок корзины для удаления метки. Если вам нужно удалить не все метки нажмите кнопку "Применить гео точки к существующим картам шаблона", в том случае если вы решили удалить все метки поставьте метку в поле "Стереть гео точки в существующих картах шаблона" после чего при необходимости поставьте галочку в поле "Послать нотификацию"
На ниже приведенном изображении вы можете увидеть прогресс-бар, и сообщение о необходимости подождать завершения предыдущих операций.
Поиск по содержимому
Данный метод позволяет найти значения из поля данные на ваших картах, на примере выше видно что при поиске по содержимому находиться тестовая карта, из этого меню можно сразу осуществить редактирование той или иной карты.
ПОиск по номеру
При поиске по номеру карты, вам необходимо ввести точный номер карты, так как поиск карт осуществляется по точному совпадению, также при необходимости мы можем отредактировать данную карту или удалить ее.
Удаленно стереть карту с телефона пользователя невозможно. Если карта была удалена из системы но осталась в телефоне, то коммуникация с такой картой невозможна даже если новая карта с таким же номером была создана в сервисе. Необходимо выдать карту заново и установить ее на телефон.
Редактирование карт
Обратите внимание что при редактировании карт Вы не можете менять поле ярлык, Вы можете вносить изменения только в поле данные при редактировании полей.
Начав редактирование карты у нас открывается поле "Общие настройки", в данном меню мы видим статистику по данной карте, когда она была создана в системе, когда последний раз карта была обновлена со стороны сервера и последний раз просмотрена, так же на данном этапе можно запретить делиться выбранной картой.
Статус:
- Создана - дата создания текущей карты на сервере
- Обновлена - Дата когда карта получила последнее обновление на сервер из CRM
- Просмотрена - Дата и время события, когда телефон загрузил с сервера в Wallet карту с обновленным содержимым.
- Устройства - Количество устройств где установлена карта
- Шаблон - Отображает наименование шаблона на который установлена данная карта
В таком случае баркод не будет распознаваться вашей CRM при сканировании.
При активной Динамической акции вы всегда можете посмотреть, как на данный момент выглядит карта того или иного шаблона\конкретной карты клиента.
Отправить карту
- Отправить карту по номеру телефона средством СМС;
- Отправить карту на почту ;
- Установить карту сразу с помощью QR кода ;
- Отправить или передать клиенту ссылку на установку его карты .
Предварительно необходимо убедиться что у вас в личном кабинете настроена почтовый сервис и СМС-провайдер
Переместить карту
История карт
Давайте рассмотрим это на следующем примере:
На этом изображении вы можете увидеть, что сначала карта была создана в ЛК, затем на этой карте были обновлены значения, после этого данную карту установили на телефон и были доставлены на карту обновленные значения, а затем запустили маркетинговый пуш (PUSH-события), а далее запустили динамическую акцию, были доставлены пуши об этой акции, эта акция завершилась, и на карту были доставлены новые значения. Также существуют другие события, их описания представлены ниже.
Разбор частых сценариев по диагностике проблем смотрите на FAQ
Проверка через IIko CRM
Синем выделены данные из Iiko Crm. Данные под чертой покажут к какому полю какие данные привязаны.
Если на против названия поля стоит зеленая галочка, то поле на карте найдено и туда транслируются соответствующие данные из вашей CRM, а в том случае если у вас появился красный треугольник на против того или иного поля, это свидетельствует о том, что поле либо отсутствует на карте, либо указано не правильно. Если навести курсор на красный треугольник, то вы увидите интерактивную подсказку.
Важно:
В том случае если под чертой отсутствуют данные, это свидетельствует о том, что привязка кошельков Iiko с полями карты еще не настроена.
Копирование PUSH Событий
Создание Push События
В поле "Для каких карт" Вы можете выбрать один из следующих способов:
- Выбрать определенные карты для отправки им уведомления, их необходимо указывать через запятую; Максимальное количество номеров - 1 000 шт.
- Загрузить CSV файл и сделать рассылку по нему; Максимальное количество номеров - 100 000 шт.
- Отправить Push всем картам, на определенный шаблон;
- Отправить Push Всем активным картам.
После того как вы заполнили все необходимые данные для отправки Push уведомлений, вам нужно нажать кнопку "Создать Push" она расположена в Правом нижнем углу.
Внимание:
- Тип события, после создания изменить нельзя!
- Push Сообщение создается на 24 часа, все новые карты, которые будут установлены в момент активности Push события, получат уведомление!
Динамическая акция
Для Создания "Динамической акции" нам нужно выбрать соответствующий пункт в Поле "Тип События". Поле Описание также, как и в случае с Push сообщением отвечает за название данного события в календаре, Поле "Текст Push-сообщения" идентично. Поля "дата начала\окончания" отвечают соответственно за начало и окончания работы акции, в том случае если поле Дата окончания не задано, акция закончит действие только после того, как вы вручную удалите данное событие из календаря.
Перейдем к Настройкам динамической акции. Поле "Заголовок акции" отвечает за Название дополнительной секции на оборотной стороне карты, Поле "Текст Секции" отвечает за данные под заголовком секции, если это поле останется пустым, тогда акция НЕ БУДЕТ сопровождаться Push уведомлениями.
Раздел "Текст Секции" также поддерживает кликабельные ссылки и эмодзи символы, для их добавления необходимо использовать соответствующую иконку, а в случае с гиперссылками необходимо просто нажать на значок цепи и указать ссылку в формате: "https://mysite.com" (без кавычек).
Теперь перейдем к "Графическим" настройкам акции, тут Вы можете менять Цвета: ярлыков, текста и фона, для этого вам нужно поставить галочку в соответствующем поле и выбрать необходимый цвет из палитры. Поле "Изображение для акции" тут Вы можете загрузить с устройства заранее подготовленную графику, она должна быть в формате PNG и не превышать 624x246 px, вес файла – не более 1 Мб. По окончанию настройки Акции, необходимо нажать на кнопку "Создать PUSH-событие".
РАБОТА С ОТЧЕТАМИ И КАБИНЕТОМ
В этом блоке будет описана работа с Отчетами и Настройками кабинета OSMI
Отчеты
- Состояние карт
- Типы устройств на которые установлены карты
- Историю карт
- Историю типов устройств
- Историю конверсии карт
- История доставленных пушей
Обновления по отчетам приходят ежедневно в Час ночи за прошедший период, т.е. отчет по доставленным пушам за понедельник, отобразиться у вас только во вторник.
Получить данные в формате excel
Для каждой карты указывается серийный номер карты, дата создания, текущий статус и количество устройств, на которых установлена карта. Если даты не заданы, то подразумевается период с 2013/01/01 по текущий день. Чтобы осуществить загрузку данных вам необходимо нажать кнопку "Скачать" напротив меню выбора дат. Подробнее про статусы карт вы можете прочитать в данной статье.
Также системой предусмотрен Отчет с регулярной статистикой подробнее о значениях внутри отчета можете ознакомиться тут
Состояние карт
Количество активных, удаленных и еще не установленных карт представлены в виде визуальной диаграммы.
Диаграмма строится в реальном времени и ее всегда можно обновить, чтобы получить самые последние изменения.
Типы устройств
Подсчитываются только активные карты. Одна карта может стоять одновременно на нескольких устройствах.
История карт
Показывает пропорцию активных карт по отношению ко всем имеющимся картам на заданную дату и как она менялась с течением времени.
История типов устройств
История конверсии карт
История доставленных пушей
История активации карт и устройств
- 1. Смена пароля осуществляется во вкладке "Сменить пароль". Для изменения пароля вам достаточно ввести в верхнюю строчку ваш старый пароль а затем два раза ввести новый. В случае утери пароля вы всегда можете обратиться в нашу службу поддержки для его восстановления.
- 2. Настройка почтового сервера осуществляется в разделе "Настроить почту". Перейдя в данный раздел вы можете использовать предварительно настроенный сервер или ввести настройки от вашего Почтового сервера (В случае необходимости вы можете узнать данные от настроек у вашего Системного администратора), так же можете настроить шаблон письма или же использовать стандартный шаблон.
- 3. Настройка СМС-провайдера осуществляется во вкладке "Настроить СМС". Для настройки провайдера вам необходимо предварительно заключить с ними договор, подробнее вы можете узнать у вашего СМС-провайдера, после того, как вы заключили договор с вашим провайдером укажите логин и пароль в соответствующем поле, при наличии укажите ваш API ключ в соответствующее поле, в поле имя отправителя вписывается зарегистрированное у вашего СМС-провайдера имя отправителя( Подробнее про имена отправителя вы можете узнать у вашего СМС-провайдера) после ввода всех необходимых данных не забудьте нажать кнопку "Сохранить".
Для проверки Работоспособности вашего провайдера укажите номер вашего телефона в поле проверки смс сервиса и нажмите кнопку "проверить", если вы все настройки заполнили правильно, то вам придет смс, а также в поле проверки появиться уведомление со статусом (Зеленый - сообщение успешно отправлено; Красный - ошибка отправки с подробным комментарием)
5. Для быстрого обращения в службу поддержки OSMI, вам нужно скопировать ваш код техподдержки и нажать кнопку "Обратиться за помощью" после чего у вас откроется страница нашей службы поддержки, где вам необходимо заполнить форму, описать проблему с которой вы столкнулись и указать ваш уникальный код в конце вашего обращения.
РАБОТА С ИНТЕГРАЦИЯМИ
В этом блоке будет описана работа с дополнительными инструментами в личном кабинет OSMI
Веб-хуки
Примером такого события может быть установка ранее выданной карты на телефон пользователя. Бизнес процесс может задать правила для максимального количества устройств, на которых может стоять данная карта и, при превышении лимита устройств, бизнес система может отправить на карту предупреждение о превышении лимита или заблокировать карту.
Вы можете настраивать методы для запроса данных об изменениях связанных с полями на электронных картах.
Для добавления Веб-хука, необходимо нажать кнопку "Добавить Веб-хук", после чего у вас появиться поле для настройки, где необходимо будет выбрать тип, указать метод, заполнить поля URL, порт, логин и пароль. Также при необходимости можно скопировать созданный хук или удалить его при помощи соответствующих кнопок.
OSMI Stick
OSMI Stick - это устройство для передачи номера электронной карты лояльности клиента с помощью мобильного Android устройства в кассовое оборудование для идентификации гостя.
Данное меню появиться у вас только в том случае, если вы приобрели устройство OSMI Stick. В данном меню указаны доступы для настройки и дальнейшей работы с данным оборудованием, также здесь можно увидеть сколько всего лицензий доступно и сколько на данный момент используется. При удалении приложение eStripe лицензия с данного устройства возвращается и становиться вновь доступной.
MindBox
Важно:
Для отправки Push события на определенный сегмент, необходимо предварительно отправить запрос на его формирование, данная процедура занимает до 24 часов, после чего вы сможете создать рассылку по выбранному сегменту, данная рассылка будет активна в течении 24 часов.
Iiko
Описанный в данном разделе функционал предназначен для настройки функционала интеграции карт ОСМИ и кошельков iiko, сопоставления полей и шаблонов, а также оперативной смены дизайна карт для ваших пользователей разных категорий.
Соответствующий раздел откроется в меню только в том случае, если вы работаете c решением на iiko Card5 и используете протокол Api iiko Transport.
Если вы работаете на более старой версии iiko delivery и для перехода на Api iiko Transport вам необходимо будет выполнить ряд действий описанных в документе по ссылке: https://support.osmicards.com/knowledgebase.php?article=80
Первичная Настройка
Для проведения первичной настройки необходимо зайти в раздел "Интеграции" и выбрать подраздел "iiko". В данном подразделе для вас доступна страница "Настройка iiko" с открытым разделом "Системные настройки". В данной закладке производится первичная настройка и дальнейшая корректировка интеграции с iiko. В поле "Адрес сервера" и в поле "Логин" необходимо указать ключ iiko transport, который вы получили от своего дилера.
Для сохранения всех произведенных настроек необходимо нажать на кнопку "Сохранить".
ВАЖНО:
- При получении ошибки «Не удалось обновить настройки. Детали ошибки…» после сохранения. Вы должны уточнить верность заполненных полей, не имеются ли там лишние пробелы, точки и символы, полностью ли совпадает ключ, который Вы внесли в поля и ключ, который Вам направил дилер.В ином случае, если никакой из перечисленных способов не помог, вы можете обратиться в нашу службу поддержки - support.osmicards.com
При правильном заполнении полей, указании верного ключа iiko transport и сохранения настроек, страница обновиться автоматически и выведется информация о программах лояльности, точках внутри сети и доступных категориях гостей из вашего iiko Biz. Пример правильного заполнения указан на рис.1
Рис.1 Системные настройки
Обратите внимание, что только при правильном проведении первичных настроек возможно приступать к пользовательским настройкам.
Если у вас в списке организаций показана больше, чем одна организация, необходимо выбрать головную организацию и заново нажать кнопку «Сохранить». Ваш дилер iiko сможет подсказать вам какая организация является головной среди ваших организаций.
Пользовательские настройки
Вкладка "Пользовательские настройки" состоит из двух подразделов. "Поля карт и кошельки" и "Шаблоны и категории гостей".
В разделе "Поля карт и кошельки" имеет интуитивно понятный функционал, который предусматривает выбор шаблона карты, сопоставления полей карты и полей кошелька.
Сопоставление полей обеих сущностей (карты и кошелька) происходят путем перетаскивания соответствующих полей в центральный блок "Мапировка".
После проведения соответствующих действий обозначенные поля будут связаны между собой и правильно отображаться на карте.
Для сохранения настройки соответствия полей необходимо их сохранить нажав кнопку «Сохранить» в левом верхнем углу закладки "Пользовательские настройки".
Пример:
Для того, чтобы сопоставить для связи поле "БОНУСЫ" из карты и "Бонусная программа" из кошелька iiko, необходимо переместить выше обозначенные поля из блоков карты и кошелек в блок "Мапировка" как показана на рис. 2 ниже и нажать кнопку «Сохранить».
Рис.2 Пользовательские настройки. Поля карт и кошельки
Раздел "Шаблоны и категории гостей" настраивается аналогично разделу "Поля карт и кошельки" с помощью перетаскивания и сопоставления шаблонов и категории гостей, которые предварительно заведены в вашу систему iiko тем самым настраивая программу лояльности на определенный шаблон карты.Нажав на кнопку «Сохранить» произойдет соответствующая связка выше обозначенных сущностей.
Пример:
Для сопоставления шаблона карты "Card1" и категории "Гости" вам необходимо переместить из блоков "Шаблоны карт" и "Категории" в блок "Мапировка" соответствующие сущности как показано на рис 3.
На этой же странице можно настроить смену дизайна карты при смене присвоенной гостю категории гостя.
Пролистав ниже, можно провести настройку шаблонов сопоставив их с категориями гостей.
Механика привязки идентично тому, что описывалось выше. Только в данном случае, вы привязываете заранее созданный шаблон, к категории гостей, а именно какой программой лояльности вы хотите наделить тот или иной шаблон.
Привязка шаблонов к категориям:
Для осуществления данной процедуры вам достаточно выбрать шаблон из блока "Шаблоны карт", и далее перетащить нужную переменную в блок "Мапировка", и также переносим категорию из соответствующей колонки "Категории".
Допустим мы хотим наделить шаблон "Card1" 5 % скидкой.
Для этого из блока "Шаблон карт" мы перетаскиваем шаблон "Card1" в блок "Мапировка", так же берем из блока "Категории" категорию "Гость" и переносим в блок "Мапировка".
После сопоставления полей не забудьте сохранить правки, нажатием кнопки "Сохранить".
ВАЖНО:
Если не выполнить сохранение по завершению процесса настройки или корректировки, внесенные изменения не сохраняться.
Панель настройки карт и кошелька указана на рис. 3.
Рис.3 Пользовательские настройки. Шаблоны и категории гостей
Привязка переименованных полей и частые ошибки
Предположим, Вы захотели сменить одно из полей в вашем шаблоне с «ВЛАДЕЛЕЦ» на «ИМЯ ВЛАДЕЛЬЦА». Это привело к ошибке при связывании шаблонов. В «Мапировка» всегда должны находиться актуальные поля карты, поэтому в разделе пользовательских настроек нужно заменить неактивные значения на новые, иными словами, из блока «Мапировка» нужно удалить поле «ВЛАДЕЛЕЦ» и внести туда поле «ИМЯ ВЛАДЕЛЬЦА».
ВАЖНО:
Если не выполнить сопоставление полей после переименования их в шаблоне, то данные на карте в переименованном и связанном с IIKO поле выводиться\отображаться не будут.
Анкетирование
В данном разделе представлен инструмент для работы с "Компаниями" и "Группами регистраций", которые используются при решении с нашей анкетой. Если Анкетирование находиться на Вашей стороне то данный раздел Вы можете пропустить, так как карты в сервисе будут создаваться автоматически при помощи API вызовов.
Группа регистрации - это место временного хранения данных, откуда проинтегрированная система их забирает, после забора данных система автоматически их удаляет. Срок жизни данных в регистрационной группе составляет 14 дней.
Компании - это инструмент использующийся в анкетировании, на основании настроек которого, формируется нумерация и присваиваемый шаблон.
Внимание:
Имя каждой созданной компании должно быть уникальным внутри личного кабинета.
Для создания дополнительной группы регистраций Вам необходимо составить обращение в службе технической поддержки и указать какая из регистрационных компаний должна направлять данные в созданную группу регистраций.
Не при всех интеграциях данные попадают в группу регистраций, например в случае интеграции с Iiko данные отправляются сразу в iiko Biz по API.
Компании
Для создания регистрационной компании, перейдите во вкладку "Анкетирование" личного кабинета и нажмите кнопку "Создать". Далее давайте совместно создадим новую регистрационную компанию:
- В поле название необходимо указать уникальное имя компании на Английском языке.
- Из списка "Тип" выберем "Авто", в данном случае карты будут создаваться автоматически согласно настроенной нумерации. Проверяем что у нас активирован флаг "Статус - Активна"
- При выборе типа "Список" карты создаются из загруженного в систему файла в поле "Карты". Обычно данный тип используется при создании подарочных купонов или карт по списку.
- Далее в поле шаблон выбираем необходимый шаблон, на котором в дальнейшем будут выпускаться карты.
- Если в типе карты Вы выбрали "Список", то данный пункт вы можете пропустить. В полях "Номер карты", необходимо указать префикс номера (первая цифра уникального номера карты) далее указываем количество цифр в серийном номере и устанавливаем лимит карт. Напоминаем Вам, что нумерация карт должна быть уникальна и не пересекаться с уже имеющейся.
- Укажите даты действия регистрационной компании, обычно в поле начало указывает дата создания компании.
- Если в типе карты Вы выбрали "Авто", то данный пункт вы можете пропустить. В поле "Карты" необходимо загрузить список карт в формате Excel со списком номеров карт, с которыми они будут созданы.
После того как вы заполнили все необходимые поля необходимо нажать кнопку "Сохранить"
При изменении существующей компании вы не сможете поменять ее Название и Тип. Вы можете сменить доступные пункты, например изменить нумерацию выпускаемых карт и их шаблон.
Если вы хотите сменить регистрационную компанию которая используется в группе регистраций, необходимо создать соответствующую заявку в службе поддержки, где нужно указать наименование новой компании которая будет использоваться и группу регистраций на которую она ведет.
Пример редактирования Регистрационной компании показан ниже.
Группы регистраций
В данном разделе вы можете просмотреть данные ваших клиентов, которые находятся в регистрационной группе. Также при активации флага "С Удаленными" система отобразит данные, которые были уже загружены вашей CRM системой. Такой тип данных храниться в группе 14 дней после чего удаляется.
При необходимости отображаемые данные из группы регистраций можно сохранить в файл, предварительно выбрав необходимую группу и нажав кнопку "Сохранить в Файл".
Как было описано выше, самостоятельно создать новую группу регистрации не является возможным поэтому обратитесь в службу поддержки для ее создания и не забудьте указать CRM систему на которой вы работаете.
Финансы
В данном разделе представлена вся информация по выставленным счетам и платежам, которая автоматически обновляется каждые 2 часа.
Поля Дата, Событие, Номер счета, Статус и Сумма отображают соответствующие параметры каждой транзакции.
Поле Фильтр (обозначено номером 1 на рисунке ниже) поможет быстро найти необходимую транзакцию. Для этого достаточно ввести в это поле искомые значения в виде текста или цифр. Вы можете фильтровать найденные транзакции по любому значению или его части из таблицы.
Внимание:
Вводить любые значения необходимо именно так, как они отображаются в таблице. К примеру, сумму в тысячах нужно вводить с пробелом.
Поля Лицензия (см. № 2) и Период (№ 3) отображают размер лицензионного вознаграждения и частоту его оплаты согласно договору.
Значения можно отсортировать по Дате (№ 4), нажав на символ стрелочек справа от поля Дата.
Поле «строк на странице» (№ 5) в правом нижнем углу раздела позволяет отображать по 5, 10, 20 или 50 строк с информацией о транзакциях на странице.
Вы можете запросить выставление счета, закрывающих документов, смену контактного email или другую информацию, нажав на кнопку «Запросить документы» (№ 6) в правом верхнем углу раздела.
При наличии не оплаченных счетов в списке выводимой финансовой информации с помощью кнопки скачивания (№ 7) можно скачать актуальный счет в формате PDF прямо в личном кабинете.
Для того, чтобы скрыть данные о транзакциях от постороннего наблюдателя, достаточно нажать кнопку (№ 8) в левом верхнем углу раздела справа от надписи Транзакции.
Данная функция может быть очень полезна при проведении демонстрации работы личного кабинета сторонней аудитории.
В правом верхнем углу данного раздела отображается текущий статус расчётов. Если задолженности нет, в нём отображается надпись «Задолженности нет», выделенная зелёным цветом.
Если имеется задолженность, в верхней части любого из разделов личного кабинета отображается панель красного цвета, в которой указана сумма задолженности.
Нажав на текст сообщения о задолженности в любом из разделов кабинета, вы перейдёте на страницу «Финансы».
В правом верхнем углу раздела расположен блок с контактами менеджера. Нажав на цветную кнопку с изображением, вы сможете посмотреть контактные данные персонального менеджера, а также запросить документы или перейти в раздел Техподдержки.
Темная Тема
Вы можете изменять тему (цвета оформления) вашего личного кабинета со светлой на тёмную и наоборот. Чтобы изменить тему, необходимо нажать на кнопку-слайдер рядом с символом Луны в правом верхнем углу экрана.
Ваш выбор темы сохраняется системой, поэтому при следующем входе в ваш личный кабинет автоматически подключится выбранная вами тема.
Решение распространенных проблем по работе с ЛК
В этом блоке будет описаны решения самых распространенных проблем и вопросов при работе с ЛК ОСМИ