Rozwiązywanie problemów

Typowe problemy z integracją i jak je rozwiązać. Wszystkie przykłady odnoszą się do API wersji v1.

Snippet nie ładuje się

Objaw: Snippet śledzący Selgeo nie wydaje się działać.

Możliwe przyczyny:

1. Brak tagu script lub jest on nieprawidłowy. Sprawdź, czy snippet jest obecny w kodzie HTML strony:

   <script
     src="https://cdn.selgeo.com/v1/selgeo.js"
     data-merchant="pk_test_YOUR_KEY"
     async
   ></script>

2. Content Security Policy (CSP) blokuje skrypt. Dodaj https://cdn.selgeo.com do dyrektywy script-src i https://api.selgeo.com do dyrektywy connect-src:

   script-src 'self' https://cdn.selgeo.com;
   connect-src 'self' https://api.selgeo.com;

3. Bloker reklam lub rozszerzenie przeglądarki blokuje żądanie. Przetestuj w oknie incognito z wyłączonymi rozszerzeniami.

4. Nieprawidłowy klucz API. Sprawdź klucz w Ustawienia > Klucze API w panelu.

Kliknięcia nie pojawiają się

Możliwe przyczyny:

1. Zły tryb. Jeśli używasz klucza pk_test_*, kliknięcia pojawiają się tylko w trybie testowym.
2. Brak parametru polecenia w adresie URL. Snippet szuka ?ref=abc123 w adresie URL.
3. Przekroczono limit szybkości. Punkt końcowy śledzenia pozwala na 1000 żądań na minutę na klucz publiczny.
4. Błąd sieci. Sprawdź kartę Sieć w Narzędziach deweloperskich pod kątem nieudanych żądań do api.selgeo.com.

Konwersje nie przypisane

Możliwe przyczyny:

1. Brak lub nieprawidłowy click_id. click_id łączy konwersję z jej pierwotnym kliknięciem.
2. Okno atrybucji wygasło. Sprawdź okno atrybucji programu w Programy > Ustawienia.
3. Partner niezatwierdzony. Konwersje są przypisywane tylko do zatwierdzonych partnerów.
4. Zduplikowana konwersja. Jeśli wyślesz ten sam external_transaction_id dwukrotnie, drugie żądanie zostanie odrzucone z 409 CONVERSION_DUPLICATE.
5. Niezgodność trybu. click_id wygenerowany kluczem pk_test_* może być dopasowany tylko przez konwersję zgłoszoną kluczem sk_test_*.

Brak click_id

Integracja Stripe Checkout:

const session = await stripe.checkout.sessions.create({
  metadata: {
    aff_click_id: clickId,
  },
});

Integracja API konwersji:

const clickId = __selgeo?.getClickId();

curl -X POST https://api.selgeo.com/api/v1/conversions \
  -H "Authorization: Bearer sk_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "click_id": "CLICK_ID",
    "event_type": "purchase",
    "external_transaction_id": "txn_123",
    "amount_cents": 4900,
    "currency": "EUR"
  }'

Nadal utknąłeś?

1. Sprawdź Dziennik audytu atrybucji w panelu.
2. Zweryfikuj integrację najpierw w trybie testowym.
3. Skontaktuj się z pomocą techniczną podając ID konta sprzedawcy i wszelkie ID żądań.