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

Połącz Apsis One

Utwórz klucz API w Apsis One, połącz go i wysyłaj nowe zapisy do sekcji wraz z ich atrybutami i subskrypcjami, krok po kroku.

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

  1. W Apsis One otwórz Account settings i przejdź do API keys (w sekcji integracji).
  2. Utwórz nowy klucz API. Nadaj mu nazwę, którą rozpoznasz, np. „Scratcher”.
  3. Daj kluczowi dostęp do sekcji, do których Scratcher ma wysyłać profile, z uprawnieniami opisanymi poniżej.
  4. 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

  1. W Scratcherze przejdź do Ustawienia > Integracje i kliknij Apsis One.
  2. Wybierz Region API: Europa lub Azja.
  3. Wklej Client ID i Client Secret.
  4. Kliknij Zainstaluj integrację. Scratcher loguje się do Apsis One, aby sprawdzić dane.

Krok 3: Włącz integrację w kampanii

  1. W edytorze przejdź do Połącz > Integracje > Apsis One i kliknij Aktywuj.
  2. Jeśli masz połączonych kilka kont Apsis One, wybierz właściwe w polu Wybierz konto.
  3. W polu Sekcja Apsis wybierz sekcję (Wybierz sekcję).
  4. 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.
  5. W polu Subskrypcje (zgody) wybierz subskrypcję, na którą mają zostać zapisane osoby, lub Brak. „Wybierz subskrypcję, do której uczestnik ma zostać zapisany.”
  6. 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.
  7. 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.
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.