Solución de problemas

Problemas de integración comunes y cómo resolverlos. Todos los ejemplos hacen referencia a API versión v1.

El snippet no se carga

Síntoma: El snippet de seguimiento de Selgeo no parece ejecutarse.

Posibles causas:

1. La etiqueta script falta o está malformada. Verifique que el snippet esté presente en el HTML de su página:

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

2. La Content Security Policy (CSP) bloquea el script. Agregue https://cdn.selgeo.com a la directiva script-src y https://api.selgeo.com a la directiva connect-src:

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

3. Un bloqueador de anuncios o extensión de navegador bloquea la solicitud. Pruebe en una ventana de incógnito con las extensiones desactivadas.

4. Clave API inválida. Verifique la clave en Configuración > Claves API en el panel de control.

Los clics no aparecen

Posibles causas:

1. Modo incorrecto. Si usa una clave pk_test_*, los clics solo aparecen en modo de prueba.
2. No hay parámetro de referido en la URL. El snippet busca ?ref=abc123 en la URL.
3. Límite de tasa superado. El punto de conexión de seguimiento permite 1.000 solicitudes por minuto por clave pública.
4. Error de red. Verifique la pestaña Red de las DevTools en busca de solicitudes fallidas a api.selgeo.com.

Conversiones no atribuidas

Posibles causas:

1. click_id faltante o inválido. El click_id vincula una conversión a su clic de origen.
2. Ventana de atribución expirada. Verifique la ventana de atribución de su programa en Programas > Configuración.
3. Socio no aprobado. Las conversiones solo se atribuyen a socios aprobados.
4. Conversión duplicada. Si envía el mismo external_transaction_id dos veces, la segunda solicitud se rechaza con 409 CONVERSION_DUPLICATE.
5. Incompatibilidad de modo. Un click_id generado con una clave pk_test_* solo puede ser asociado por una conversión reportada con una clave sk_test_*.

click_id faltante

Integración Stripe Checkout:

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

Integración API de conversión:

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

¿Todavía atascado?

1. Verifique el Registro de auditoría de atribución en el panel de control.
2. Verifique su integración primero en modo de prueba.
3. Contacte al soporte con su ID de cuenta de comerciante y cualquier ID de solicitud.