Skip to content
Bright Face AdsBright Face Ads
Documentation

Everything you need to integrate.

Guides and references to take you from first request to production.

Search the docs…⌘K
Popular:QuickstartAuthenticationBid request schemaWebhooksRate limits
20+
Guides
6
SDK platforms
2.6
OpenRTB version
Quickstart

Your first ad in five minutes.

Install the SDK, grab an API key, and request your first ad. The engine handles the auction, you handle the render.

Open the quickstart
  1. 1

    Install the SDK

    Add the client for your platform.

  2. 2

    Get an API key

    Create a key in your dashboard.

  3. 3

    Request an ad

    Call requestAd and render the winner.

Browse the guides

Reference and how-tos, organised by what you're trying to do.

Getting started

Create an account, get an API key and make your first request.

Read guide

SDK reference

Full reference for each platform client and its options.

Read guide

OpenRTB integration

Bid request and response schemas, fields and examples.

Read guide

Ad formats

Supported video and image formats, sizes and specs.

Read guide

Auctions & floors

How auctions resolve, and how to set price floors.

Read guide

Webhooks & reporting

Receive events and pull performance data.

Read guide
Watch & learn

Video tutorials.

Short, focused walkthroughs from install to production.

Tutorial · placeholder
Video placeholder
4:12

Quickstart walkthrough

Tutorial · placeholder
Video placeholder
8:30

OpenRTB deep dive

Tutorial · placeholder
Video placeholder
5:45

Webhooks & reporting

Recipes

Copy-paste your way to launch.

The snippets you'll reach for most.

Request an ad
const ad = await bfa.requestAd({
  slot: "home-feed",
});
Set a price floor
bfa.slot("home-feed", {
  floorCpm: 4.5,
});
Handle a no-bid
if (!ad) {
  showFallback(); // 204
}

Let's put your brand on the brightest screens.

Launch a campaign in days, not weeks.

Talk to our team