Saltar al contenido
DOTWICK

Envío desde el servidor

POST/v1/conversions

Cuándo usarlo

Usa el envío desde el servidor para un pedido que tu servidor confirma más tarde: un webhook de pago, un pedido por teléfono, una fase del CRM. Tu página guarda el dw_sid de la dirección de llegada, en tu propia sesión o en la cookie _dw_sid que instala el píxel, y lo entrega al crear el pedido. Requiere un plan con seguimiento de conversiones.

Autentícate con el secreto de envío del sitio (Authorization: Bearer dwps_…, que se muestra una sola vez al crearlo o rotarlo) o con una clave de API con el permiso conversions:write.

Cuerpo de la petición

clickIdstringobligatorioEl valor dw_sid de la dirección de llegada, tal como llegó.
eventstringobligatorioEl nombre del evento: uno de purchase, lead, signup, o un objetivo que hayas creado. Minúsculas, dígitos y guiones bajos.
valuenumberopcionalEl importe, como número. Un reembolso es un importe negativo.
currencystringopcionalUn código ISO 4217 como USD. Obligatorio cuando hay un valor. Los importes nunca se convierten de una moneda a otra.
orderIdstringopcionalTu número de pedido, de hasta 64 caracteres. Enviar el mismo otra vez se ignora.
occurredAtstringopcionalCuándo ocurrió, como hora ISO 8601. Ahora, si falta. Debe caer dentro de la ventana de atribución.
metadataobjectopcionalHasta 10 valores de texto cortos. Una clave o un valor que parezca un dato personal se rechaza.

Envíalo

ejemploPOST /v1/conversions
curl -X POST https://api.dotwick.com/v1/conversions \  -H "Authorization: Bearer dwps_YOUR_POSTBACK_SECRET" \  -H "Content-Type: application/json" \  -d '{    "clickId": "v1.k3m9x2q7c4v1b6n8.a1b2c3d4e5f6.ffk.Hk2LmN0pQ4r",    "event": "purchase",    "value": 49.5,    "currency": "USD",    "orderId": "ORD-1001"  }'

Respuesta

La llamada responde antes de que la conversión se atribuya. El resto ocurre en segundo plano: un identificador de clic de otro espacio de trabajo se rechaza, uno fuera de la ventana se guarda como no atribuido y se ignora un orderId repetido.

202 Accepted
{  "status": "queued"}

Errores

400validation_failedUn identificador de clic mal formado, un valor sin moneda, un campo desconocido o metadatos con datos personales.
401unauthorizedEl secreto de envío o la clave de API no se reconoce.
403feature_not_in_planEl plan del espacio de trabajo no incluye el seguimiento de conversiones.
429rate_limitedDemasiadas peticiones; espera el tiempo de Retry-After.

Sin datos personales

  • El cuerpo es estricto: un campo que no figura arriba, como un correo o un teléfono, hace fallar toda la petición.
  • Las claves de metadatos como email, phone, name y address se rechazan, y también un valor que parezca un correo o un teléfono.