С интеграцията с Bloomreach всеки, който се регистрира, се създава или обновява като клиент във вашия проект в Bloomreach Engagement, като се идентифицира по имейл адреса си. Можете също да му дадете съгласие в Bloomreach, за да имате право да му изпращате маркетингови съобщения.
Какво ви е необходимо
- Проект в Bloomreach Engagement и потребител, който може да управлява API достъпа в настройките на проекта (обикновено администратор на проекта).
Стъпка 1: Създайте API ключ в Bloomreach
- В Bloomreach Engagement отворете проекта и отидете в Project settings > Access management > API.
- Копирайте Project token и API base URL, показани на страницата.
- В секцията с API групи създайте нова група с Private access и я наименувайте например „Scratcher“.
- Създайте нов API ключ в групата. Копирайте API key ID и API secret. Тайният ключ се показва само веднъж.
- Дайте на групата посочените по-долу права и запазете.
Права, от които ключът се нуждае
В правата на групата разрешете:
- Customer properties: get и set – за да се намират клиенти, да се създават или обновяват и да се показват свойствата на клиентите ви при съпоставянето на полета.
- Events: set – за събитието
consent, за да може Scratcher да записва съгласия.
Нищо друго не е необходимо. Без правата set изпращанията ще се провалят със собствената грешка за достъп на Bloomreach.
Стъпка 2: Свържете Bloomreach със Scratcher
- В Scratcher отидете в Настройки > Интеграции и кликнете върху Bloomreach.
- Поставете API base URL, project token, API key ID и API secret в съответните полета.
- Кликнете върху Инсталиране на интеграцията. Scratcher проверява данните с Bloomreach.
Стъпка 3: Включете я в кампания
- В редактора отидете в Свързване > Интеграции > Bloomreach и кликнете върху Активиране.
- Ако сте свързали повече от един проект, изберете го в Изберете акаунт.
- В Съпоставяне на полета кликнете върху Добавяне на съпоставяне на поле и свържете всяко Поле в Scratcher със свойство на клиента в Bloomreach, например „Лийд - Име“ с first_name.
- Изберете категорията съгласие, която участниците да получат, например „newsletter“, или никаква.
- В Филтриране по разрешения (по избор) изберете своето поле за отметка за маркетингово съгласие, така че да се изпращат само хората, които са го отметнали.
- Кликнете върху Запазване, а след това върху Тест.
Добре е да знаете: в Bloomreach няма списъци. Всички попадат в проекта, а вие ги групирате със сегменти в Bloomreach. Затова Scratcher започва да изпраща веднага щом кликнете върху Активиране. Активирайте интеграцията, преди кампанията да стартира, или я настройте веднага.
Съпоставяне на полета
- Имейл адресът винаги се изпраща и се използва за намиране на клиента. Не е нужно да го съпоставяте.
- Списъкът Целево поле показва свойствата на клиентите във вашия проект. Ако някое липсва, първо го създайте в Bloomreach.
- За да отбележите откъде идват клиентите, съпоставете Използване на персонализирана стойност, например „Scratcher лятна игра“, със свойството, което използвате за източник.
Съгласие
Ако изберете категория съгласие, Scratcher записва събитие consent с действие accept и името на кампанията като източник. Категорията трябва да съществува в Bloomreach (в настройките за съгласия в Project settings). Използвайте Филтриране по разрешения, така че съгласието да получат само хората, отметнали маркетинговото ви поле.
Какво се изпраща и кога
Новите регистрации се изпращат в рамките на минута-две. Когато активирате интеграцията, се изпращат и съществуващите лийдове на кампанията. Когато някой участва отново, клиентът се обновява. Проверявайте всяко изпращане в Настройки > Интеграции > Статус на доставката. Вижте Проверка на статуса на доставката и повторно изпращане на лийдове.
Отстраняване на проблеми
- „All or some of the fields are invalid...“ при инсталиране: проверете API base URL и project token и копирайте отново key ID и secret.
- Изпращанията се провалят с грешка за достъп: на API групата липсва някое от горепосочените права. Редактирайте я в Bloomreach.
- Съгласието не се показва при клиента: категорията съгласие не съществува в Bloomreach или е изписана по различен начин.
- Bloomreach има собствени ръководства за API ключове. Потърсете „API access management“ в документацията на Bloomreach, ако менютата изглеждат различно.