Śledzenie konwersji

Elido śledzi dwie rzeczy związane z krótkim linkiem: kliknięcie (gdy ktoś przechodzi przez link) oraz konwersję (gdy ta sama osoba podejmuje później wartościowe działanie w Twojej witrynie). Śledzenie konwersji łączy te dwa zdarzenia, dzięki czemu widzisz nie tylko, które linki generują ruch, ale także te, które przynoszą rezultaty.

Co liczy się jako konwersja#

Konwersja to dowolne zdefiniowane przez Ciebie zdarzenie — zakup, rejestracja, przesłanie formularza, rozpoczęcie okresu próbnego. Elido nie narzuca konkretnej definicji. Wysyłasz zdarzenie konwersji, gdy nastąpi działanie; my przypisujemy je do kliknięcia, które sprowadziło użytkownika.

Panel konwersji w Analytics → Conversions pokazuje:

• Łączną liczbę konwersji i całkowity przypisany przychód.
• Konwersje w podziale na linki, kampanie, dni i platformy.
• Tabelę ostatnich indywidualnych zdarzeń konwersji z adresem e-mail klienta i przychodem.

Konfiguracja zdarzenia konwersji#

Opcja 1: Wywołanie API po stronie serwera#

Najbardziej niezawodna metoda. Gdy użytkownik zakończy działanie w Twoim backendzie, wyślij żądanie POST do punktu końcowego konwersji:

curl -X POST https://api.elido.app/v1/conversions \
  -H "Authorization: Bearer $ELIDO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": 42,
    "platform": "stripe",
    "customer_email": "[email protected]",
    "revenue_cents": 4900,
    "currency": "EUR",
    "converted_at": "2026-05-12T14:30:00Z"
  }'

Dołącz customer_email lub click_id w celu atrybucji. Jeśli przekażesz click_id (zwracany w nagłówkach odpowiedzi przekierowania jako X-Elido-Click-ID), atrybucja jest dokładna. Jeśli przekażesz tylko customer_email, dopasujemy go do ostatniego kliknięcia z tego adresu w obrębie okna atrybucji.

Opcja 2: Piksel po stronie klienta#

Dodaj piksel Elido do strony potwierdzenia (potwierdzenie zamówienia, sukces rejestracji itp.):

<script>
  window.elidoConvert = window.elidoConvert || function(opts) {
    fetch('https://api.elido.app/v1/conversions/pixel', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({
        workspace_id: opts.workspaceId,
        platform: opts.platform || 'web',
        revenue_cents: opts.revenueCents || 0,
        currency: opts.currency || 'EUR',
      }),
      credentials: 'include',
    });
  };
</script>

Następnie wywołaj go na stronie potwierdzenia:

<script>
  elidoConvert({
    workspaceId: 42,
    platform: 'web',
    revenueCents: 4900,
    currency: 'EUR',
  });
</script>

Piksel wykorzystuje plik cookie przeglądarki ustawiony podczas przekierowania, aby zidentyfikować kliknięcie, które poprzedziło konwersję. Działa to w przypadku ścieżek w obrębie tej samej przeglądarki i tego samego urządzenia. W przypadku atrybucji między urządzeniami lub przeglądarkami, metoda click_id po stronie serwera jest bardziej niezawodna.

Okna atrybucji#

Domyślnie konwersja jest przypisywana do ostatniego kliknięcia tego samego użytkownika w ciągu 30-dniowego okna. Jeśli ten sam użytkownik kliknął w tym okresie wiele linków, konwersja jest przypisywana do ostatniego kliknięcia (atrybucja last-touch).

Okno można skonfigurować dla każdego obszaru roboczego w Settings → Attribution. Dostępne opcje to 1 dzień, 7 dni, 30 dni i 90 dni.

Czytanie panelu konwersji#

Analytics → Conversions dzieli konwersje według:

• Platform — pole platform przekazywane w wywołaniu API (stripe, shopify, web lub dowolna wybrana etykieta).
• Top links — które krótkie linki wygenerowały najwięcej konwersji.
• Top campaigns — które kampanie konwertowały najlepiej.
• Daily revenue — wykres słupkowy przypisanego przychodu w czasie.

Przychód jest pokazywany jako suma przekazanych wartości revenue_cents. Jeśli nie śledzisz przychodu (np. w przypadku generowania leadów), możesz pozostawić wartość revenue_cents na poziomie 0 i korzystać wyłącznie z liczby konwersji.

Rozwiązywanie problemów#

Konwersje nie pojawiają się. Sprawdź odpowiedź API dla wywołania POST /v1/conversions — punkt końcowy zwraca identyfikator konwersji w przypadku sukcesu i szczegółowy komunikat o błędzie w przypadku niepowodzenia. Typowe problemy: brak identyfikatora obszaru roboczego, nieprawidłowy kod waluty (musi być zgodny z ISO 4217, np. EUR, a nie €) lub klucz API bez uprawnienia conversions:write.

Atrybucja nie zgadza się z oczekiwanymi kliknięciami. Jeśli używasz piksela (opartego na plikach cookie), sprawdź, czy przeglądarka użytkownika nie blokuje plików cookie podmiotów zewnętrznych. Mechanizm ITP w Safari i niektóre bloki reklamowe usuną plik cookie, zanim strona konwersji zostanie uruchomiona. Użyj metody click_id po stronie serwera dla niezawodnej atrybucji.

Kwoty przychodów nie zgadzają się z moim procesorem płatności. Liczby w Elido są dokładnie takie, jakie nam wysyłasz — nie pobieramy danych bezpośrednio ze Stripe ani od żadnego innego procesora. Jeśli występuje rozbieżność, porównaj wartości revenue_cents w wywołaniach API konwersji z rekordami płatności.

Jedna konwersja wyświetla się pod niewłaściwym linkiem. Atrybucja domyślnie korzysta z modelu last-touch. Jeśli użytkownik kliknął kilka linków przed konwersją, trafia ona do ostatniego kliknięcia. Jeśli ostatnie kliknięcie pochodziło z innej kampanii, jest to zachowanie zgodne z oczekiwaniami. Dostosuj okno atrybucji lub przełącz się na atrybucję first-touch w ustawieniach, jeśli model last-touch nie odpowiada Twoim potrzebom raportowania.