Passa al contenuto principale

Risoluzione dei problemi

Problemi di integrazione comuni e come risolverli. Tutti gli esempi fanno riferimento a API versione v1.

Lo snippet non si carica​

Sintomo: Lo snippet di tracciamento Selgeo non sembra eseguirsi.

Possibili cause:

  1. Il tag script manca o è malformato. Verifica che lo snippet sia presente nell'HTML della tua pagina:

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

  2. La Content Security Policy (CSP) blocca lo script. Aggiungi https://cdn.selgeo.com alla direttiva script-src e https://api.selgeo.com alla direttiva connect-src:

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

  3. Un ad blocker o un'estensione del browser blocca la richiesta. Testa in una finestra di navigazione anonima con le estensioni disabilitate.

  4. Chiave API non valida. Verifica la chiave in Impostazioni > Chiavi API nella dashboard.

I clic non appaiono​

Possibili cause:

  1. Modalità sbagliata. Se usi una chiave pk_test_*, i clic appaiono solo in modalità test.
  2. Nessun parametro di referral nell'URL. Lo snippet cerca ?ref=abc123 nell'URL.
  3. Limite di velocità superato. L'endpoint di tracciamento consente 1.000 richieste al minuto per chiave pubblica.
  4. Errore di rete. Controlla la scheda Rete degli Strumenti per sviluppatori per le richieste fallite a api.selgeo.com.

Conversioni non attribuite​

Possibili cause:

  1. click_id mancante o non valido. Il click_id collega una conversione al suo clic originale.
  2. Finestra di attribuzione scaduta. Controlla la finestra di attribuzione del tuo programma in Programmi > Impostazioni.
  3. Partner non approvato. Le conversioni vengono attribuite solo ai partner approvati.
  4. Conversione duplicata. Se invii lo stesso external_transaction_id due volte, la seconda richiesta viene rifiutata con 409 CONVERSION_DUPLICATE.
  5. Mismatch modalità. Un click_id generato con una chiave pk_test_* può essere abbinato solo a una conversione segnalata con una chiave sk_test_*.

click_id mancante​

Integrazione Stripe Checkout:

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

Integrazione API di conversione:

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": "IL_CLICK_ID",
    "event_type": "purchase",
    "external_transaction_id": "txn_123",
    "amount_cents": 4900,
    "currency": "EUR"
  }'

Ancora bloccato?​

  1. Controlla il Registro di audit dell'attribuzione nella dashboard.
  2. Verifica la tua integrazione prima in modalità test.
  3. Contatta il supporto con il tuo ID account commerciante e qualsiasi ID richiesta.