Śledzenie linków w Klaviyo: kliknięcia krótkich linków jako niestandardowa metryka

Śledzenie linków w Klaviyo przez Elido działa po stronie serwera i tylko w jednym kierunku: każde kliknięcie jednego z Twoich krótkich linków jest wysyłane do Events API Klaviyo jako zdarzenie na niestandardowej metryce o nazwie Elido Link Click. Zdarzenie zawiera slug i ID linku, kraj i urządzenie, miejsce docelowe, do którego skierowano odwiedzającego, oraz czas kliknięcia. Metryka jest tworzona przy pierwszym użyciu, a Ty możesz tworzyć na jej podstawie wykresy, filtrować ją i budować raporty tak jak dla każdej innej metryki.

To, czego ta integracja nie robi, to przypisanie kliknięcia do profilu subskrybenta. Każde zdarzenie jest powiązane z linkiem przez anonimowy identyfikator, więc link kliknięty przez 4000 osób pojawia się w Klaviyo jako jeden anonimowy profil z 4000 zdarzeń na osi czasu. Ten jeden fakt decyduje o tym, do czego integracja się nadaje. Omówię ładunek, konfigurację, możliwości flow i segmentów oraz porównanie z natywnym śledzeniem kliknięć Klaviyo.

Jeśli Twoje linki nie są jeszcze konsekwentnie otagowane, najpierw to napraw. Zasady opisane w artykule Śledzenie UTM od początku do końca obejmują tę konwencję, a Klaviyo zobaczy tylko to, co niesie link.

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

Jedno kliknięcie, jeden POST. Forwarder wywołuje https://a.klaviyo.com/api/events/, przekazując Twój prywatny klucz w nagłówku Authorization: Klaviyo-API-Key oraz nagłówek revision: 2023-02-22. To endpoint opisany w dokumentacji Create Event Klaviyo.

Oto pełna treść żądania z przykładowymi wartościami:

{
  "data": {
    "type": "event",
    "attributes": {
      "time": "2026-09-21T09:14:22Z",
      "properties": {
        "workspace_id": 12,
        "link_id": 4711,
        "slug": "autumn-drop",
        "country": "DE",
        "device": "mobile",
        "destination": "https://shop.example/autumn?utm_source=instagram",
        "ip": "203.0.113.24"
      },
      "metric": {
        "data": {
          "type": "metric",
          "attributes": { "name": "Elido Link Click" }
        }
      },
      "profile": {
        "data": {
          "type": "profile",
          "attributes": { "anonymous_id": "elido-link-4711" }
        }
      }
    }
  }
}

To wszystko. Bez adresu e-mail, numeru telefonu, pól UTM jako osobnych właściwości, referrera i przeglądarki.

Kilka szczegółów ma znaczenie, gdy zaczynasz filtrować. destination to adres URL, który faktycznie otrzymał odwiedzający po zastosowaniu reguł routingu smart link, więc link kierujący użytkowników iPhone'ów do App Store, a wszystkich pozostałych do Twojego sklepu, wygeneruje dwie wartości destination. device przyjmuje jedną z wartości mobile, tablet lub desktop. Tagi UTM istnieją wyłącznie w ciągu destination, więc bezpośrednie filtrowanie po utm_campaign nie jest możliwe; filtruj zamiast tego po slug, który zwykle jest zresztą wygodniejszym kluczem.

Roboty indeksujące, które identyfikują się w user agencie, są odrzucane podczas przekierowania i nigdy nie są dalej wysyłane. Kliknięcia oznaczone przez własne heurystyki Elido jako podejrzane nadal są wysyłane, a zdarzenie nie zawiera właściwości, która by to sygnalizowała.

Jeden anonimowy profil na link i dlaczego tak jest

Każde zdarzenie Klaviyo musi wskazywać profil identyfikowany adresem e-mail, numerem telefonu, zewnętrznym ID, ID Klaviyo albo anonymous_id. Elido zawsze wysyła tę ostatnią wartość, zbudowaną jako elido-link- plus ID linku.

Dlatego każde kliknięcie autumn-drop trafia do tego samego profilu. Pierwsze kliknięcie go tworzy, a każde kolejne jest dopisywane do jego osi czasu.

Ma to trzy konsekwencje, a trzecia mnie zaskoczyła.

Po pierwsze, zliczenia działają, ale nie znamy osób. Działają łączne zliczenia kliknięć oraz kliknięcia według linku, kraju i urządzenia. Wszystko, co jest określane jako "Unique", zlicza linki, nie ludzi.

Po drugie, anonimowy profil nie ma adresu e-mail ani numeru telefonu. Może znajdować się w segmencie, ale nie może otrzymać wiadomości.

Po trzecie, kliknięcia w tej samej sekundzie są scalane. Forwarder nie wysyła unique_id, a dokumentacja Klaviyo mówi, że bez niego deduplikuje zdarzenia według czasu z dokładnością do sekundy dla tego samego profilu i metryki. Ponieważ profil jest przypisany do linku, dwie osoby klikające ten sam link w tej samej sekundzie stają się jednym zdarzeniem. Przy linku w newsletterze, gdzie kliknięcia napływają stopniowo, nigdy tego nie zauważysz. Przy linku w dużej relacji na Instagramie, gdzie w szczycie napływa kilka kliknięć na sekundę, liczba w Klaviyo będzie niższa niż liczba w Twojej analityce kliknięć Elido. Zaletą jest to, że jedno ponowienie przez forwardera nie zdubluje zliczenia, bo ponowione zdarzenie ma ten sam czas.

Dlaczego nie używać ID odwiedzającego? Przekierowanie nie wie, kim jest odwiedzający, a ja wolałabym, żeby nie zapisywało ciasteczka w domenie, której odwiedzający nigdy nie wybrał do odwiedzenia. Taki sam kompromis przyjęliśmy przy śledzeniu linków w Mixpanel, gdzie z tego samego powodu distinct_id jest przypisane do linku.

Konfiguracja śledzenia linków Klaviyo w Elido

Konfiguracja wymaga jednego pola.

1. W Klaviyo przejdź do Settings, następnie API keys, i utwórz prywatny klucz API. Dokumentacja Create Event wymienia events:write jako wymagany zakres. Notatki konfiguracji w aplikacji Elido wspominają też o profiles:write; zacząłabym wyłącznie od events i dodała drugi zakres, jeśli Klaviyo zwróci 403.
2. W swojej przestrzeni roboczej Elido otwórz Integrations, wybierz kartę Klaviyo i kliknij Connect Klaviyo.
3. Wklej klucz w polu Private API Key i zapisz. Elido szyfruje go w spoczynku, a później pokazuje go wyłącznie w zamaskowanej postaci.
4. Odczekaj około pięciu minut. Ustawienia integracji są buforowane po stronie forwardera, więc pierwsze kliknięcia po zapisaniu mogą nie zostać wysłane.
5. Kliknij jeden ze swoich linków na telefonie, następnie otwórz Analytics > Metrics w Klaviyo i poszukaj Elido Link Click.

Przycisk Test connection wysyła do Klaviyo jedno testowe zdarzenie (oznaczone elido_test: true) i pokazuje odpowiedź Klaviyo, więc unieważniony albo tylko do odczytu klucz zawiedzie od razu. Potwierdza to działanie klucza, ale nie to, że metryka trafi do oczekiwanego profilu. Dowodem jest pojawienie się metryki w Klaviyo po prawdziwym kliknięciu.

Nie ma przełącznika dla pojedynczego linku. Przekazywane jest każde kliknięcie w przestrzeni roboczej, także linków, które nie były przeznaczone do marketingu. Agencje obsługujące wielu klientów powinny przydzielić każdemu klientowi osobną przestrzeń roboczą przed podłączeniem czegokolwiek.

Natywne śledzenie kliknięć Klaviyo a metryka Elido

Klaviyo już śledzi kliknięcia we własnych e-mailach i wiadomościach tekstowych, a przy pracy na poziomie subskrybenta to natywne śledzenie wygrywa. Przepisuje każdy link przez swoją domenę śledzenia, rejestruje Clicked Email albo Clicked SMS na profilu odbiorcy i oznacza prawdopodobne skanery właściwością Bot Click, którą możesz wykluczyć z raportów.

Metryka Elido przydaje się wszędzie indziej: przy linku w biogramie na Instagramie, kodzie QR na opakowaniu, linku wysłanym przez partnera z jego własnego newslettera czy linku w opisie podcastu. Żadne z tych kliknięć nie przechodzi przez tracker Klaviyo. Gdy forwarder jest włączony, pojawiają się na tym samym koncie co metryki e-mailowe, więc jeden dashboard Klaviyo może zestawić obok siebie "kliknięcia jesiennego linku z dowolnego źródła" i "kliknięcia jesiennego e-maila".

Zwróć uwagę na jedną interakcję. W wysyłanych e-mailach Klaviyo dopisuje parametr _kx do każdego linku, aby jego skrypt działający na stronie mógł zidentyfikować osobę klikającą w Twojej witrynie. Jeśli link w Twoim e-mailu jest krótkim linkiem Elido, _kx trafia do krótkiego adresu URL, a przekierowanie Elido nie przenosi przychodzących parametrów zapytania do miejsca docelowego. Identyfikacja na stronie zostaje utracona. Moja zasada: w e-mailach Klaviyo linkuj bezpośrednio do własnej witryny i pozwól Klaviyo śledzić kliknięcia; używaj krótkich linków w kanałach, do których Klaviyo nie ma dostępu.

Przypisywanie kliknięć do prawdziwych profili subskrybentów

Czasami chcesz przypisać kliknięcie do konkretnej osoby. Obecnie działają dwa sposoby i żaden z nich nie wykorzystuje forwardera.

Najprościej pozwolić, aby tożsamość rozpoznało śledzenie Klaviyo działające na stronie. Wyślij współdzielony krótki link do miejsca docelowego z tagami UTM i upewnij się, że na tej stronie działa JavaScript Klaviyo. Odwiedzający, którzy mają już ciasteczko z wcześniejszego kliknięcia e-maila albo zapiszą się przez formularz, będą mieli aktywność na stronie przypisaną do swojego profilu. Kliknięcie krótkiego linku pozostaje anonimowe, ale późniejsza wizyta już nie. Następnie porównujesz te dwa źródła na poziomie kampanii, co jest mniej szczegółowe niż poziom osoby, ale uczciwie pokazuje, co każda ze stron wie.

Cięższa metoda to linki dla poszczególnych odbiorców. Przy małej, wartościowej liście, na przykład sekwencji B2B albo zaproszeniach VIP, utwórz przez API jeden krótki link dla każdej osoby pod adresem /v1/workspaces/{workspace_id}/links i prowadź własną tabelę mapującą ID linku na adres e-mail. Zasubskrybuj zdarzenia linków przez webhooki, odszukaj adres e-mail po nadejściu kliknięcia i wyślij do Klaviyo własne zdarzenie z tym adresem jako identyfikatorem profilu. To może być około czterdziestu wierszy kodu i jest to jedyna droga, która przypisuje kliknięcie Elido do nazwanego subskrybenta. Nie robiłabym tego dla newslettera do 200 000 osób.

Jeśli brakowało Ci zliczeń kliknięć z wielu kanałów wewnątrz Klaviyo, wybierz plan i połącz przestrzeń roboczą, a następnie skieruj przez markowe linki swoją następną kampanię w mediach społecznościowych.

Dzisiejsze ograniczenia forwardera

Pięć rzeczy, które trzeba wiedzieć, zanim raport zacznie od niego zależeć.

Dostarczenie jest realizowane zgodnie z zasadą best effort. Nieudany POST jest ponawiany raz po sekundzie, a następnie odrzucany; nic nie trafia do kolejki na później.

Events API ma limit dla pojedynczego konta: 350 żądań na sekundę w seriach i 3500 na minutę w sposób stały. Ten budżet jest współdzielony przez każdą inną aplikację zapisującą zdarzenia na Twoim koncie. Skok kampanii powyżej około 58 kliknięć na sekundę, utrzymujący się przez minutę, spowoduje błędy 429, a po jednym ponowieniu te kliknięcia znikną z Klaviyo.

Nagłówek revision jest stary. Klaviyo daje każdej rewizji API dwa lata przed wycofaniem, a żądania do wycofanej rewizji są obsługiwane przez najstarszą dostępną następną rewizję. Rewizja 2023-02-22 przekroczyła ten termin, więc obecnie forwarder działa dzięki mechanizmowi fall-forward. Działa. Nadal chciałabym, żeby nagłówek został zaktualizowany.

Adres IP odwiedzającego jest wysyłany jako właściwość zdarzenia. Należy się spodziewać, że zostanie zapisany jak każda inna właściwość, więc traktuj go jako dane osobowe w swoich rejestrach czynności przetwarzania. Przewodnik po lokalizacji danych w UE dla zespołów marketingowych opisuje, jak to ocenić.

Tylko kliknięcia. Konwersje nie są częścią ładunku, więc przychód śledź tam, gdzie znajduje się tożsamość klienta, czyli w większości sklepów w natywnej integracji e-commerce Klaviyo.

Powiązane na blogu

• Śledzenie UTM od początku do końca - konwencja tagowania, od której zależy połączenie danych na poziomie kampanii.
• Śledzenie linków w Mixpanel - ten sam wzorzec forwardera i ta sama tożsamość przypisana do linku.
• Webhooki dla zdarzeń linków - element budulcowy zdarzeń kliknięć przypisanych do odbiorców.
• Atrybucja kliknięć e-mailowych dla Mailchimp, Brevo i Klaviyo - szersze spojrzenie na platformy e-mailowe.
• Kliknięcia krótkich linków a sesje GA4 - dlaczego liczby kliknięć i sesji analitycznych nigdy się nie zgadzają.
• Monitorowanie adresów URL w Datadog - ten sam forwarder kliknięć zasilający dashboard Datadog.