Measurement and Conversions API

Your dashboard

Open Your ads in the app and choose a campaign. Results open after your first payment, by day or by hour:

Download any report as CSV. Reports show totals only, never who saw your ad, and hide any group smaller than five people.

Visits

A visit is counted when a phone that saw your ad, or tapped Route there, arrives at your building within your campaign’s window: 7 days unless you change it, from 1 to 28. One visit per phone per day.

Offer codes

Add an offer to your campaign and people who see your ad can tap Get offer for a code like NW-4F2K. When a customer shows it at your counter, type it into Confirm a customer in your dashboard, as a visit or a sale with its amount, and it counts.

Learn more links

A Learn more tap goes through N-Way, which counts it, then opens your website with these added to the address:

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

Conversions API

Your server tells N-Way when a click led to a sale, a lead or another result. It links to a click ID or an offer code only, never to a person.

API keys

In the app, open Your ads, then Developers, give the key a name and create it. The whole key, starting nwk_, is shown once: copy it to your server then. The list shows each key’s first characters and when it was last used. Revoke a key there at any time; requests with it stop working at once.

Send a 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_naira":2500,
       "occurred_at":"2026-10-12T14:05:00+01:00","dedupe_id":"order-1042"}'

// Node 18 or later
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, // saved from the landing page address
    event: 'purchase',
    value_naira: 2500,
    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",  # or "nwclid"
        "event": "visit",
        "dedupe_id": "till-3-2026-10-12-0931",
    },
    timeout=10,
)
res.raise_for_status()

Fields

A conversion counts if it happened within your campaign’s window after the click (7 days unless you changed it, up to 28), and not in the future.

Responses

{"status": "recorded"}