Server API

1# Project ID (client_id, WAVEBIRD_CLIENT_ID): wbproj_your_project_id2WAVEBIRD_API_BASE_URL=https://api.wavebird.ai3WAVEBIRD_SECRET_KEY=sk_test_your_server_test_key4WAVEBIRD_CLIENT_ID=wbproj_your_project_id

1curl -X POST https://api.wavebird.ai/v1/placements?wait_ms=1500 \2  -H "Authorization: Bearer sk_test_wavebird_demo_secret" \3  -H "Content-Type: application/json" \4  -d '{5    "client_id": "wbproj_demo_8jK42",6    "session_id": "sess_demo_123",7    "job_type": "chat",8    "locale": "en",9    "slots_requested": 1,10    "slot_hint": {11      "position": "below",12      "max_width": 728,13      "max_height": 9014    },15    "consent": {16      "semantic_targeting": false,17      "prompt_shared": false,18      "gdpr_applies": false,19      "consent_source": "wavebird_consent"20    }21  }'

1export async function POST(request: Request) {2  const input = await request.json();3  const apiOrigin = (process.env.WAVEBIRD_API_BASE_URL || "https://api.wavebird.ai")4    .replace(/\/$/, "")5    .replace(/\/v1$/, "");67  const upstream = await fetch(apiOrigin + "/v1/placements?wait_ms=1500", {8    method: "POST",9    headers: {10      Authorization: "Bearer " + process.env.WAVEBIRD_SECRET_KEY,11      "Content-Type": "application/json"12    },13    body: JSON.stringify({14      client_id: process.env.WAVEBIRD_CLIENT_ID,15      session_id: String(input.session_id),16      job_type: "chat",17      slots_requested: 1,18      slot_hint: input.slot_hint,19      overrides: { allowed_formats: input.allowed_formats },20      consent: input.consent21    })22  });2324  const payload = await upstream.json();25  if (!upstream.ok) {26    return Response.json({ reason: "placement_rejected" }, { status: upstream.status });27  }2829  return Response.json({30    placement: payload.placement ?? null,31    decision: payload.decision ?? null,32    authoritative_consent: payload.authoritative_consent ?? null33  });34}

1<script src="https://api.wavebird.ai/v1/render.js"></script>2<section id="wavebird-slot" hidden aria-label="Sponsored content"></section>34<script type="module">5  let cleanupPlacement;67  function classifyWavebirdPlacementResponse(payload) {8    if (!payload || typeof payload !== "object") return "invalid_response";9    if (payload.placement && payload.decision?.fill === true) return "filled";10    if (!payload.placement && payload.decision?.fill === false) return "no_fill";11    if (!payload.placement && (payload.decision == null || payload.status === "pending")) return "not_ready";12    return "invalid_response";13  }1415  async function requestAndRenderSponsor() {16    cleanupPlacement?.();17    const slot = document.querySelector("#wavebird-slot");18    const response = await fetch("/api/sponsor-slot", {19      method: "POST",20      headers: { "Content-Type": "application/json" },21      body: JSON.stringify({22        session_id: crypto.randomUUID(),23        allowed_formats: ["banner", "native"],24        slot_hint: { position: "below", max_width: 728, max_height: 250 },25        consent: {26          semantic_targeting: false,27          prompt_shared: false,28          gdpr_applies: true,29          consent_source: "wavebird_consent"30        }31      })32    });33    const payload = await response.json();3435    if (!response.ok) return { status: "request_rejected" };36    const placementState = classifyWavebirdPlacementResponse(payload);37    if (placementState !== "filled") {38      slot.replaceChildren();39      slot.hidden = true;40      return { status: placementState };41    }4243    slot.hidden = false;44    slot.addEventListener("ad:render_failed", () => {45      slot.dataset.renderState = "frame_error";46    }, { once: true });47    cleanupPlacement = await window.wavebird.renderPlacement({48      target: slot,49      placement: payload.placement,50      decision: payload.decision,51      authoritative_consent: payload.authoritative_consent52    });53    if (typeof cleanupPlacement !== "function") {54      slot.hidden = true;55      return { status: "render_failed" };56    }57    return { status: "rendered", cleanup: cleanupPlacement };58  }59</script>

1{2  "overrides": {3    "allowed_formats": ["banner", "clip", "native"],4    "native_template_id": "card",5    "timing": "during",6    "bidfloor": 0.5,7    "bidfloor_currency": "EUR",8    "publisher": {9      "app_name": "MyAIChatApp",10      "app_domain": "mychatapp.com",11      "categories": ["IAB19"]12    },13    "blocked_categories": ["IAB7"]14  }15}

1const occurred_at = new Date().toISOString();23await fetch("https://api.wavebird.ai/v1/beacons", {4  method: "POST",5  headers: {6    Authorization: "Bearer " + process.env.WAVEBIRD_SECRET_KEY,7    "Content-Type": "application/json"8  },9  body: JSON.stringify({10    beacon_id: "bcn_example_rendered_001",11    slot_id: "slot_...",12    asset_token: "wbat_...",13    event: "rendered",14    occurred_at,15    metadata: {}16  })17});