Guide
Server-side integration
Quick answer
Use the server-side pattern when your backend owns request context and can keep its secret key private.
Return the canonical placement response to the frontend and let the hosted renderer display the frame and emit default browser beacons.
Use this pattern when your backend owns request context and the hosted renderer owns browser media behavior.
Create placements server-side
Your backend calls /v1/placements with a secret key. Never expose that key to browsers.
Render safely
Return the canonical decision response to the frontend and let render.js use placement.render.frame_url inside a hosted iframe.
Record beacons
The hosted renderer records rendered, visible, clicked, and playback events idempotently for the default flow.
Need rollout review?
Start with the Server API. Use contact only when you need rollout review, enterprise coordination, or non-standard integration help.