Przypisywanie konwersji i sprzedaży

Konwersja to sprzedaż lub wpłata wspierającego, którą LinkHarbor może przypisać do kliknięcia na Twojej stronie. Dzięki temu widzisz nie tylko, jak często kliknięto link, ale też, co z tego wynikło. Ten artykuł jest dla twórców z własnym sklepem i dla programistów, którzy podłączają sklep. Konwersje możesz analizować, a sekrety callbacków tworzyć od planu Creator Pro.

#Skąd pochodzą konwersje

• Sprzedaże, które Twój sklep lub serwer zgłasza callbackiem sprzedaży
• Wpłaty wspierających przez Stripe; zwrot ponownie usuwa konwersję, zobacz Wpłaty wspierających przez Stripe

Każda konwersja dziedziczy dane kliknięcia, do którego należy: stronę, link, kraj, urządzenie, źródło wejścia i parametry UTM. Dlatego pojawia się w statystykach dokładnie tam, skąd przyszło kliknięcie.

#Jak działa przypisywanie

1. Odwiedzający klika link na Twojej stronie
2. LinkHarbor liczy kliknięcie i przy przekierowaniu dopisuje do docelowego adresu URL parametr lt_click_id z unikalnym ID kliknięcia
3. Twoja strona docelowa (na przykład sklep) odczytuje lt_click_id z adresu i przechowuje go do zakupu
4. Po zakupie Twój serwer wysyła do LinkHarbor callback sprzedaży z tym ID kliknięcia
5. Konwersja pojawia się w panelu i w statystykach strony

ID kliknięcia jest dopisywane tylko do celów zaczynających się od http:// lub https://. Linki mailto: ani tel: go nie dostają, bo parametr zepsułby tam temat lub numer telefonu. Kliknięcia botów również nie dostają ID kliknięcia.

#Tworzenie sekretu callbacku

Callback sprzedaży musi identyfikować się sekretem callbacku. Właściciele i admini zarządzają sekretami od planu Creator Pro w sekcji „Callback i API” w części menu dotyczącej konta.

1. Otwórz „Callback i API”
2. W karcie „Sekrety callbacków” kliknij „+ Utwórz nowy sekret”
3. Opcjonalnie wpisz nazwę, na przykład „Callback sklepu”
4. Kliknij „Utwórz sekret”
5. Od razu skopiuj sekret: jest pokazywany tylko raz

„Edytuj”

Zmienia nazwę i status (Aktywny lub Nieaktywny). Nieaktywny sekret jest odrzucany.

„↺ Zmień”

Tworzy nowy sekret. Stary natychmiast przestaje działać – wpisz więc nowy w swoim sklepie od razu.

„Usuń”

Usuwa sekret po potwierdzeniu.

„Ostatni callback:”

Pokazuje, kiedy sekret był ostatnio użyty, w przeciwnym razie „Jeszcze nie użyto”.

W jednym workspace możesz utworzyć do 5 sekretów callbacków.

#Wysyłanie callbacku sprzedaży

Twój serwer wysyła żądanie POST do API LinkHarbor. Sekret trafia do nagłówka X-Callback-Secret.

curl -X POST https://dock.at-harbor.com/v1/callbacks/sale \
  -H "Content-Type: application/json" \
  -H "X-Callback-Secret: YOUR_CALLBACK_SECRET" \
  -d '{
    "click_id": "3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a23",
    "order_id": "B-10042",
    "amount": "49.90",
    "currency": "EUR"
  }'

click_id

Wymagane. ID kliknięcia z lt_click_id (10–36 znaków).

order_id

Wymagane. Twój numer zamówienia (1–128 znaków). Dla jednego numeru zamówienia liczy się tylko jedna konwersja, więc powtórzony callback nie tworzy drugiej.

amount

Wymagane. Kwota jako liczba dziesiętna.

currency

Wymagane. Kod waluty z 3 liter, na przykład EUR.

occurred_at, meta

Opcjonalne. Czas zakupu i do 50 własnych kluczy (każdy 1–64 znaki) z dodatkowymi informacjami. Wartość to tekst o długości najwyżej 500 znaków, liczba, true/false lub null; API odrzuca zagnieżdżone obiekty.

Odpowiedzi

Wszystkie pola i kody błędów dla programistów opisuje artykuł Wysyłanie sprzedaży i własnych danych.

#Analiza konwersji

• Panel: kafelki „Konwersje” i „CVR” oraz karta „Konwersje” według źródła i medium UTM
• Statystyki strony: karta „Konwersje” z „CVR łącznie”, „CVR unikalny” i „Podział”
• CVR łącznie = konwersje podzielone przez kliknięcia; CVR unikalny = konwersje podzielone przez unikalne kliknięcia