Guide
First ad in 5 minutes
Quick answer
Start with a test secret key and Project ID, then create a placement from your backend.
Load render.js in the frontend and use the hosted renderer for the returned placement so it can handle media and beacons.
The shortest production-shaped path is key creation, POST /v1/placements, then render.js with wavebird.withTurn().
1. Create keys
Create a test secret key in the dashboard and copy the Project ID (`client_id`, `WAVEBIRD_CLIENT_ID`). Keep live keys out of local examples.
2. Create a placement
Send a POST /v1/placements?wait_ms=1500 request from your backend. The response is the canonical decision shape and includes placement.render when filled.
3. Render and beacon
Load /v1/render.js in the frontend and wrap the chat request with wavebird.withTurn(). The hosted renderer handles media, sizing, clicks, and beacons.
Need rollout review?
Start with the Server API. Use contact only when you need rollout review, enterprise coordination, or non-standard integration help.