Push: JSON feed example
Hosts are placeholders. Request parameters and response fields are described in the JSON feed specification.
Request
text
https://feed.example.com/bid?id=9b2f4c1e7a3d4e5f8a6b0c1d2e3f4a5b&format=push&ip=203.0.113.10&ua=Mozilla%2F5.0%20%28Linux%3B%20Android%2013%3B%20Pixel%207%29%20AppleWebKit%2F537.36%20%28KHTML%2C%20like%20Gecko%29%20Chrome%2F124.0.0.0%20Mobile%20Safari%2F537.36&lang=de-DE%2Cde%3Bq%3D0.9%2Cen%3Bq%3D0.8&placement_tag_id=123&context_id=site-42&domain=publisher.example&subid=source-7&user_id=u-abc123&sub_days=1&bcat=IAB25%2CIAB26&cnt=1&req_id=00000000-0000-4000-8000-000000000001Response
json
[
{
"id": "3f1c2a9e-5b7d-4c11-9e0a-2b6f8d4a7c10",
"impid": "1",
"crid": "4",
"click_url": "https://notify.example.com/c?id=3f1c2a9e-5b7d-4c11-9e0a-2b6f8d4a7c10&t=k3J9xQ2pLm&trace_id=a1b2c3d4",
"campaign_id": 1001,
"category": "IAB3",
"title": "Spring sale in Berlin",
"text": "Up to 50% off on all models until Sunday",
"image_url": "https://ads.example.com/images/spring-sale.jpg",
"icon_url": "https://ads.example.com/icons/store.png",
"nurl": "https://notify.example.com/wn?id=3f1c2a9e-5b7d-4c11-9e0a-2b6f8d4a7c10&t=Vw7rT1nB0s",
"burl": "https://notify.example.com/bn?id=3f1c2a9e-5b7d-4c11-9e0a-2b6f8d4a7c10&t=Vw7rT1nB0s",
"cpc": 0.035
}
]An integration with CPC: cpc is the click price, the city in title is already filled in, and the impression is counted by nurl or burl.
Response with impression counted on image load
json
[
{
"id": "3f1c2a9e-5b7d-4c11-9e0a-2b6f8d4a7c10",
"impid": "1",
"crid": "4",
"click_url": "https://notify.example.com/c?id=3f1c2a9e-5b7d-4c11-9e0a-2b6f8d4a7c10&t=k3J9xQ2pLm&trace_id=a1b2c3d4",
"campaign_id": 1001,
"category": "IAB3",
"title": "Spring sale in Berlin",
"text": "Up to 50% off on all models until Sunday",
"image_url": "https://notify.example.com/imp?id=3f1c2a9e-5b7d-4c11-9e0a-2b6f8d4a7c10&t=Hq5mZ8cE4y",
"icon_url": "https://ads.example.com/icons/store.png",
"nurl": "https://notify.example.com/wn?id=3f1c2a9e-5b7d-4c11-9e0a-2b6f8d4a7c10&t=Vw7rT1nB0s",
"burl": "https://notify.example.com/bn?id=3f1c2a9e-5b7d-4c11-9e0a-2b6f8d4a7c10&t=Vw7rT1nB0s",
"cpc": 0.035
}
]Only image_url differs: it is the impression counting URL; load it from the user's device at the moment of the impression, not in advance from your server.
No ad
text
HTTP/1.1 204 No ContentIt can come for any request; there is no body, and a 200 response with [] means the same.