Skip to content

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-000000000001

Response ​

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 Content

It can come for any request; there is no body, and a 200 response with [] means the same.

© Youtarget