Documentation

Verifying a site

A site is verified by one of three methods: a DNS TXT record, a meta tag on the home page, or a file uploaded to the site's root. They are the same three methods Google Search Console uses, so most site owners have done one of them before. Verification is what lets a site be crawled; the crawl reports which of the site's words are currently sellable.

Adding the embed

The embed is one script element, added once so that it appears on every page that should carry bubbles. Most platforms document a single place for that. On WordPress it is the theme's header template part or a site-wide custom HTML block; on Squarespace, Ghost, and Webflow it is the site-level code injection field in settings, not the per-page one. A WordPress plugin is planned, and until it exists those two documented places are what the platform offers.

The script loads after the page's DOM is ready and has no dependencies. It sends beacons with the browser's own beacon API, which does not delay a page as it unloads.

Choosing the scope

The scope is the part of a page the embed may scan, given as a selector such as the article element, the entry-content container, or any element carrying data-adbubbles-scope. The scope is the single most consequential setting, because it decides which words on a site are sellable at all.

Inside the scope the embed already skips headings, links, code, preformatted text, form controls, navigation, header, and footer. Anything else that should never carry a bubble can be marked data-noads, and the embed will leave it and everything inside it alone.

The per-page cap and the category exclusions

The maximum bubbles per page is the density control. Whatever it is set to, the embed underlines only the first occurrence of each bought word, opens at most one bubble per word, and never puts two in the same paragraph.

Category exclusions are chosen per account, on top of the categories AdBubbles prohibits everywhere: gambling, adult, weapons, cryptocurrency, supplements, and political. An excluded category's creatives never reach the site.

Checking that it is working

The dashboard shows "waiting for first page view" until the first view beacon arrives, then "live". Per site per day it reports page views that carried bubbles, opens, clicks, and earnings accrued, with a problems panel for a site that has gone quiet or lost its verification.