Dzięki integracji z Apsis One każda osoba, która się zapisze, zostaje utworzona lub zaktualizowana jako profil w Apsis One, w wybranej przez ciebie sekcji, i może zostać zapisana na jedną z twoich subskrypcji w Apsis One.
Czego potrzebujesz
- Konta Apsis One i użytkownika, który może zarządzać kluczami API (zwykle administratora).
- Wiedzy, czy twoje konto Apsis One jest w regionie Europa czy Azja. Większość kont jest w Europie.
Krok 1: Utwórz klucz API w Apsis One
- W Apsis One otwórz Account settings i przejdź do API keys (w sekcji integracji).
- Utwórz nowy klucz API. Nadaj mu nazwę, którą rozpoznasz, np. „Scratcher”.
- Daj kluczowi dostęp do sekcji, do których Scratcher ma wysyłać profile, z uprawnieniami opisanymi poniżej.
- Zapisz i skopiuj Client ID oraz Client secret. Sekret jest pokazywany tylko raz.
Apsis ma własny przewodnik krok po kroku. Link do niego znajdziesz w Przewodnik konfiguracji w oknie instalacji w Scratcherze („Aby zainstalować integrację, postępuj zgodnie z tym przewodnikiem”).
Uprawnienia, których potrzebuje klucz
Scratcher używa klucza, aby:
- odczytywać twoje sekcje oraz atrybuty, subskrypcje (tematy zgód) i zdarzenia w nich, żebyś mógł je wybrać w kampanii;
- tworzyć profile i aktualizować ich atrybuty;
- dodawać zgody (opt-in) do profili;
- dodawać zdarzenia do profili.
Klucz potrzebuje więc dostępu do odczytu sekcji i dostępu do zapisu profili, zgód i zdarzeń w sekcjach, których używasz. Bez dostępu do zapisu dostarczenia kończą się błędem z własnym komunikatem Apsis One.
Krok 2: Połącz Apsis One ze Scratcherem
- W Scratcherze przejdź do Ustawienia > Integracje i kliknij Apsis One.
- Wybierz Region API: Europa lub Azja.
- Wklej Client ID i Client Secret.
- Kliknij Zainstaluj integrację. Scratcher loguje się do Apsis One, aby sprawdzić dane.
Krok 3: Włącz integrację w kampanii
- W edytorze przejdź do Połącz > Integracje > Apsis One i kliknij Aktywuj.
- Jeśli masz połączonych kilka kont Apsis One, wybierz właściwe w polu Wybierz konto.
- W polu Sekcja Apsis wybierz sekcję (Wybierz sekcję).
- W sekcji Mapowanie pól kliknij Dodaj mapowanie pól dla każdego pola i dopasuj Pole Scratcher do atrybutu Apsis One w Pole docelowe. Lista pokazuje atrybuty wybranej sekcji, w tym twoje własne.
- W polu Subskrypcje (zgody) wybierz subskrypcję, na którą mają zostać zapisane osoby, lub Brak. „Wybierz subskrypcję, do której uczestnik ma zostać zapisany.”
- W polu Filtruj według zgód (opcjonalnie) wybierz swoje pole wyboru zgody marketingowej, żeby wysyłane były tylko osoby, które je zaznaczyły.
- Kliknij Zapisz, a potem Testuj, aby wysłać testowy profil.
Mapowanie pól
- Adres e-mail jest zawsze wysyłany i służy do identyfikacji profilu. Nie musisz go mapować.
- Przy numerach telefonu użyj ustawienia Format, aby wysłać numer w postaci, jakiej oczekuje twój atrybut.
- Atrybuty tak/nie otrzymują wartość true lub false, więc pole Zaakceptowano danej zgody mapuj na atrybut tak/nie.
Zgoda
Jeśli wybierzesz subskrypcję, każda osoba zostaje na nią zapisana z powodem „Subscribed via” i nazwą kampanii oraz źródłem „Scratcher”. Jeśli osoba jest już zapisana, nic się nie zmienia. Użyj Filtruj według zgód, żeby zapisywane były tylko osoby, które zaznaczyły twoje pole zgody marketingowej.
Jeśli twoja sekcja ma zdarzenie formularza zgody Apsis One, Scratcher zapisuje też zapis jako zdarzenie w profilu, z adresem kampanii.
Co jest wysyłane i kiedy
Nowe zapisy są wysyłane w ciągu minuty lub dwóch. Gdy aktywujesz integrację, wysyłane są też istniejące leady kampanii. Gdy ktoś weźmie udział ponownie, jego profil jest aktualizowany. Każde dostarczenie sprawdzisz w Ustawienia > Integracje > Status dostarczenia; widać tam też, czy profil był nowy, czy już istniał. Zobacz Sprawdź status dostarczenia i wyślij leady ponownie.
Rozwiązywanie problemów
- „Niektóre lub wszystkie pola są nieprawidłowe...” podczas instalacji: sprawdź region i skopiuj ponownie Client ID i sekret.
- Dostarczenia kończą się błędem dostępu z Apsis One: klucz nie ma dostępu do sekcji albo brakuje mu uprawnień do zapisu. Edytuj klucz w Apsis One.
- Subskrypcje (zgody) jest puste: sekcja nie ma jeszcze subskrypcji. Utwórz ją w Apsis One i otwórz integrację ponownie.