Dzięki integracji z Emarsys każda osoba, która się zapisze, zostaje utworzona lub zaktualizowana jako kontakt w Emarsys i dodana do wybranej przez ciebie listy kontaktów.
Czego potrzebujesz
- Konta Emarsys i użytkownika, który może zarządzać danymi uwierzytelniającymi API (w Management > Security Settings).
Krok 1: Utwórz dane uwierzytelniające API w Emarsys
- W Emarsys przejdź do Management > Security Settings > API Credentials.
- Kliknij Create API Credentials i koniecznie wybierz OpenID Connect.
- W sekcji Permissions włącz te cztery uprawnienia:
contact.create,contact.update,contactlist.listifield.list. - Zapisz i skopiuj Client ID oraz Client Secret. W Scratcherze potrzebujesz obu.
Uprawnienia, których potrzebują dane uwierzytelniające
contact.createicontact.update: do tworzenia nowych kontaktów i aktualizowania istniejących.contactlist.list: do pokazywania twoich list kontaktów w kampanii.field.list: do pokazywania twoich pól Emarsys w mapowaniu pól.
Żadne inne uprawnienia nie są potrzebne.
Krok 2: Połącz Emarsys ze Scratcherem
- W Scratcherze przejdź do Ustawienia > Integracje i kliknij Emarsys. Przewodnik konfiguracji w oknie powtarza powyższe kroki.
- Wklej Client ID i Client Secret.
- Kliknij Zainstaluj integrację. Scratcher sprawdza, czy może odczytać twoje listy kontaktów.
Krok 3: Włącz integrację w kampanii
- W edytorze przejdź do Połącz > Integracje > Emarsys i kliknij Aktywuj.
- Jeśli masz połączonych kilka kont, wybierz właściwe w polu Wybierz konto.
- W polu Lista zewnętrzna wybierz listę kontaktów.
- W sekcji Mapowanie pól zmapuj co najmniej „Lead - E-mail” na pole Email w Emarsys, a potem pozostałe pola, np. First Name i Last Name. Pola Emarsys są wymienione po nazwie.
- W polu Filtruj według zgód (opcjonalnie) wybierz swoje pole wyboru zgody marketingowej.
- Kliknij Zapisz, a potem Testuj.
Mapowanie pól
- Adres e-mail zmapuj samodzielnie. Emarsys używa go do wyszukiwania istniejących kontaktów, więc kontaktu bez niego nie da się dopasować.
- Wysyłane są tylko pola, które zmapujesz.
- Niektóre pola systemowe Emarsys, takie jak opt-in, data rejestracji i newsletter, nie są dostępne, bo Emarsys ustawia je sam.
Zgoda
Scratcher ustawia pole opt-in kontaktu w Emarsys na „true” dla każdego, kogo wysyła. Dlatego zawsze używaj Filtruj według zgód (opcjonalnie) ze swoim polem wyboru zgody marketingowej, jeśli w formularzu jest ono nieobowiązkowe.
Co jest wysyłane i kiedy
Nowe zapisy są wysyłane w ciągu minuty lub dwóch, a istniejące leady kampanii po aktywowaniu integracji. Jeśli kontakt już istnieje, zostaje zaktualizowany i dodany do listy.
Rozwiązywanie problemów
- „Niektóre lub wszystkie pola są nieprawidłowe...” podczas instalacji: Client ID lub sekret są błędne albo dane uwierzytelniające nie korzystają z OpenID Connect.
- Dostarczenia kończą się błędem albo listy rozwijane list lub pól są puste: danym uwierzytelniającym brakuje jednego z czterech uprawnień. Edytuj je w Emarsys.
- Kontakty są tworzone podwójnie: „Lead - E-mail” nie jest zmapowane na pole Email.