Ś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.