Getting Started

Overview

You can integrate Adrop Web SDK via CDN script without build tools. Suitable for static websites or simple HTML pages.

Supported Ad Formats

Banner Ads
Native Ads (with custom UI support)

Requirements

Modern browsers (Chrome, Firefox, Safari, Edge)

Installation

Add the script to the <head> section of your HTML document.

<script src="https://cdn.jsdelivr.net/npm/@adrop/ads-web-sdk@latest/dist/adrop-ads.min.js"></script>

To lock to a specific version, specify the version number instead of @latest. Example: @adrop/ads-web-sdk@1.0.1

Initialization

Initialize the SDK after the script loads.

<script>
  const adrop = Adrop.observe({
    appId: 'YOUR_APP_ID',
    debug: true  // true only in development
  });
</script>

Initialization Options (AdropConfig)

string

required

App ID issued from Ad Control Console

string

User identifier (used for targeting)

string

API authentication key (required for updating user properties)

boolean

default:false

Enable debug logging

'responsive' | 'fixed'

default:"responsive"

Publisher-wide backfill rendering mode. Per-slot overrides take precedence. See the Backfill Rendering Mode guide for details. (SDK 1.2.3+)

Set debug: false in production environments.

Instance Access

After initialization, you can access the SDK from anywhere using Adrop.instance().

const adrop = Adrop.instance();
// Use SDK

Dynamic Configuration Updates

You can change settings at runtime, such as setting a user ID after login.

// Using setters
Adrop.instance().uid = 'USER_ID';
Adrop.instance().appKey = 'YOUR_APP_KEY';

// Or using setConfig
Adrop.instance().setConfig({
  uid: 'USER_ID',
  appKey: 'YOUR_APP_KEY'
});

For targeted ads to work properly, set uid before rendering the ad placement.

WebView Setup (For Backfill Ads)

If you serve this site inside your app’s in-app WebView, we recommend also adopting the Adrop SDK for the wrapping platform (Android · iOS · Flutter · React Native) and calling Adrop.registerWebView(). Google states that this registration makes app signals available to ad tags inside the WebView, helping to improve monetization. Additionally, default WebView settings are not optimized for ads — follow each platform guide’s WebView configuration (JavaScript, DOM storage, third-party cookies, media autoplay). No extra setup is needed for browser (mobile or desktop) traffic.

SDK Guide

AI

Android

iOS

React Native

Flutter

Web

REST API

Overview

Supported Ad Formats

Requirements

Installation

Initialization

Initialization Options (AdropConfig)

Instance Access

Dynamic Configuration Updates

WebView Setup (For Backfill Ads)

Android Setup

iOS Setup

Flutter Setup

React Native Setup

Table of Contents

Banner Ads

Native Ads

Targeting

Reference

Examples

​Overview

​Supported Ad Formats

​Requirements

​Installation

​Initialization

​Initialization Options (AdropConfig)

​Instance Access

​Dynamic Configuration Updates

​WebView Setup (For Backfill Ads)

Android Setup

iOS Setup

Flutter Setup

React Native Setup

​Table of Contents

Banner Ads

Native Ads

Targeting

Reference

Examples

Overview

Supported Ad Formats

Requirements

Installation

Initialization

Initialization Options (AdropConfig)

Instance Access

Dynamic Configuration Updates

WebView Setup (For Backfill Ads)

Table of Contents