Połącz Mixpanel z Elido

Elido wysyła zdarzenie link_click do API ingestii Mixpanel za każdym razem, gdy ktoś kliknie jeden z Twoich skróconych linków. Jeśli Twój zespół już pracuje w Mixpanel, zaangażowanie odbiorców w linki pojawi się obok zdarzeń produktu bez dodawania skryptu śledzącego w jakimkolwiek miejscu.

Przekazywane są tylko kliknięcia. Przekazywanie zdarzeń konwersji do Mixpanel jest planowane.

Czego potrzebujesz

• Projektu Mixpanel.
• Project Token projektu. W modelu Mixpanel nie jest on sekretem, ale Elido nadal przechowuje go w postaci zaszyfrowanej.
• Informacji o rezydencji danych projektu: US, EU lub India.
• Roli Admin lub Owner w Twoim workspace Elido (uprawnienie conversions.manage).

Krok 1: Znajdź token projektu i rezydencję

1. Zaloguj się do Mixpanel i otwórz Settings → Project Settings.
2. W sekcji Access Keys skopiuj Project Token. Nie używaj API Secret ani konta usługi, ponieważ Elido ich nie potrzebuje.
3. Sprawdź wartość Data Residency projektu. W Elido wybierzesz tę samą wartość.

Krok 2: Połącz się w Elido

1. Przejdź do Dashboard → Integrations → Mixpanel.
2. Kliknij Connect Mixpanel.
3. Wklej token w polu Project Token.
4. Ustaw Data residency zgodnie z projektem:
   • United States wysyła dane do api.mixpanel.com (domyślnie).
   • EU wysyła dane do api-eu.mixpanel.com.
   • India wysyła dane do api-in.mixpanel.com.
5. Kliknij Save. Panel pokaże teraz Connected, a token będzie zamaskowany z wyjątkiem jego pierwszych i ostatnich czterech znaków.

Przekazywanie obejmuje każdy link w workspace, bez przełącznika dla poszczególnych linków. Rozpoczyna się w ciągu około 5 minut od zapisania, a zmiana tokena lub rezydencji danych albo odłączenie zaczyna obowiązywać w tym samym czasie.

Krok 3: Przetestuj połączenie

Kliknij Test connection. Elido wysyła jedno zdarzenie link_click z elido_test: true i slugiem _test, a pod przyciskiem pokazuje odpowiedź Mixpanel: status HTTP, host, do którego wysłano żądanie, oraz treść odpowiedzi.

Pozytywny wynik nie jest dowodem poprawności. Punkt końcowy /track Mixpanel nie sprawdza, czy token jest prawidłowy ani czy projekt znajduje się w tej rezydencji, więc nieprawidłowy token lub region również mogą przejść test. Błąd jest natomiast rzeczywisty: Mixpanel odrzucił zdarzenie, a komunikat wyjaśnia dlaczego.

Co wysyła Elido

Każde kliknięcie staje się jednym zdarzeniem:

{
  "event": "link_click",
  "properties": {
    "token": "your-project-token",
    "distinct_id": "elido-link-4711",
    "time": 1789000000,
    "workspace_id": 42,
    "link_id": 4711,
    "slug": "spring-26",
    "destination": "https://example.com/spring",
    "country": "DE",
    "device": "mobile",
    "ip": "203.0.113.7"
  }
}

• distinct_id to elido-link- oraz ID linku, więc jest to jedna wartość na link, a nie na odwiedzającego.
• time to czas kliknięcia w sekundach uniksowych.
• destination to URL, do którego przekierowano odwiedzającego.
• country to dwuliterowy kod kraju, a device to typ urządzenia.
• ip to adres IP odwiedzającego; Mixpanel używa go do własnej geolokalizacji.
• Zdarzenie testowe dodaje elido_test: true.

Przekazywane jest każde zarejestrowane kliknięcie, w tym kliknięcia, które analityka Elido oznacza jako podejrzany ruch lub ruch botów. Jeśli Mixpanel jest nieosiągalny, Elido ponawia próbę raz po sekundzie, a następnie odrzuca to zdarzenie; nie ma kolejki ani ponownego odtworzenia. Przewodnik po poszczególnych polach i pomysły na raporty znajdziesz w artykule Zdarzenia link_click w Mixpanel.

Jak działa distinct_id i jakie ma ograniczenia

Ponieważ distinct_id jest przypisane do linku, każde kliknięcie tego samego linku jest liczone przez Mixpanel jako ten sam "użytkownik". Oznacza to, że:

• Uniques dla link_click liczą linki, a nie osoby. Zamiast tego używaj łącznej liczby zdarzeń.
• Lejki od link_click do zdarzenia rejestracji lub zakupu nie połączą się, ponieważ te zdarzenia należą do innego distinct_id.
• Limit hot shard w Mixpanel dotyczy każdego distinct_id, więc w pierwszej kolejności problem pojawi się przy jednym bardzo aktywnym linku.

Aby obecnie śledzić osobę od kliknięcia do rejestracji, dodaj tagi UTM do docelowego URL i pozwól SDK Mixpanel na stronie docelowej je przechwycić, a następnie zidentyfikuj tam użytkownika tak jak zwykle.

Rozwiązywanie problemów

Test connection przechodzi, ale w Mixpanel nic się nie pojawia. Najpierw sprawdź token: skopiuj go ponownie z Settings → Project Settings → Access Keys. Następnie sprawdź Data residency względem ustawienia projektu. Oba te błędy pozwalają przejść test, jak wyjaśniono powyżej.

Test connection kończy się niepowodzeniem. Przeczytaj błąd i treść odpowiedzi pod przyciskiem; pochodzą bezpośrednio z Mixpanel. Popraw token lub rezydencję danych, kliknij Update key, zapisz i przetestuj ponownie.

Zdarzenia trafiają do niewłaściwego projektu. Tokeny są przypisane do projektów. Jeśli masz ich kilka, upewnij się, że token został skopiowany z właściwego projektu.

Rzeczywiste kliknięcia nie pojawiają się od razu po połączeniu. Rozpoczęcie przekazywania może zająć około 5 minut. Następnie kliknij skrócony link i sprawdź widok Events.

Użytkownicy Mixpanel nie pasują do zidentyfikowanych użytkowników. To oczekiwane zachowanie: distinct_id Elido jest przypisane do linku. Obejście z użyciem UTM opisano w sekcji powyżej.