С интеграцията с Apsis One всеки, който се регистрира, се създава или актуализира като профил в Apsis One в избраната от вас секция и може да бъде включен в някой от вашите абонаменти в Apsis One.
Какво ви е необходимо
- Акаунт в Apsis One и потребител, който може да управлява API ключове (обикновено администратор).
- Да знаете дали акаунтът ви в Apsis One е в региона Europe или Asia. Повечето акаунти са в Европа.
Стъпка 1: Създайте API ключ в Apsis One
- В Apsis One отворете Account settings и отидете в API keys (в раздела за интеграции).
- Създайте нов API ключ. Дайте му име, което лесно ще разпознаете, например „Scratcher“.
- Дайте на ключа достъп до секцията или секциите, в които искате Scratcher да изпраща профили, с правата, описани по-долу.
- Запазете и копирайте Client ID и Client secret. Тайният ключ се показва само веднъж.
Apsis има собствено ръководство стъпка по стъпка за това. Връзка към него ще намерите в Ръководство за настройка в прозореца за инсталиране в Scratcher („За да инсталирате интеграцията, следвайте ръководството тук“).
Права, от които ключът се нуждае
Scratcher използва ключа, за да:
- чете вашите секции, както и атрибутите, абонаментите (теми за съгласие) и събитията в тях, за да можете да ги изберете в кампанията;
- създава профили и актуализира техните атрибути;
- добавя съгласия (opt-in) към профилите;
- добавя събития към профилите.
Следователно ключът се нуждае от право за четене на секциите и право за запис на профили, съгласия и събития в секциите, които използвате. Без право за запис изпращанията се провалят със собственото съобщение за грешка на Apsis One.
Стъпка 2: Свържете Apsis One със Scratcher
- В Scratcher отидете в Настройки > Интеграции и кликнете върху Apsis One.
- Изберете API регион: Europe или Asia.
- Поставете Client ID и Client secret.
- Кликнете върху Инсталиране на интеграцията. Scratcher влиза в Apsis One, за да провери данните.
Стъпка 3: Активирайте я в кампания
- В редактора отидете в Свързване > Интеграции > Apsis One и кликнете върху Активиране.
- Ако сте свързали повече от един акаунт в Apsis One, изберете го в Изберете акаунт.
- В Apsis секция изберете секцията (Изберете секция).
- В Съпоставяне на полета кликнете върху Добавяне на съпоставяне на поле за всяко поле и съпоставете Поле в Scratcher с атрибута в Apsis One в Целево поле. Списъкът показва атрибутите на избраната секция, включително вашите собствени.
- В Абонаменти (съгласия) изберете абонамента, в който да бъдат включени хората, или Няма. „Изберете абонамент, в който участникът да бъде включен.“
- В Филтриране по разрешения (по избор) изберете своето поле за отметка за маркетингово съгласие, така че да се изпращат само хората, които са го отметнали.
- Кликнете върху Запазване, а след това върху Тест, за да изпратите тестов профил.
Съпоставяне на полета
- Имейл адресът се изпраща винаги и се използва за идентифициране на профила. Не е необходимо да го съпоставяте.
- За телефонните номера използвайте настройката Формат, за да изпращате номера във формата, който очаква вашият атрибут.
- Атрибутите от тип да/не получават стойност true или false, затова съпоставяйте полето Прието на дадено съгласие с атрибут от тип да/не.
Съгласие
Ако изберете абонамент, всеки човек се включва в него с причина „Subscribed via“ и името на кампанията, както и с източник „Scratcher“. Ако човекът вече е включен, нищо не се променя. Използвайте Филтриране по разрешения, така че да се включват само хората, отметнали вашето поле за маркетингово съгласие.
Ако секцията ви съдържа събитието за формуляр за съгласие на Apsis One, Scratcher записва регистрацията и като събитие в профила, заедно с адреса на кампанията.
Какво се изпраща и кога
Новите регистрации се изпращат в рамките на минута-две. Когато активирате интеграцията, се изпращат и съществуващите лийдове на кампанията. Когато някой участва отново, профилът му се актуализира. Проверявайте всяко изпращане в Настройки > Интеграции > Статус на изпращането; там се вижда и дали профилът е нов, или вече е съществувал. Вижте Проверка на статуса на изпращането и повторно изпращане на лийдове.
Отстраняване на проблеми
- „All or some of the fields are invalid...“ при инсталиране: проверете региона и копирайте отново Client ID и Client secret.
- Изпращанията се провалят с грешка за достъп от Apsis One: ключът няма достъп до секцията или няма права за запис. Редактирайте ключа в Apsis One.
- Абонаменти (съгласия) е празно: секцията все още няма абонаменти. Създайте абонамент в Apsis One и отворете интеграцията отново.