Guide

First ad in 5 minutes

Use this checklist to confirm that your first test placement works.

1. Prepare the test project

Create a Server Test Key and copy the Project ID (client_id, WAVEBIRD_CLIENT_ID). Keep live keys out of local examples.

Follow the Quickstart →

2. Confirm the response

Send POST /v1/placements?wait_ms=1500 from your backend. For a fill, check that the response includes placement.render. A no-fill response is a valid outcome, not proof that installation failed.

3. Confirm the visible result

Load /v1/render.js and pass the filled response to wavebird.renderPlacement(). Check that the ad fits its slot and that the hosted renderer records the expected media and beacon events.

Run the full testing checklist →Diagnose a failed step →

Need help with your integration?

Share the affected endpoint, request ID, and the behavior you expected. Leave out keys and user content.

Contact the team