Модуль предназначен для выгрузки клиентской базы из интернет-магазинов на платформе CMS Bitrix в базу данных сервиса DashaMail.
Модуль предоставляет следующие возможности:
Автоматический экспорт клиентов с сайта в сервис DashaMail, а также отслеживание актуальных данных в система по информации на сайте, с возможностью выгрузить поля пользователя в дополнительные поля базы
Ручной экспорт клиентов с сайта в сервис DashaMail, с возможностью выгрузить поля пользователя в дополнительные поля базы
Отправка событий оформления заказа, оплаты и выдачи заказа, изменения корзины покупателя
Установка и настройка модуля
Установите модуль из маркетплейса Битрикс.
После успешного сообщения об установке модуля перейдите в раздел «Сервисы» и в меню модуля откройте раздел «Настройки»:
Чтобы связать ваш сайт с сервисом, необходим корректный api ключ, который можно найти на странице интеграций в личном кабинете (если у вас еще нет ЛК, то прежде всего, вам необходимо зарегистрироваться в сервисе):
После того, как вы свяжете ваш с сайт с сервисом, вам необходимо создать базу пользователей в Личном Кабинете сервиса DashaMail. В эту базу будет осуществляться ручной/автоматический экспорт пользователей вашего сайта.
При необходимости ознакомьтесь с инструкцией по созданию базы.
Выгрузка клиентов в базу
Модуль предоставляет возможность выгрузки клиентов в базы в двух режимах:
Автоматическая выгрузка — постоянный автоматический экспорт выбранных пользователей в созданную базу (происходит каждый раз, когда совершается какое-либо событие с пользователем на сайте (меняется профиль, удаляется подписчик и т.д.)
Ручная выгрузка — ручной экспорт выбранных пользователей в созданную базу (количество и статус пользователей будет зафиксирован на момент выгрузки, какие-либо изменения в профилях пользователей после совершения ручного экспорта учитываться в баз не будут)
ВАЖНО! Если выгрузка пользователей сайта в базу совершается впервые, то ее необходимо провести в РУЧНОМ РЕЖИМЕ, а затем подключить автоматическую выгрузку, чтобы база была актуальной.
Для обоих типов выгрузки можно регулировать список пользователей выгружаемых в базу.
Это могут быть:
Все покупатели, т.е. кто хоть раз совершал покупку/заказ на сайте.
Определенные группы пользователей, которые уже сформированы на сайте.
Важно учесть, что при выборе И группы И включения опции выгрузки всех покупателей, выгрузится совокупность этих пользователей. Например, если поставить группу «Администраторы» и включить «Покупатели», то выгрузятся И все администратора И все, кто хоть раз оформлял заказ вне зависимости от того, администратор он или нет.
Ручной экспорт
НАПОМИНАНИЕ! Если пользователи вашего сайта выгружаются в базу на DashaMail впервые, то в первую очередь необходимо провести именно ручной экспорт.
На странице модуля в разделе «Ручной экспорт» выберите нужную клиентскую базу (1) и нажмите «Применить», чтобы отобразить дополнительные поля (эти поля должны быть созданы в самой базе) (2)
Выберите нужные группы для экспорта (3), а также сопоставьте дополнительные поля при необходимости (если эти поля не определены в базе или не заполнены при запуске выгрузки, то по умолчанию в базу будет передаваться только почта пользователя) (4).
Снова нажмите «Применить» (5).
После сохранения настроек нажмите «Выгрузить пользователей», после чего произойдёт выгрузки базы, будет написано количество выгруженных пользователей, а также отклонённые пользователи (6).
ПРИМЕЧАНИЕ: Если при ручном экспорте будут выгружены эл. адреса, которые уже существуют в базе, то информация о них будет перезаписана в соответствии с той, что придет в экспорте.
Если в экспорте с сайта придет НОВАЯ информация, записана впервые (например, данные с дополнительных полей), то эта информация будет дописана к существующим эл. адресам.
Автоматический экспорт
На странице модуля в разделе «Автоматический экспорт» выберите нужную клиентскую базу (1) и нажмите «Применить», чтобы отобразить дополнительные поля (эти поля должны быть созданы в самой базе) (2)
Выберите нужные группы для экспорта (3), а также сопоставьте дополнительные поля при необходимости (если эти поля не определены в базе или не заполнены при запуске выгрузки, то по умолчанию в базу будет передаваться только почта пользователя) (4).
При необходимости вы можете также включить функцию автоматического очищение базы, если в процессе пользователь сайта удалил/был удален (5).
Обязательно включите автоматический экспорт, чтобы после подтверждения он начал свою работу (6).
Снова нажмите «Применить» (7).
Готово! Автоматическая выгрузка выбранных пользователей в базу запущена и работает.
Отправка событий
Помимо выгрузки пользователей сайта в базы, модуль также имеет возможно передавать необходимые события в сервис для последующей работы с ними в DashaMail.
Для запуска передачи событий необходимо выполнить настройку и подключение.
В первую очередь, вам необходимо добавить сайт в разделе «Сайты» в личном кабинете сервиса Dashamail. Подробную инструкцию можно найти в разделе Сайты.
Далее, в разделе «Настройка» на вкладке событий включите обработку событий и выполните следующие действия:
Задайте частоту запуска агента в секундах. Рекомендованное значение - 300 (5 минут).
Введите число-буквенный код в поле «Идентификатор интеграции». Этот код появится в личном кабинете DashaMail после добавления сайта на сервис.
Введите число-буквенный код в поле «Секретный ключ интеграции». Для получения кода необходимо написать запрос в поддержку сервиса Dashamail.
После выполнения соединения и установки настроек перейдите в раздел «Отправка Событий» и выберите события, которые хотите отправлять в сервис.
События срабатывают и передаются в сервис при наступлении определенного триггерного события/действия на сайте:
Событие | Когда учитывается |
Оформлен новый заказ | Информация передается после совершения покупателем заказа, если в заказе есть эл. адрес |
Изменение товаров в корзине | Добавление или удаление товара из корзины, если покупатель авторизован и можно узнать его эл. адрес |
Заказ оплачен | Статус оплаты перешёл в «Оплачен», и у покупателя в есть эл. адрес |
Заказ выдан | Заказ перешёл в статус, указанный в поле «Статус для выданного заказа», и у покупателя есть эл. адрес |
По умолчанию, модуль отправляет данные стандартных полей заказа, которые отмечены как «Использовать как имя пользователя», «Использовать как почту» и т.д. Если необходимо передавать данные из других полей — введите в соответствующие поля настроек символьные коды свойств заказа Битрикс.