Общее описание

Не секрет, что на высоко-конкурентном рынке современного ритейла именно персональные таргетированные предложения откроют вам доступ к сердцам покупателей.

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

Теперь вы можете загружать в SetRetail10 из CRM или ERP систем списки покупателей, для которых можно назначить любую скидку, начислить специальные бонусы, распечатать купон на следующую покупку.

Для работы функциональности влкючите серверный процессинг карт.

На сервере: Карты → Настройки → Флаг Использование серверного процессинга внутренних карт

Логика создания списка сегментов во внешней системе

Маркетолог создает в системе во внешней системе список клиентов и выгружает его в SetRetail10:

Пример файла загрузки списка клиентов.

Методы веб-сервиса для импорта сегментов

Без обратной связи
Метод	add
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/SegmentsImport
WSDL	http://IP-адрес_сервера:8090/SET-ERPIntegration/SegmentsImport?wsdl

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
xmlData	base64Binary	XML в формате данных сегментов, кодированный с помощью base64Binary	Да
Возвращаемые параметры
return	boolean	`True` в случае успешной обработки пакета

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

С обратной связью
Метод	addWithTI
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/SegmentsImport
WSDL	http://IP-адрес_сервера:8090/SET-ERPIntegration/SegmentsImport?wsdl

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
xmlData	base64Binary	XML в формате данных сегментов, кодированный с помощью base64Binary	Да
TI	string	`Transaction Id` - номер передаваемого пакета данных, по которому можно будет получить обратную связь.	Нет
Возвращаемые параметры
return	boolean	`True` в случае успешной обработки пакета

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

Важно

Идентификатор пакета ti Transaction Id – является уникальным идентификатором этого пакета в SetRetail10, что накладывает определённые ограничения на повторный импорт пакета и загрузку разных типов данных с одним идентификатором.

Удаление участников сегментов

Без обратной связи
Метод	delete
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/SegmentsImport
WSDL	http://IP-адрес_сервера:8090/SET-ERPIntegration/SegmentsImport?wsdl

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
xmlData	base64Binary	XML в формате данных сегментов, кодированный с помощью base64Binary	Да
Возвращаемые параметры
return	boolean	`True` в случае успешной обработки пакета

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

С обратной связью
Метод	deleteWithTI
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/SegmentsImport
WSDL	http://IP-адрес_сервера:8090/SET-ERPIntegration/SegmentsImport?wsdl

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
xmlData	base64Binary	XML в формате данных сегментов, кодированный с помощью base64Binary	Да
TI	string	`Transaction Id` - номер передаваемого пакета данных, по которому можно будет получить обратную связь.	Нет
Возвращаемые параметры
return	boolean	`True` в случае успешной обработки пакета

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

Важно

Идентификатор пакета ti Transaction Id – является уникальным идентификатором этого пакета в SetRetail10, что накладывает определённые ограничения на повторный импорт пакета и загрузку разных типов данных с одним идентификатором.

Создание рекламной акции с использованием списка (сегмента)

1. В условиях скидки укажите, что скидка предоставляется в рамках персональных предложений по условию КЛИЕНТСКИЕ → Вхождение в сегменты → укажите список сегментов (список покупателей).

2. В условиях рекламной акции устанавливите преференцию, получаемую покупателем в рамках данной скидки, например 10% на товары группы Молоко

З. Запустите рекламную акцию.

Отображение списка сегментов и поиск по фильтрам

1. Для просмотра и поиска сегментов перейдите в Карты → Сегменты → кликните .

После перехода в раздел Сегменты, по умолчанию список не отображается.

2. Выберите из списка требуемый фильтр для поиска → кликните .

3. Отобразится список сегментов.

Загрузка сегментов в ручную через SOAP UI

1. Сформируйте сегменты в xml-файл можно с помощью Excel и функции =СЦЕПИТЬ()

Пример Excel-файла для формирования сегментов

2. Воспользуйтесь SOAP UI подключитесь к веб-сервису сервера SetRetail10 с методом

http://XXX.XXX.XXX.XXX:8090/SET-ERPIntegration/SegmentsImport?wsdl

3. Выберите New SOAP Project

4. Задайте имя для проекта в поле Project Name и добавьте адрес до веб-сервиса в поле Initial WSDL , нажмите кнопку OK .

5. Перейдите по дереву SegmentsImportServiceSoapBinding > addWithTI > Откройте двойным кликом мыши запрос Request 1

6. Для формирования запроса, получившейся xml-файл сконвертируйте в формат Base64, с помощью любого онлайн-инструмента.

Вставьте содержимое xml-файла в поле и перекодируйте данные в формат Base64.

Затем вставьте перекодированные данные в тег запроса <xmlData>, а также в тег <TI> номер пакета.

7. Для отправки сегмента нажмите кнопку Submit

8. Если запрос принят успешно и обработался сервером придет пустой ответ и сегменты загрузятся на сервер.

9. Если сегменты не приняты сервером, тогда в лог файле server.log можно увидеть ошибку о приёме данных.

Linux: /var/lib/jboss/standalone/log/server.log
Windows: {Диск}:\{Папка_сервера_SetRetail10}\standalone\log\server.log

10. Также проверить загрузку всех сегментов можно проверить запросом в базе данных set:

select * from cards_segment_client

Код покупателей (client_guid) можно получить из внешней системы (CRM/BI/ т.п.) или из базы данных SetRetail10 (в визуализации SetRetail10 код покупателя не отображается)

Загрузка и удаление участников сегмента через текстовый файл

Добавление участников сегмента из файла

В модуле есть возможность добавлять количество участников сегмента, не дожидаясь загрузки из ERP.

1. Создайте текстовый файл, где будет указан список номеров GUID-клиентов сегмента

Максимальное количество добавляемых участников файлом - 10 млн. записей

2. Перейдите к тому сегменту, для клиентов которого необходимо сделать добавление участников.

3. Кликните → выберите созданный текстовый файл → нажмите кнопку Открыть.

4. Начнется подготовка файла для загрузки.

5. После этого появится сообщение о количестве загружаемых участников, а по окончанию процесса это количество обновится в карточке сегмента → кликните .