API Reference
UGC
POST /ugc/impression

POST /ugc/impression

Report that an ad became visible to the user. Fire this when the ad element is at least 50% visible for 1 second (MRC viewability standard).

Request

POST https://api.adzen.ai/ugc/impression

Body

{
  post_id: string    // The post_id from the process response
  ad_id: string      // The ad_id from the matched ad
}

Example

curl -X POST https://api.adzen.ai/ugc/impression \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"post_id": "thread-12345", "ad_id": "ad-abc123"}'

Response

200 OK

{
  "post_id": "thread-12345",
  "acknowledged": true
}

Impressions are billing-grade — the counter is never reset. This drives both CTR-based ad ranking and billing for CPM campaigns.