7 min czytaniaIntegracje

Śledzenie linków w Mixpanel: kliknięcia krótkich linków jako zdarzenia

Śledzenie linków w Mixpanel z Elido: każde kliknięcie krótkiego linku staje się zdarzeniem link_click po stronie serwera. Konfiguracja, właściwości, limity tożsamości i jak to zweryfikować.

Marius Voß
DevRel · edge infra
Diagram śledzenia linków w Mixpanel: kliknięcie krótkiego linku opuszcza przekierowanie Elido jako zdarzenie link_click po stronie serwera i trafia do widoku Events w Mixpanel

Śledzenie linków w Mixpanel w Elido działa po stronie serwera i jednokierunkowo: za każdym razem, gdy ktoś klika jeden z Twoich krótkich linków, Elido wysyła zdarzenie link_click do punktu końcowego track w Mixpanel wraz z tokenem Twojego projektu. Zdarzenie niesie slug linku, ID linku, kraj i urządzenie odwiedzającego, cel, do którego został wysłany, oraz znacznik czasu. Nic nie uruchamia się w przeglądarce odwiedzającego, więc blokery reklam i banery zgody go nie dotykają.

Haczyk tkwi w tożsamości. Każde zdarzenie jest kluczowane linkiem, a nie osobą, co oznacza, że możesz liczyć i segmentować kliknięcia w Mixpanel cały dzień, ale nie możesz podążyć za klikającym do swojego produktu na podstawie samego tego zdarzenia. Pokażę, do czego się to nadaje, jak to skonfigurować, jak to sprawdzić w widoku Events i gdzie sięgnąłbym po coś innego.

Jeśli wciąż decydujesz, co tagować, zanim zajmiesz się resztą, fundamentalny przewodnik po śledzeniu UTM od początku do końca to lepszy punkt startu. Mixpanel widzi tylko to, co niesie link.

Co Elido wysyła do Mixpanel przy każdym kliknięciu

Jedno kliknięcie, jedno zdarzenie. Przekaźnik buduje partię z jednym zdarzeniem i wysyła ją metodą POST do /track na hoście przyjmującym dane odpowiadającym ustawieniu rezydencji danych integracji (api.mixpanel.com dla US, api-eu.mixpanel.com dla UE, api-in.mixpanel.com dla Indii), uwierzytelnioną tokenem wewnątrz właściwości, co jest sposobem, w jaki API przyjmujące Mixpanel oczekuje zdarzeń po stronie serwera.

Oto pełny ładunek, przycięty tylko o wartość tokenu:

[
  {
    "event": "link_click",
    "properties": {
      "token": "<your project token>",
      "distinct_id": "elido-link-4711",
      "workspace_id": 12,
      "link_id": 4711,
      "slug": "spring-26",
      "country": "DE",
      "device": "mobile",
      "destination": "https://shop.example/spring?utm_source=newsletter",
      "time": 1790000000,
      "ip": "203.0.113.24"
    }
  }
]

To wszystko. Krótka lista, i to celowo.

WłaściwośćCo zawieraCo z tym zrobić w Mixpanel
slug / link_idKtóry krótki link został klikniętyWymiar podziału dla każdego raportu
destinationAdres URL, na który trafił odwiedzający, po regułach routinguSprawdzaj, który wariant geo lub urządzenia zadziałał
country, deviceUstalone przy przekierowaniuSegmentuj bez polegania na własnym domysłem Mixpanel
ipAdres odwiedzającegoMixpanel wyznacza miasto i region, a potem to odrzuca
distinct_idelido-link-<link_id>Przeczytaj sekcję o tożsamości, zanim użyjesz Uniques

Dwa szczegóły warto znać. destination to cel już rozwiązany, więc jeśli smart link wysyła iPhone'y do App Store, a resztę na Twoją stronę, zobaczysz oba adresy URL. A tagi UTM podróżują tylko wewnątrz tego ciągu docelowego; nie ma osobnych właściwości utm_source czy utm_campaign, więc jeśli chcesz je mieć jako kolumny, będziesz potrzebować właściwości pochodnej w Mixpanel. To jedna rzecz, którą zrobiłbym od pierwszego dnia.

Oczywiste boty, czyli crawlery, które ujawniają się w swoim user agencie, są filtrowane przy przekierowaniu i nigdy nie docierają do Mixpanel.

Konfigurowanie integracji z Mixpanel

Cała konfiguracja to dwa pola. Aby wysyłać zdarzenia kliknięć do Mixpanel, potrzebujesz projektu Mixpanel i jego tokenu projektu, który znajduje się w Project Settings w Mixpanel; token jest kluczem do zapisu przeznaczonym do osadzania, więc wklejenie go u dostawcy jest normalne. Nie wklejaj sekretu API, który jest innym ciągiem i nie jest tym, czego używa przekaźnik.

  1. W swoim workspace Elido otwórz Integrations i wybierz kartę Mixpanel.
  2. Kliknij Connect Mixpanel, wklej token w pole Project Token i wybierz Data residency: US (domyślnie), EU lub India, zgodnie z wartością Data Residency w ustawieniach Twojego projektu Mixpanel. Zapisz. Elido szyfruje token w spoczynku i nigdy nie pokazuje go z powrotem w pełni.
  3. Odczekaj kilka minut. Ustawienia integracji workspace są krótko buforowane po stronie przekazywania, więc pierwsze kliknięcia po zapisaniu mogą jeszcze nie zostać wysłane.
  4. Kliknij jeden ze swoich linków z telefonu.

Nie ma przełącznika per link. Po podłączeniu każde kliknięcie w workspace jest przekazywane, co pasuje zespołowi, który mieszka w Mixpanel, a nie pasuje workspace obsługującemu krótkie linki dla dwudziestu niepowiązanych klientów. Jeśli to Twój przypadek, najpierw rozdziel klientów na osobne workspace.

Sprawdzanie widoku Events, zanim czemukolwiek zaufasz

To, co Mixpanel nazywał kiedyś Live View, nazywa się teraz widokiem Events, pod Data w lewej nawigacji, a przewodnik debugowania Mixpanel poleca go jako pierwszy przystanek dokładnie w tym celu. Otwórz go, przefiltruj do link_click, a potem dotknij swój krótki link na telefonie, który nie jest podłączony do biurowego Wi-Fi.

Przepływ kliknięcia krótkiego linku do Mixpanel: odwiedzający dotyka linku, przekierowanie Elido odpowiada jako pierwsze i rejestruje kliknięcie, przekaźnik wysyła zdarzenie link_click do punktu końcowego track Mixpanel dla regionu rezydencji danych ustawionego w Elido (US, UE lub Indie) z jednym ponowieniem, a zdarzenie pojawia się w widoku Events Mixpanel

Powinieneś zobaczyć zdarzenie w ciągu kilku sekund. Rozwiń je i sprawdź trzy rzeczy: slug pasuje do linku, który dotknąłeś, country to miejsce, w którym faktycznie jest telefon, a własne miasto i region Mixpanel są wypełnione na podstawie ip. Jeśli miasto pokazuje centrum danych, Twój test przeszedł przez VPN.

Przycisk Test connection w panelu integracji wysyła jedno zdarzenie link_click oznaczone jako elido_test: true i pokazuje odpowiedź Mixpanel pod przyciskiem. To przydatne, ale nie jest dowodem: punkt końcowy track Mixpanel przyjmuje dowolny token i nigdy nie sprawdza rezydencji, więc zielony wynik przy niewłaściwym tokenie lub niewłaściwym regionie wciąż oznacza, że nic nie trafia do Twojego projektu. Jedynym dowodem, który bym zaakceptował, jest zdarzenie, które widzisz jako efekt prawdziwego kliknięcia.

Oto ograniczenie tożsamości, powiedziane wprost. distinct_id to elido-link- plus ID linku, więc każde kliknięcie spring-26 należy do jednego syntetycznego "użytkownika" Mixpanel.

Mixpanel distinct_id per link: trzech różnych odwiedzających klika ten sam krótki link i wszystkie trzy zdarzenia link_click dzielą distinct_id elido-link-4711, więc Mixpanel liczy jednego użytkownika, podczas gdy SDK Mixpanel na stronie docelowej widzi trzy osobne urządzenia niosące tagi UTM

Sumy działają. Podziały według slugu, kraju, urządzenia i celu działają, podobnie jak trendy w czasie. Trzy rzeczy się psują:

  • Uniques na link_click liczą linki, nie ludzi. Kampania z 40 000 kliknięć na dwóch linkach pokazuje dwóch unikalnych użytkowników.
  • Lejki zaczynające się od link_click i kończące na Twoim zdarzeniu rejestracji się nie połączą, bo rejestracja należy do innego distinct_id.

Jest trzecia rzecz, na którą większość zespołów nigdy nie trafia. Mixpanel egzekwuje limity hot shard na poziomie 200 tys. zdarzeń na distinct_id dziennie, a powyżej tego zdarzenia są przemianowywane na $hotshard_events. Pojedynczy link, który naprawdę stanie się viralowy, może przekroczyć tę granicę, a ponieważ ID jest per link, to właśnie ten jeden link zostanie dotknięty.

Dlaczego nie ID per odwiedzający? Bo przekierowanie nie wie, kim jest odwiedzający, a wolałbym, żeby nie ustawiało ciasteczka na domenie, której odwiedzający nigdy nie wybrał odwiedzenia. Uczciwy kompromis.

Łączenie kliknięć krótkich linków z użytkownikami w sposób, który działa

Wzorzec, który działa, wykorzystuje obie połowy do tego, w czym każda jest dobra. Niech zdarzenie po stronie serwera Elido da Ci pełną liczbę kliknięć, w tym kliknięcia osób, które odbijają się, zanim Twoja strona się załaduje. Niech SDK Mixpanel na Twojej stronie docelowej zajmie się tożsamością.

Umieść tagi UTM na adresie docelowym. Biblioteka JavaScript Mixpanel domyślnie śledzi parametry UTM i zapisuje wartości pierwszego dotknięcia na profilu, więc gdy ten odwiedzający później się zarejestruje i wywołasz identify, kampania przylega do prawdziwej osoby. Kliknięcie krótkiego linku i wyświetlenie strony docelowej dzielą wtedy wartość kampanii, a nie ID użytkownika, i łączysz je w raporcie na utm_campaign. To połączenie na poziomie kampanii, czyli bardziej zgrubne niż na poziomie użytkownika, i uważam, że to właściwy poziom dla tych danych.

Chcesz zestawić obok siebie sumy kliknięć i sesje na stronie docelowej? Spodziewaj się, że się nie zgodzą; kliknięcia krótkich linków kontra sesje GA4 wyjaśnia, dlaczego ta sama luka pojawia się w każdym narzędziu analitycznym, Mixpanel włącznie.

Jeśli to jest konfiguracja, której Ci brakowało, podłącz workspace i wyślij swoją następną kampanię przez linki marki.

Gdzie dziś nie wystarcza

Trzy luki, uszeregowane według tego, jak prawdopodobnie Cię ugryzą.

Adres IP odwiedzającego podróżuje w każdym zdarzeniu. Przy rezydencji w UE trafia do hosta przyjmującego w UE; przy domyślnym ustawieniu US trafia do punktu końcowego w USA, a przewodnik po rezydencji danych w UE opisuje, jak to rozważyć. Jeśli chodzi konkretnie o Mixpanel, w tym o sposób sprawdzenia rezydencji projektu, zobacz Rezydencja danych Mixpanel w UE.

Dostarczenie działa na zasadzie best effort. Nieudany POST otrzymuje jedno ponowienie po sekundzie, a potem jest porzucany, a zdarzenia nie niosą żadnego $insert_id, więc ponowienie po wolnym, ale udanym wywołaniu może podwoić liczbę.

Nie ma referrera ani przeglądarki w zdarzeniu, a kliknięcia oznaczone przez przekierowanie jako podejrzane wciąż są przekazywane. Sprawdź dashboard analityki kliknięć, kiedy tego potrzebujesz.

Konwersje nie są tego częścią. Śledź przychody tam, gdzie żyje Twój ID użytkownika.

Powiązane na blogu

Najczęściej zadawane pytania

Jak wysyłać zdarzenia kliknięć do Mixpanel z krótkiego linku?

Wklej token swojego projektu Mixpanel w integracji Mixpanel w Twoim workspace Elido i zapisz. Od tej pory każde kliknięcie linku w tym workspace jest wysyłane po stronie serwera do Mixpanel jako zdarzenie link_click, z slugiem, ID linku, krajem, urządzeniem i celem jako właściwościami. Żaden JavaScript nie uruchamia się przy przekierowaniu.

Jakiej nazwy zdarzenia używa Elido w Mixpanel?

Zdarzenie nazywa się link_click i ta nazwa jest stała. Buduj swoje raporty na tej nazwie. Jeśli na starszych stronach Elido widzisz inną nazwę zdarzenia, zaufaj temu, co pojawia się w Twoim widoku Events, bo to jest ładunek, który przekaźnik faktycznie wysyła.

Czy Mixpanel może połączyć kliknięcie krótkiego linku ze znanym użytkownikiem?

Nie na podstawie samego przekazanego zdarzenia. Elido ustawia distinct_id na jedną wartość na link, więc każde kliknięcie tego samego linku wygląda jak ten sam użytkownik Mixpanel. Aby dotrzeć do prawdziwej osoby, dodaj tagi UTM do adresu docelowego i pozwól, żeby SDK Mixpanel na stronie docelowej je przechwycił, a następnie zidentyfikuj tam użytkownika tak, jak robisz to normalnie.

Dlaczego moje kliknięcia z Elido nie pojawiają się w Mixpanel?

Sprawdź trzy rzeczy po kolei. Token musi być tokenem projektu z właściwego projektu, nie sekretem API. Odczekaj kilka minut po zapisaniu, zanim pierwsze kliknięcie zostanie przekazane. Wreszcie, jeśli Twój projekt Mixpanel korzysta z rezydencji danych w UE lub Indiach, ustaw tę samą rezydencję w integracji Elido: zdarzenia wysyłane do niewłaściwego hosta przyjmującego nie są w ogóle przyjmowane.

Czy Elido przekazuje do Mixpanel również konwersje?

Integracja Mixpanel obejmuje dziś tylko kliknięcia; w ładunku nie ma osobnego zdarzenia konwersji. Przychody śledź z własnego backendu albo SDK Mixpanel z prawdziwym ID użytkownika. To tam żyje tożsamość, więc konwersja trafia na właściwy profil zamiast na zastępczy identyfikator per link.

Czy Mixpanel przechowuje adres IP odwiedzającego, który wysyła Elido?

Według dokumentacji geolokalizacji Mixpanel właściwość ip na zdarzeniu jest używana do wyznaczenia kraju, regionu i miasta, a następnie odrzucana przed zapisaniem zdarzenia. Otrzymujesz więc lokalizację na poziomie miasta dla każdego kliknięcia w Mixpanel, ale sam adres IP nie powinien pojawiać się jako właściwość, którą można przeszukiwać.

Wypróbuj Elido

Wklej URL, otrzymaj krótki link

Bez rejestracji. Link działa 30 dni. Zarejestruj się, aby zachować go na zawsze.

Za darmo, bez rejestracji · 2 dziennie

Wypróbuj Elido

Skracarka URL hostowana w UE: własne domeny, głęboka analityka i otwarte API. Darmowy plan - bez karty kredytowej.

Tagi
mixpanel link tracking
send click events to mixpanel
mixpanel short link clicks
mixpanel server-side tracking
mixpanel distinct_id
link click analytics

Czytaj dalej