Mesure et API Conversions

Votre tableau de bord

Ouvrez Vos annonces dans l’application et choisissez une campagne. Les résultats s’ouvrent après votre premier paiement, par jour ou par heure :

Téléchargez n’importe quel rapport en CSV. Les rapports n’affichent que des totaux, jamais qui a vu votre annonce, et masquent tout groupe de moins de cinq personnes.

Visites

Une visite est comptée quand un téléphone qui a vu votre annonce, ou touché Y aller, arrive à votre bâtiment dans la fenêtre de votre campagne : 7 jours sauf si vous la changez, de 1 à 28. Une visite par téléphone et par jour.

Codes d’offre

Ajoutez une offre à votre campagne et les personnes qui voient votre annonce peuvent toucher Obtenir l’offre pour recevoir un code comme NW-4F2K. Quand un client le montre à votre comptoir, saisissez-le dans Confirmer un client de votre tableau de bord, comme une visite ou une vente avec son montant, et il est compté.

Liens En savoir plus

Une touche sur En savoir plus passe par N-Way, qui la compte, puis ouvre votre site web avec ces paramètres ajoutés à l’adresse :

https://shop.example.ng/menu?nwclid=nw.K7Q2M4XJ3F5RB2LTQWE6HNPAZD3YU&utm_campaign=1042&utm_medium=billboard&utm_source=nways

API Conversions

Votre serveur indique à N-Way quand un clic a mené à une vente, un prospect ou un autre résultat. Le lien se fait uniquement avec un identifiant de clic ou un code d’offre, jamais avec une personne.

Clés d’API

Dans l’application, ouvrez Vos annonces, puis Développeurs, donnez un nom à la clé et créez-la. La clé complète, qui commence par nwk_, n’est affichée qu’une fois : copiez-la à ce moment-là sur votre serveur. La liste montre les premiers caractères de chaque clé et sa dernière utilisation. Vous pouvez y révoquer une clé à tout moment ; les requêtes qui l’utilisent cessent aussitôt de fonctionner.

Envoyer une conversion

curl https://nways.ng/v1/ads/conversions \
  -H "Authorization: Bearer $NWAYS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"nwclid":"nw.K7Q2M4XJ3F5RB2LTQWE6HNPAZD3YU","event":"purchase","value":2500,"currency":"NGN",
       "occurred_at":"2026-10-12T14:05:00+01:00","dedupe_id":"order-1042"}'

// Node 18 ou plus récent
const res = await fetch('https://nways.ng/v1/ads/conversions', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.NWAYS_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    nwclid: order.nwclid, // conservé depuis l'adresse de la page d'arrivée
    event: 'purchase',
    value: 120, // dans la monnaie de la campagne : ici des cédis
    currency: 'GHS',
    occurred_at: new Date().toISOString(),
    dedupe_id: `order-${order.id}`,
  }),
})
if (!res.ok) throw new Error((await res.json()).error)

import os
import requests

res = requests.post(
    "https://nways.ng/v1/ads/conversions",
    headers={"Authorization": f"Bearer {os.environ['NWAYS_API_KEY']}"},
    json={
        "offer_code": "NW-4F2K",  # ou "nwclid"
        "event": "visit",
        "dedupe_id": "till-3-2026-10-12-0931",
    },
    timeout=10,
)
res.raise_for_status()

Champs

Une conversion compte si elle a eu lieu dans la fenêtre de votre campagne après le clic (7 jours sauf si vous l’avez changée, 28 au plus), et pas dans le futur.

Réponses

{"status": "recorded"}