Enviar una conversión
Cuando ocurre una venta o un registro, tu servidor la envía con la visita; después puede cambiar su estado, por ejemplo un reembolso.
La llamada
POST https://<your workspace address>/track/conversions
x-api-key: your API key
Content-Type: application/json
{
"hit": "h1.…",
"conversionTypeCode": "sale",
"externalId": "order-1042",
"amount": { "value": 49.90 },
"currency": "EUR"
}
| Campo | |
|---|---|
hit |
La visita firmada de la cookie hitctrl (o de una visita desde el servidor). |
conversionTypeCode |
Obligatorio. El código del tipo de conversión, por ejemplo sale. |
externalId |
Tu ID de pedido o de transacción. El mismo cuenta una vez, así que repetir es seguro. |
amount.value, currency |
El importe de la venta; necesario para pagos en porcentaje. Otra moneda se convierte al tipo del día. |
exchangeRate |
Tu propio tipo hacia la moneda del espacio de trabajo, si tu espacio de trabajo lo acepta. |
couponCodes |
Los códigos de cupón usados; el socio de un cupón se lleva la venta por delante de la visita. |
externalClientId |
Un cliente que registraste; la venta cuenta para el socio de la visita de ese cliente. |
country |
El país del comprador (dos letras); valora la venta por él en vez de por el país de la visita. |
customParams.advS1–advS5 |
Tus propios valores; los grupos de pago y las reglas de fraude pueden usarlos. |
status |
approved, pending o test; omítelo para lo que fije el objetivo de la oferta. |
Uno de hit, couponCodes o externalClientId es obligatorio. La llamada también funciona como GET con los mismos valores en la dirección.
Cambiar un estado después
POST https://<your workspace address>/track/conversions/status
{ "externalId": "order-1042", "status": "refunded" }
status es approved, pending, rejected o refunded. Añade conversionTypeCode cuando un pedido tiene conversiones de varios tipos.
Momentos de mucha carga
Envía la cabecera Prefer: respond-async: la respuesta es 202 al momento y la conversión se registra un instante después.
¿Respondió esto a tu pregunta?
Comprobado con la aplicación el 18 de octubre de 2026