adsroster.Docs
Sign inGet started

Integration

Wire AdsRoster into your site.

AdsRoster owns booking links, clicks, and impressions. You own layout and styling. There are two ways to integrate: an LLM prompt from your ad group, or a manual SDK setup.

Two ways to integrate

Use an LLM with a prompt from your ad group, or install and wire the SDK yourself.

In the workspace, open a website → Ad groups (or the site Integration page) and click Get integration. The modal’s LLM prompt tab gives you a prompt already filled with that group’s public key, group slug, and rendering rules.

  • Copy the prompt and paste it into Cursor, Codex, or another coding agent in your website repo.
  • The agent installs adsroster, sets NEXT_PUBLIC_ADSROSTER_PUBLIC_KEY in env, wraps with AdsRosterProvider (no baseUrl — production is the package default), and renders spots in your UI.
  • Prefer this over sample keys in these docs. Never commit tunnel / localhost hosts or hardcoded keys in a shared config file.

Prefer wiring it yourself? Switch to the tab.

Booking by default

Most publishers send sponsors to AdsRoster hosted checkout via spot.bookingUrl. For a form that lives on your domain, see Custom checkout.

Checkout only works after Bachs is connected for that environment. See Settings & payments.

NextSettings & paymentsConnect Bachs so bookings can create a real checkout.