Aller au contenu
DOTWICK

Envoi depuis le serveur

POST/v1/conversions

Quand l’utiliser

Utilisez l’envoi depuis le serveur pour une commande que votre serveur confirme plus tard : un webhook de paiement, une commande par téléphone, une étape du CRM. Votre page garde le dw_sid de l’adresse d’arrivée, dans votre propre session ou dans le cookie _dw_sid que dépose le pixel, et le transmet à la création de la commande. Il faut une offre avec le suivi des conversions.

Authentifiez-vous avec le secret d’envoi du site (Authorization: Bearer dwps_…, affiché une seule fois à la création ou à la rotation) ou avec une clé d’API ayant le scope conversions:write.

Corps de la requête

clickIdstringobligatoireLa valeur dw_sid de l’adresse d’arrivée, telle qu’elle est arrivée.
eventstringobligatoireLe nom de l’événement : l’un de purchase, lead, signup, ou un objectif que vous avez créé. Minuscules, chiffres et tirets bas.
valuenumberfacultatifLe montant, sous forme de nombre. Un remboursement est un montant négatif.
currencystringfacultatifUn code ISO 4217 comme USD. Obligatoire quand il y a une valeur. Les montants ne sont jamais convertis d’une devise à l’autre.
orderIdstringfacultatifVotre numéro de commande, jusqu’à 64 caractères. Envoyer le même une seconde fois est ignoré.
occurredAtstringfacultatifQuand cela s’est produit, en heure ISO 8601. Maintenant si absent. Doit tomber dans la fenêtre d’attribution.
metadataobjectfacultatifJusqu’à 10 valeurs de texte courtes. Une clé ou une valeur qui ressemble à une donnée personnelle est refusée.

Envoyez-le

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

Réponse

L’appel répond avant que la conversion soit attribuée. Le reste se passe en arrière-plan : un identifiant de clic d’un autre espace de travail est refusé, un autre hors de la fenêtre est conservé comme non attribué, et la répétition d’un même orderId est ignorée.

202 Accepted
{  "status": "queued"}

Erreurs

400validation_failedUn identifiant de clic mal formé, une valeur sans devise, un champ inconnu ou des métadonnées contenant des données personnelles.
401unauthorizedLe secret d’envoi ou la clé d’API est inconnu.
403feature_not_in_planL’offre de l’espace de travail n’inclut pas le suivi des conversions.
429rate_limitedTrop de requêtes ; attendez le délai de Retry-After.

Aucune donnée personnelle

  • Le corps est strict : un champ qui ne figure pas ci-dessus, par exemple une adresse e-mail ou un numéro de téléphone, fait échouer toute la requête.
  • Les clés de métadonnées comme email, phone, name et address sont refusées, de même qu’une valeur qui ressemble à une adresse e-mail ou à un numéro de téléphone.