Guide
Server-side integration
Keep credentials and placement requests on your backend. Use this guide to check what your server owns.
Validate the request
Keep the secret key in server-side configuration. Use the project paired with that key, a stable anonymous session ID, and only documented placement fields. Validate browser-supplied values before forwarding them.
Return only the response needed for rendering
The frontend needs the placement response, not your server credentials. Pass a filled placement to the hosted renderer; handle no-fill and API errors without interrupting the AI task.
Use the hosted measurement path
The hosted renderer records rendered, visibility, click, and playback events for the default flow. Direct server beacons are a separate path for custom rendering or QA.
Need help with your integration?
Share the affected endpoint, request ID, and the behavior you expected. Leave out keys and user content.