Impressions and clicks
Impressions and clicks
Record an impression when the ad is visible, then send users through click_url so clicks are tracked before they reach the advertiser.
Wire up clicks
No signing Every filled decision includes creative.click_url. Use it as the link href, button action, or WebView URL. Do not sign this request and do not swap in the advertiser landing URL directly. Serve records the click and redirects the user.
https://serve.meridianads.tech/v1/click/{token}Record impressions
Call recordImpression in your SDK, or POST /v1/events with {"token": "<impression_token>", "event": "impression"} after the creative is on screen. Fire the impression on render, not when you request the ad.
Clicks only count when a valid impression was recorded first. Sending the same impression token twice is safe; the second call is ignored.
Token expiry
| Token | Valid for | Use it for |
|---|---|---|
| Impression | 1 hour | Recording that the ad was shown |
| Click | 24 hours | Redirecting the user after they tap or click |
Landing URL macros
After a valid click, serve expands these placeholders on the advertiser destination before redirecting:
{click_id}{campaign_id}{placement_id}
{user_key} is never expanded. Do not add user_key to landing URLs yourself.