Vai al contenuto
DOTWICK

Postback dal server

POST/v1/conversions

Quando usarlo

Usa un postback per un ordine che il tuo server conferma più tardi: un webhook di pagamento, un ordine telefonico, una fase del CRM. La tua pagina conserva il dw_sid dall’indirizzo di atterraggio, nella tua sessione o nel cookie _dw_sid impostato dal pixel, e lo passa quando crea l’ordine. Richiede un piano con il tracciamento delle conversioni.

Autenticati con il segreto di postback del sito (Authorization: Bearer dwps_…, mostrato una volta quando lo crei o lo ruoti) oppure con una chiave API con l’ambito conversions:write.

Corpo della richiesta

clickIdstringobbligatorioIl valore dw_sid dell’indirizzo di atterraggio, esattamente come è arrivato.
eventstringobbligatorioIl nome dell’evento: uno tra purchase, lead, signup, o un obiettivo che hai creato. Lettere minuscole, cifre e trattini bassi.
valuenumberfacoltativoL’importo, come numero. Un rimborso è un importo negativo.
currencystringfacoltativoUn codice ISO 4217 come USD. Obbligatorio quando c’è un valore. Gli importi non vengono mai convertiti tra valute.
orderIdstringfacoltativoIl tuo numero d’ordine, fino a 64 caratteri. Inviare di nuovo lo stesso viene ignorato.
occurredAtstringfacoltativoQuando è successo, come orario ISO 8601. Se assente, adesso. Deve rientrare nella finestra di attribuzione.
metadataobjectfacoltativoFino a 10 brevi valori di testo. Una chiave o un valore che somiglia a un dato personale viene rifiutato.

Invialo

esempioPOST /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"  }'

Risposta

La chiamata risponde prima che la conversione sia attribuita. Il resto avviene in background: un ID clic che appartiene a un altro spazio di lavoro viene rifiutato, uno fuori dalla finestra viene conservato come non attribuito e una ripetizione dello stesso orderId viene ignorata.

202 Accepted
{  "status": "queued"}

Errori

400validation_failedUn ID clic malformato, un valore senza valuta, un campo sconosciuto o metadati con dati personali.
401unauthorizedIl segreto di postback o la chiave API è sconosciuto.
403feature_not_in_planIl piano dello spazio di lavoro non include il tracciamento delle conversioni.
429rate_limitedTroppe richieste; attendi Retry-After.

Nessun dato personale

  • Il corpo è rigoroso: un campo non elencato sopra, tra cui un indirizzo e-mail o un numero di telefono, fa fallire l’intera richiesta.
  • Le chiavi dei metadati come email, phone, name e address vengono rifiutate, così come un valore che somiglia a un indirizzo e-mail o a un numero di telefono.