Przejdź do treści
Rex, twój asystent AI: żmudną robotę bierze na siebie. Pomysły zostają twoje 👉 Poznaj Rexa

Połącz Bloomreach

Utwórz klucz API w Bloomreach Engagement, połącz go i twórz lub aktualizuj klientów wraz z ich zgodami.

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

  1. W Bloomreach Engagement otwórz projekt i przejdź do Project settings > Access management > API.
  2. Skopiuj Project token i API base URL widoczne na stronie.
  3. W sekcji grup API utwórz nową grupę z Private access i nazwij ją np. „Scratcher”.
  4. Utwórz w grupie nowy klucz API. Skopiuj API key ID i API secret. Sekret jest pokazywany tylko raz.
  5. 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

  1. W Scratcherze przejdź do Ustawienia > Integracje i kliknij Bloomreach.
  2. Wklej API base URL, token projektu, API key ID i API secret w odpowiednie pola.
  3. Kliknij Zainstaluj integrację. Scratcher sprawdza dane w Bloomreach.

Krok 3: Włącz integrację w kampanii

  1. W edytorze przejdź do Połącz > Integracje > Bloomreach i kliknij Aktywuj.
  2. Jeśli masz połączonych kilka projektów, wybierz właściwy w polu Wybierz konto.
  3. 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.
  4. Wybierz kategorię zgody, którą mają otrzymać osoby, np. „newsletter”, albo żadną.
  5. 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.
  6. 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”.
Potrzebujesz pomocy?

Nadal potrzebujesz pomocy?

Prawdziwi ludzie chętnie ci pomogą. Jeśli już korzystasz ze Scratchera, najszybciej skontaktujesz się z nami przez czat na platformie.

  • Czat z nami

    Zaloguj się i kliknij przycisk czatu w prawym dolnym rogu. Rex odpowie od razu, a nasz zespół jest o jedno kliknięcie dalej.

  • Umów spotkanie

    Bezpłatna 30-minutowa rozmowa wideo z naszym zespołem: prezentacja, pomysły na kampanie lub pomoc w konfiguracji.

  • Napisz do nas

    Napisz na contact@scratcher.io, a odezwiemy się do ciebie.