SovAds Protocol
Drop the SDK on a site to earn for every verified impression. Run on-chain ad campaigns on Celo with built-in CTA tasks, viewer rewards in G$, and a settlement contract you can read yourself.
Pick the path that matches what you're building. Each one is a self-contained track — start there and follow the in-page links.
For Publishers
Earn G$ for every verified impression. Drop the SDK on your site.
For Advertisers
Fund campaigns on Celo, attach CTA tasks, settle in G$.
Quick install
Copy-paste the 5-line snippet.
Quick install
Register a site at /publisher to get your siteId, then drop this in:
pnpm add sovads-sdknpm install sovads-sdkyarn add sovads-sdkimport { SovAds, Banner } from 'sovads-sdk'
const ads = new SovAds({ siteId: 'site_YOUR_SITE_ID' })
const banner = new Banner(ads, 'ad-container')
await banner.render()<div id="ad-container"></div>
<script type="module">
import { SovAds, Banner } from 'https://ads.sovseas.xyz/_sovads_sdk/index.js'
const ads = new SovAds({ siteId: 'site_YOUR_SITE_ID' })
await new Banner(ads, 'ad-container').render()
</script>Want the raw markdown?
Every doc page has a Copy as Markdown button at the top — perfect for pasting into Cursor, Claude, or ChatGPT. There's also a full /llms.txt summary of the protocol.
For Publishers
You run a site or app and want to earn G$ when verified humans see ads.
1. Install the SDK
npm, pnpm, or CDN
2. Pick a surface
Banner, Popup, Sidebar, BottomBar
3. Configure
siteId, fingerprint, rotation, frequency caps
4. Track interactions
Impressions, clicks, viewer points
5. Get paid
Publisher settlement, viewer redeem flow
For Advertisers
You want to run campaigns on Celo, optionally with CTA tasks (visit, sign, poll, survey, on-chain).
1. Campaign serving
How creatives are selected and delivered
2. CTA task overview
8 task kinds across attached and standalone surfaces
3. Verifier types
How task completions are proven
4. Rewards & limits
Economics, caps, per-viewer budgets
5. On-chain settlement
SovAdsStreaming on Celo + G$
6. Webhooks
Postback, pixel, replay, signing
Core concepts
| Term | Meaning |
|---|---|
siteId | Publisher identifier of the form site_<publisherId>. Auto-detected from domain when omitted. |
fingerprint | Anonymous device identifier. Stored in localStorage as sovads_fingerprint_v1. |
trackingToken | Server-issued opaque token returned with each ad. Authenticates impression / click events for that ad. |
SovPoint | Reward unit. 1 SovPoint redeems for 1 G$ on Celo. Earned by viewers, paid by advertisers. |
G$ | GoodDollar SuperToken on Celo. The settlement currency for the entire protocol. |
| CTA task | An optional action attached to (or standalone alongside) a campaign — visit, sign, poll, survey, on-chain call. |