Conversiones e ingresos

El seguimiento de conversiones cierra el círculo entre un clic y el dinero que ha producido. El redirector emite un identificador firmado en cada redirección; tu servidor o tu página de agradecimiento lo devuelve junto con un pedido; y cada desglose que ya lees gana una columna de ingresos.

Las conversiones son una función de pago. Cuando el plan no las incluye, el redirector deja de emitir identificadores por completo, y las dos vías de entrada rechazan las conversiones con una restricción de plan.

El identificador de clic

En cada redirección el worker emite un token y:

• lo añade a la dirección de destino bajo un nombre de parámetro que eliges tú (lp_cid por defecto);
• lo escribe en una cookie propia de tu dominio de redirección, válida durante 90 días.

La cookie es lo que hace que la atribución sobreviva en navegadores que ya no aceptan nada de terceros: la fija tu propio dominio, no el nuestro.

El token está firmado y ligado al arrendatario: los identificadores del espacio de trabajo y del partner forman parte de la carga firmada, así que un token emitido en el enlace de un cliente se rechaza en el espacio de trabajo de otro exactamente igual que una falsificación. No lleva ningún dato personal: el momento del clic, el enlace, la variante del reparto, el país, la clase de dispositivo, el origen del tráfico y una marca de tráfico sospechoso.

Tanto el nombre del parámetro como el interruptor de encendido y apagado viven en Conversiones → Ajustes. Cambiar cualquiera de los dos reescribe de inmediato la configuración cacheada de todos los enlaces.

La ventana de atribución

Una conversión que llega más tarde que la ventana se rechaza con attribution_expired, un código distinto de invalid_click_id, para que una integración pueda distinguir «demasiado tarde» de «identificador roto» sin adivinar. La ventana es un ajuste por espacio de trabajo.

Objetivos

Un objetivo es un resultado con nombre: purchase, signup, trial. Los objetivos pueden llevar un valor por defecto y una moneda, que se usan cuando una conversión llega sin importe. Un objetivo referenciado por una conversión y que todavía no existe se crea en su primer uso, así que una integración no hay que configurarla en dos sitios.

Enviar conversiones

Desde tu servidor

curl -X POST https://api.linkprofit.com/v1/conversions \
  -H "Authorization: Bearer lp_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-10241" \
  -d '{
    "click_id": "1.eyJ1aWQiOiJ...",
    "goal": "purchase",
    "order_id": "10241",
    "amount_cents": 4999,
    "currency": "usd"
  }'

La clave necesita el alcance conversions:write. Los importes son unidades mínimas enteras: céntimos, peniques, kopeks. Un importe de 49.99 se rechaza indicando el campo, en lugar de redondearse en silencio, porque una regla de redondeo inventada en mitad de una vía de pago es la forma en que los informes de ingresos dejan de cuadrar con las facturas sin que nadie se entere.

Desde el navegador

El worker sirve un pequeño script desde tu propio dominio de redirección:

<script src="https://go.example.com/cv.js" defer></script>
<script>
  window.lpConversion({ goal: 'purchase', orderId: '10241', amountCents: 4999, currency: 'usd' });
</script>

El script lee el identificador de la URL o de la cookie propia. En toda la cadena no hay ningún host de terceros, lo que es a la vez una propiedad de privacidad y una propiedad de marca blanca: la página de tu cliente no carga nada que mencione la plataforma.

Duplicados

La deduplicación es una única inserción atómica, no una lectura seguida de una escritura. Las entregas repetidas del mismo order_id crean una sola conversión y la devuelven marcada como duplicada, que es justo lo que hace que reintentar un webhook fallido sea seguro en lugar de peligroso.

Conversiones sospechosas

El veredicto del clasificador viaja dentro del token, así que una conversión atribuida a un centro de datos o a un proxy se marca como sospechosa cuando se registra. Aparece en los informes como un segmento propio en lugar de borrarse o mezclarse en silencio con el resto. «Doscientas conversiones» y «doscientas conversiones, cuarenta de ellas desde un mismo rango de hosting en una hora» son hechos distintos.

A dónde van luego las conversiones

• Se emite un evento de webhook conversion.created firmado a través de la maquinaria habitual de webhooks: cola, firma, calendario de reintentos, cron de recuperación.
• Las integraciones publicitarias configuradas reciben la conversión a través de una cola de entrega con un contador de intentos que se incrementa antes de la llamada saliente, un backoff documentado y una marca de abandono en lugar de reintentos infinitos.

Cupo mensual

Un plan puede topar el número de conversiones aceptadas por mes natural, contadas en UTC. Pasado el tope, la entrada responde quota_exceeded, un código distinto de una restricción de plan, para que la diferencia entre «no está en tu plan» y «lo has agotado este mes» se vea sin abrir un ticket de soporte.