ПОЛЬЗОВАТЕЛЬСКАЯ КОНСОЛЬ

«Пользовательская Консоль» — специальное приложение, позволяющее Вашим клиентам получать оперативную информацию о начисленных им бонусах, личной активности, например, истории покупок, а также активных предложениях Вашей компании. Запустить консоль в демонстрационном режиме.
Для получения авторизованного доступа к «Пользовательской консоли» каждый из Ваших клиентов должен получить индивидуальный логин и пароль.

Способы получения логина и пароля

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

Адрес доступа «Пользовательской консоли»

  • «Пользовательская Консоль» может быть расположена прямо на сайте Вашей компании. Вам потребуется всего лишь добавить на сайт специальный виджет «Пользовательская Консоль». Пример.
  • Ваши клиенты могут получить доступ к «Пользовательской Консоли» с сайта компании PointLoyalty, зарегистрировавшись самостоятельно или получив от Вашей компании заранее созданные логин и пароль.

Настройка внешнего вида «Пользовательской Консоли»

Вы можете разместить логотип Вашей компании на консоли, а также изменить ее внешний вид передав CSS файл с настройками. Сравните стандарный внешний вид «Пользовательской Консоли» с примером кастомизации.

ОБЕСПЕЧЕНИЕ ДОСТУПА КЛИЕНТАМ К «ПОЛЬЗОВАТЕЛЬСКОЙ КОНСОЛИ»

1. Передайте в систему список Ваших клиентов.

Минимальный набор данных о клиенте:
memberId Идентификатор, по которому Вы проводите пользовательские транзакции, например, номер дисконтной карты или внутренний идентификатор клиента в Вашем интернет магазине.
email Адрес электронной почты, необходимый для оповещения клиентов о начисленных бонусах, произведенных корректировках и т.д.
personalId Персональный идентификатор клиента, необходимый для присоединения к Вашим программам. Может совпадать с memberId.
прочие атрибуты Опциональные данные, предназначенные для создания предложений лояльности, основанных на клиентских данных. Подробнее...
Пример:
memberId ivan
email ivan@mail.ru
personalId ivan
Возможные способы передачи данных: REST API, Web Services, файлы с данными, ручной ввод.

2. Создайте клиентский аккаунт или дайте возможность Вашему клиенту зарегистрироваться в «Пользовательской Консоли» самостоятельно.

Для автоматического создания аккаунтов воспользуйтесь REST API или Web services.
Пример набора данных о клиенте:
name ivan
password ivan_password
email ivan@mail.ru
firstName Иван
lastName Иванов
timeZoneId Зависит от зоны проживания Ивана Иванова
personalId ivan
Вы можете передать Вашему клиенту адрес по которому ему следует зарегистрироваться самостоятельно – сайт компании PointLoyalty или страницу Вашего сайта, на которой размещен виджет «Пользовательская консоль».

Советы по интеграции (при автоматическом создании аккаунтов)

Если ваши клиенты уже имеют аккаунты в Вашей системе – Вы можете воспользоваться существующими клиентскими логинами и паролями для создания аккаунтов в «Пользовательской консоли». Для того чтобы компания PointLoyalty не имела доступа к аккаунтам пользователей Вашей системы Вы можете создать аккаунты «Пользовательской Консоли», используя MD5 (описание алгоритма, пример реализации) преобразование данных.
Пример: пусть username в вашей системе = test, password в вашей системе = test.
Создать аккаунт для данного пользователя можно используя REST API с username = test и паролем = MD5 (test).
Или же, чтобы не зависеть от потенциально изменяемых данных, в качестве пароля можно использовать MD5 от внутреннего идентификатора клиента в Вашей системе. После того как клиент вошел в Вашу систему (в сессии вы знаете его логин и пароль) – при доступе в «Пользовательскую консоль» из Вашего приложения вы просто указываете username, MD5 (password) в качествевходных параметров виджета и вход в «Пользовательскую Консоль» произойдет автоматически.

ТЕХНИЧЕСКИЕ ХАРАКТЕРИСТИКИ ВИДЖЕТА «ПОЛЬЗОВАТЕЛЬСКАЯ КОНСОЛЬ»

1. Смотри описание технологии размещения виджета на странице внешнего сайта и демонстрационный пример.
2. JavaScript функции вызываемые из консоли.
JS метод Параметры Примечание
onLoad Без параметров Вызывается после загрузки приложения
onLogin Без параметров Вызывается после успешного логина в приложение
onLogout Без параметров Вызывается после выхода из приложения
onError String. Необязательный. Причина ошибки. Вызывается в случае ошибок приложения
3. Параметры запуска консоли.
Параметр Описание
register true/false. По умолчанию false. Вызов приложения в режиме регистрации.
demo true/false. По умолчанию false. Вызов приложения в демонстрационном режиме.
name Имя пользователя. Вход в режиме данного пользователя.
pswd Пароль пользователя. Вход в режиме данного пользователя (см. name).
Примеры параметров запуска консоли:
  • http://yoursite.ru/member.swf?name=yourname&name=ivan?pswd=789JNK345
  • http://yoursite.ru/member.swf?name=yourname®ister=true
4. Отредактируйте Ваш профиль в PointLoyalty Manager для настройки опций отображения пользовательской консоли.
Параметр Описание
Разрешить доступ клиентам Разрешение/запрет редактирования блока «Управление клиентским доступом».
Тип аутентификации Если Ваши клиенты регистрируются в системе самостоятельно, для присоединения к Вашим программам им необходимо указать персональный идентификатор и (при необходимости) пароль. Выберите тип аутентификации в зависимости набора клиентских данных, которые Вы передаете в систему. Обратите внимание, если Вы выбрали опцию «Единоличный владелец» и создаете аккаунты Вашим клиентам автоматически – достаточно указать тип аутентификации «По идентификатору»
Единый идентификатор Выбор данной опции говорит о том, что идентификатор клиента передаваемый вместе с транзакциями для расчета бонусов совпадает с персональным идентификатором, служащим для присоединения клиента к программам. Если Вы создаете клиентские аккаунты автоматически , выбор опции «Единый идентификатор» наиболее удобен в работе. Если Ваши клиенты самостоятельно регистрируются в системе — Вам необходимо выдавать Вашим клиентам для присоединения специальный персональный идентификатор, так как сложный идентификатор, используемый в транзакцих (например, зашифрованный номер карты) может быть слишком сложным для ручного ввода клиентом в приложении «Пользовательская Консоль».
Оповещать клиента Отсылать ли письма клиентам с информацией о начисленных бонусах и произведенных корректировках бонусов.
Единоличный владелец Разрешать ли Вашим клиентам после присоединения к Вашим программам присоединяться к программам других компаний («нет» — если Вы не передайте клиентские данные совместно с партнерами, владельцами других программ).
Запретить изменение личных данных Если Вы «Единоличный владелец» программ и запрограммировали автоматический вход в «Пользовательскую Консоль» из своей системы, Вам может потребоваться возможность запретить Вашим клиентам изменение пароля доступа в «Пользовательской Консоли». Выбирайте эту опцию если вы интегрируете «Пользовательскую консоль» с Вашим приложением, уже имеющим систему аутентификации.
Запретить выход из системы Если Вы «Единоличный владелец» программ и запрограммировали автоматический вход в «Пользовательскую Консоль» из своей системы, Вам может потребоваться возможность запретить Вашим клиентам выход из приложения. Выбирайте эту опцию если вы интегрируете «Пользовательскую консоль» с Вашим приложением уже имеющим систему аутентификации.
Служба поддержки Вы можете указать адрес службы поддержки Вашей компании для отображения в «Пользовательской Консоли».
Шифрование Если вы используете для идентификатора клиента в транзакции номер его пластиковой карты, а также опцию «Единый идентификатор» — то для присоединения к Вашим программам клиент должен указать номер данной карты. Системе необходимо знать какой способ шифрования вы используете, чтобы не сохранять в системе номеров реальных карт. Если Вы автоматически создаете аккаунт клиентам – выбирайте пункт «Без шифрования» (присоединение к Вашим программам происходит автоматически и клиент не должен вручную заносить в систему персональный идентификатор).
Логотип «Пользовательской Консоли» Отображение «Пользовательской консоли» будет осуществляться с данным логотипом (если вы размещаете ее на своем сайте).

ПРИМЕРЫ РАБОТЫ С ПОЛЬЗОВАТЕЛЬСКОЙ КОНСОЛЬЮ

Пример 1. Интернет магазин.

  • Вы имеете интернет магазин с системой авторизации и хотите осуществить интеграцию с «Пользовательской консолью».
  • Аккаунты Вашим клиентам Вы планируете создавать автоматически.
  • Пример Вашего клиента уже зарегистрированного в Вашей системе:
    firstName Иван
    lastName Иванов
    username ivan
    password ivan_password
    email ivan@mail.ru
  • Все транзакции Вы проводите по memberId = username (ivan)
  • Вы не планируете создание коалиций с другими владельцами интернет магазинов, имеющих другие программы.

Рекомендации:

Рекомендуемые параметры управления клиентским доступом:
Параметр Значение
Разрешить доступ клиентам да
Тип аутентификации «По идентификатору»
Единый идентификатор да
Оповещать клиента По необходимости
Единоличный владелец да
Запретить изменение личных данных да
Запретить выход из системы да
Служба поддержки support@yourcompany.ru
Передача данных о пользователях в систему:
1. Вы должны передать данные о клиентах в систему, используя REST API, Web Services или с помощью файлов.
memberId ivan
email ivan@mail.ru
password не задаем
personalId ivan
2. Создайте клиентские аккаунты автоматически (например, при регистрации нового клиента в Вашей системе автоматически создавайте аккаунты в PointLoyalty с помощью REST API или Web Services)
name ivan
password ivan_password или MD5 (ivan_password)
email ivan@mail.ru
firstName Иван
lastName Иванов
timeZoneId зависит от зоны проживания Ивана Иванова
personalId ivan

Пример 2. Информационно-рекламный сайт.

  • Информационно-рекламный сайт оффлайн торговой системы. Сайт не поддерживает авторизацию посетителей.
  • Вы не планируете автоматизировать создание аккаунтов Вашим клиентам.
  • Все транзакции Вы проводите по номерам карт лояльности, выданных Вашим клиентам.
  • Вы не планируете создание коалиций с другими владельцами магазинов, имеющих другие программы и т.д.

Рекомендации:

Рекомендуемые параметры управления клиентским доступом
Параметр Значение
Разрешить доступ клиентам да
Тип аутентификации «По email»
Единый идентификатор да
Оповещать клиента По необходимости
Единоличный владелец да
Запретить изменение личных данных нет
Запретить выход из системы нет
Служба поддержки support@yourcompany.ru
Данные о клиентах
1. Вы должны передать данные о клиентах в систему, используя REST API, Web Services или с помощью файлов.
memberId MD5 (loyalty_card_of_ivanov)
email ivan@mail.ru, должен быть получен Вами при анкетировании клиентов, выдаче карт лояльности и т.д. Нужен, так как был выбран тип аутентификации «По email»
password не задаем
personalId MD5 (loyalty_card_of_ivanov)
Обратите внимание, так как Вы осуществляете Вашу деятельность оффлайн, вам необходимо анкетировать Ваших клиентов для присоединения к Вашим программам (Например, при выдаче карт лояльности). Вы должны получить от них минимальный набор данных email, имя, фамилию и номер карты (дисконтной, клубной, visa и т.д.) – так как Вам необходимо связать транзакцию по карточке с конкретным покупателем. Кроме всего вы должны передать пользователю его персональный идентификатор для присоединения к вашим программам. Например, Вы должны разъяснить клиенту, что он должен указать номер своей дисконтной карты Вашего магазина при регистрации в «Пользовательской Консоли».
2. Вы предлагаете Вашим клиентам зайти для регистрации на страницу Вашего сайта с размещенным виджетом «Пользовательская консоль». После регистрации клиент вводит полученный personalId (номер своей карты) и присоединяется к Вашим программам.