Dzięki integracji z Bloomreach każda osoba, która się zapisze, zostaje utworzona lub zaktualizowana jako klient w twoim projekcie Bloomreach Engagement, rozpoznawany po adresie e-mail. Możesz też nadać jej zgodę w Bloomreach, żeby móc wysyłać do niej treści marketingowe.
Czego potrzebujesz
- Projektu Bloomreach Engagement i użytkownika, który może zarządzać dostępem do API w ustawieniach projektu (zwykle administratora projektu).
Krok 1: Utwórz klucz API w Bloomreach
- W Bloomreach Engagement otwórz projekt i przejdź do Project settings > Access management > API.
- Skopiuj Project token i API base URL widoczne na stronie.
- W sekcji grup API utwórz nową grupę z Private access i nazwij ją np. „Scratcher”.
- Utwórz w grupie nowy klucz API. Skopiuj API key ID i API secret. Sekret jest pokazywany tylko raz.
- Nadaj grupie poniższe uprawnienia i zapisz.
Uprawnienia, których potrzebuje klucz
W uprawnieniach grupy zezwól na:
- Customer properties: get i set, aby wyszukiwać klientów, tworzyć ich lub aktualizować oraz pokazywać właściwości klientów w mapowaniu pól.
- Events: set, dla zdarzenia
consent, żeby Scratcher mógł zapisywać zgody.
Nic więcej nie jest potrzebne. Bez uprawnień set dostarczenia kończą się błędem dostępu z Bloomreach.
Krok 2: Połącz Bloomreach ze Scratcherem
- W Scratcherze przejdź do Ustawienia > Integracje i kliknij Bloomreach.
- Wklej API base URL, token projektu, API key ID i API secret w odpowiednie pola.
- Kliknij Zainstaluj integrację. Scratcher sprawdza dane w Bloomreach.
Krok 3: Włącz integrację w kampanii
- W edytorze przejdź do Połącz > Integracje > Bloomreach i kliknij Aktywuj.
- Jeśli masz połączonych kilka projektów, wybierz właściwy w polu Wybierz konto.
- W sekcji Mapowanie pól kliknij Dodaj mapowanie pól i dopasuj każde Pole Scratcher do właściwości klienta w Bloomreach, np. „Lead - Imię” do first_name.
- Wybierz kategorię zgody, którą mają otrzymać osoby, np. „newsletter”, albo żadną.
- 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.
Dobrze wiedzieć: Bloomreach nie ma list. Wszyscy trafiają do projektu, a grupujesz ich za pomocą segmentów w Bloomreach. Dlatego Scratcher zaczyna wysyłać, gdy tylko klikniesz Aktywuj. Aktywuj integrację, zanim kampania wystartuje, albo od razu ją skonfiguruj.
Mapowanie pól
- Adres e-mail jest zawsze wysyłany i służy do wyszukania klienta. Nie musisz go mapować.
- Lista Pole docelowe pokazuje właściwości klientów w twoim projekcie. Jeśli jakiejś brakuje, najpierw utwórz ją w Bloomreach.
- Aby oznaczyć, skąd pochodzą klienci, zmapuj Użyj wartości niestandardowej, np. „Gra letnia Scratcher”, na właściwość, której używasz do źródła.
Zgoda
Jeśli wybierzesz kategorię zgody, Scratcher zapisuje zdarzenie consent z akcją accept i nazwą kampanii jako źródłem. Kategoria musi istnieć w Bloomreach (w ustawieniach zgód w Project settings). Użyj Filtruj według zgód, żeby zgodę otrzymywały tylko osoby, które zaznaczyły twoje pole zgody marketingowej.
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, klient jest aktualizowany. Każde dostarczenie sprawdzisz w Ustawienia > Integracje > Status dostarczenia. Zobacz Sprawdź status dostarczenia i wyślij leady ponownie.
Rozwiązywanie problemów
- „Niektóre lub wszystkie pola są nieprawidłowe...” podczas instalacji: sprawdź API base URL i token projektu, a potem skopiuj ponownie key ID i sekret.
- Dostarczenia kończą się błędem dostępu: grupie API brakuje któregoś z powyższych uprawnień. Edytuj ją w Bloomreach.
- Zgoda nie pojawia się u klienta: kategoria zgody nie istnieje w Bloomreach albo jest inaczej zapisana.
- Bloomreach ma własne przewodniki dotyczące kluczy API. Jeśli menu wyglądają inaczej, wyszukaj w dokumentacji Bloomreach „API access management”.