How AdServeKit Works
Conceptual Guide · 3–5 minThe essential 3–5 minute guide to core concepts, publisher and advertiser roles, and how ads flow from creation to delivery.
Step 1: Choose your path
No ad-tech background neededI'm a Publisher — Start here
You own a website, blog, or digital property. Connect your site, create advertising slots (placements), and serve ads or list on the marketplace.
I'm an Advertiser — Start here
You want to promote a product, service, or brand. Design your advertisements (creatives), configure targeting rules (campaigns), and discover verified publishers.
1. What is AdServeKit?
AdServeKit is a direct digital advertising and analytics platform designed for direct partnerships between website owners (Publishers) and brands or marketers (Advertisers).
Unlike traditional ad networks that insert opaque middle layers, arbitrary algorithms, and heavy revenue cuts, AdServeKit connects buyers and sellers directly. Publishers maintain full control over which ads run on their properties, and advertisers know exactly which websites and ad slots their ads appear on.
Every AdServeKit account operates within a Workspace. A single workspace can act as a publisher, an advertiser, or both — for example, monetizing your own websites while simultaneously running promotional campaigns across partner sites.
2. Publisher vs. Advertiser: Understanding your role
Digital advertising involves two primary roles. Understanding which role you are playing determines which tools and workflows you will use most often:
- The Publisher: You own or manage a digital property (such as a website, blog, or publication). Your goal is to monetize your audience by displaying advertisements in dedicated spaces on your pages, either for your own internal promotions (house ads) or for external sponsor deals.
- The Advertiser: You represent a brand, business, product, or agency. Your goal is to reach relevant audiences by designing ads and configuring campaigns that run across publisher websites.
In AdServeKit, publishers and advertisers collaborate directly: an advertiser sets up a campaign, a publisher designates an ad slot, and a secure relationship called a Campaign Connection links the two together.
3. The Five Core Objects
Everything in AdServeKit revolves around five core objects. They work together in a logical chain, but each has a distinct purpose and they are not interchangeable:
1. Website (Publisher side): A publisher-owned website registered and verified in AdServeKit. It represents the property where advertising inventory will be created and ads may eventually appear. Answers: 'Which site owns this advertising space?'
2. Placement (Publisher side): A specific advertising location or slot on a publisher's website (for example, a header banner, a sidebar rectangle, an in-article slot, or a footer banner). A placement defines supported dimensions (such as 300x250 or 728x90), lazy-loading rules, and empty-slot behavior. Answers: 'Where can the ad appear?'
3. Creative (Advertiser side): The actual visual or interactive advertisement visitors see (for example, an image ad, a video ad, an animated graphic created in the Advanced Studio, or a custom HTML5 bundle). Answers: 'What does the visitor see?'
4. Campaign (Advertiser side): The advertiser's operational delivery configuration and rulebook. A campaign connects one or more published creatives with flight dates, timezone-aware schedules, device and country targeting, frequency capping per visitor, and delivery budgets. Answers: 'When, where, and under what rules should this creative run?'
5. Campaign Connection (The Bridge): The authorized relationship that allows an advertiser's campaign to deliver through a publisher's approved placement. It acts as the secure bridge between the advertiser and publisher, allowing ads to serve without sharing private accounts or workspace credentials. Answers: 'Which publisher inventory is this advertiser campaign allowed to use?'
Website
A publisher-owned website registered and verified in AdServeKit.
It represents the root property where advertising inventory is organized and ads may eventually appear.
Examples: example.com, myblog.org, techreviews.co
Guide: Website →Placement
A specific advertising location or slot on a publisher's website.
Defines container dimensions (e.g. 300x250), lazy loading rules, and behavior when empty.
Examples: Header banner, Sidebar rectangle, In-article card, Sticky footer
Guide: Placement →Creative
The actual visual or interactive advertisement rendered for visitors.
Built with the Basic Creator, Advanced Studio, or uploaded as an HTML5 bundle. Each has specific pixel dimensions.
Examples: 300x250 image ad, 728x90 animated banner, video ad, HTML5 game
Guide: Creative →Campaign
The advertiser's operational delivery configuration and rulebook.
Connects one or more creatives with flight dates, budgets, device/country targeting, and frequency caps.
Examples: Spring 2026 Promo ($500 cap, US Mobile only, max 3 views/day)
Guide: Campaign →Campaign Connection
The authorized link between an advertiser's campaign and a publisher's placement.
Allows delivery through the publisher's ad slot without sharing private accounts or workspace credentials.
Examples: Connection Code (CMP-...) linking Alpine Footwear to Summit Trails Sidebar
Guide: Campaign Connection →Important concept: These objects work together, but they are not interchangeable. A Creative is the artwork; a Campaign is the schedule and budget; a Placement is the physical slot on the website; and a Campaign Connection is the authorized bridge between them.
These objects are related but distinct: A Creative is the artwork; a Campaign is the schedule and rules; a Placement is the physical slot on the web page; and a Campaign Connection is the bridge linking the campaign to the placement.
4. How ads reach visitors: The complete flow
Understanding how an ad moves from initial creation to a visitor's screen helps demystify the platform:
Publisher hierarchy: Website → Placement → Ad appears here.
Advertiser hierarchy: Creative → Campaign → Campaign Connection.
The connected delivery flow: Creative → Campaign → Campaign Connection → Publisher Placement → Website Visitor sees ad → Analytics → Billing.
Because each object is modular, changing one does not disrupt the others: an advertiser can edit an ad headline without recreating the campaign schedule, and a publisher can adjust page layout styling without modifying the advertiser's campaign.
Publisher Hierarchy
How ad spaces are structured on the publisher's side:
Publisher
Property owner
Website
Registered site
Placement
Ad slot
Advertiser Hierarchy
How ad delivery is structured on the advertiser's side:
Advertiser
Brand/buyer
Creative
Visual ad
Campaign
Rules & budget
The Complete End-to-End Delivery Flow
From advertiser ad creation to visitor view, measurement, and payment tracking.
1. Advertiser
Brand or business
2. Creative
Ad artwork & copy
3. Campaign
Targeting & budget
4. Connection
Authorized bridge
5. Placement
Slot on website
6. Website Visitor
Reads content & sees ad
7. Interaction
Impression or click
8. Analytics & Billing
Reporting & invoice
5. The Marketplace: The discovery and commercial layer
The AdServeKit Marketplace is the discovery and commercial layer of the platform. It provides an open, searchable directory where publishers list verified advertising spaces and advertisers find relevant audiences.
How it works: Publisher lists inventory → Advertiser discovers publisher → They message to agree on terms → Campaign Connection is created → Campaign delivers.
Clear boundary: The Marketplace itself is not the ad slot (placement) and not the campaign. It is the commercial discovery and negotiation space where relationships begin.
The Marketplace: Discovery Layer (Not the Ad Slot)
The Marketplace is where advertisers and publishers find each other and negotiate. It is not the ad slot itself, and not the campaign.
Publish Inventory
Publisher lists verified ad spaces with rates
Discover & Inquire
Advertiser evaluates authentic audience figures
Agree on Terms
Direct messaging to finalize pricing and flight dates
Connect & Deliver
Connection Code links campaign to placement
6. Billing: How commercial settlement works
AdServeKit includes an integrated invoicing and accounts-receivable ledger built specifically for digital advertising agreements.
The plain-English commercial flow: Advertiser and publisher agree on terms → Ads run on publisher placements → Delivery and impressions are measured → Invoice is issued → Payment status is tracked.
What AdServeKit does: Creates sequential, professional invoices, generates print-ready PDF and standard electronic UBL XML files, provides private online customer review links (/invoice/[token]), and tracks payment status (Draft, Issued, Paid, Void).
What AdServeKit does NOT do: AdServeKit is not a payment merchant or escrow service. Advertisers transfer funds directly to publishers via bank transfer, wire, or PayPal according to the instructions on the invoice. Once payment arrives, the publisher records it in their dashboard ledger to mark the invoice as Paid.
Billing: Complete Commercial Flow
Transparent settlement between publisher and advertiser without payment interception:
1. Agreement
Terms & pricing agreed
2. Delivery
Ads serve on placement
3. Measurement
Impressions recorded
4. Invoice Issued
PDF / UBL generated
5. Settled
Payment recorded
AdServeKit does: Generate sequential invoices, maintain accounts-receivable ledgers, produce print-ready PDF and standard electronic UBL XML files, and track settlement status.
AdServeKit does NOT: Process credit cards or escrow client funds. Advertisers pay publishers directly via bank transfer, wire, or PayPal, ensuring zero payment processor deductions from your ad revenue.
AdServeKit does not take a cut of your payments or hold funds in escrow. Advertisers pay publishers directly, ensuring you keep 100% of agreed sponsorship fees.
7. Analytics: Measuring results in plain English
AdServeKit provides clear, real-time analytics for both publishers and advertisers. Here are the core concepts explained simply:
- Impressions: The total number of times an ad was requested, successfully delivered, and rendered on a visitor's screen.
- Viewability: The percentage of rendered ads that were actually seen by visitors. AdServeKit uses the industry-standard threshold: at least 50% of the ad area must remain visible on screen for at least 1 continuous second.
- Clicks: The number of times visitors clicked an ad to visit the destination landing page.
- CTR (Click-Through Rate): The percentage of impressions that resulted in a click (Clicks ÷ Impressions × 100%).
- Conversions: Meaningful business outcomes completed on the advertiser's website after clicking an ad (such as account sign-ups, newsletter subscriptions, or purchases).
- Spend: The advertiser's accumulated advertising cost based on the campaign's agreed billing rate (e.g., CPM rate or flat fee).
- Revenue: The publisher's earnings generated from running the campaign.
- Delivery Progress: Real-time progress tracking of flight dates, daily spend caps, and overall budget pacing.
Advanced measurement concepts (such as attribution query parameters, transaction deduplication, and SDK internals) are documented in dedicated reference guides.
Impressions
Times an ad was requested, delivered, and rendered on the page.
Viewability
Percentage of rendered ads seen by visitors (50% area visible for 1s).
Clicks
Number of times visitors clicked the ad to visit the destination URL.
CTR
Click-Through Rate: Clicks divided by Impressions (e.g. 1.8%).
Conversions
Post-click actions on the advertiser site (signups, leads, purchases).
Spend
Advertiser's accumulated cost based on agreed billing model (e.g. CPM).
Revenue
Publisher's earnings from running the advertiser's campaign.
Delivery Progress
Flight date elapsed, daily budget spent, and total budget remaining.
8. A complete real-world example
To see how all these pieces fit together, consider this realistic example:
1. A hiking and outdoor review website (Summit Trails) registers their website in AdServeKit, verifies domain ownership, and creates a 300×250 placement named 'Gear Review Sidebar'.
2. An outdoor gear brand (Alpine Footwear) designs a 300×250 creative in the AdServeKit Studio featuring their new trail boot.
3. Alpine Footwear creates a campaign with flight dates for the spring season, sets a $500 budget cap at a $10 CPM rate, and attaches their published 300×250 creative.
4. Alpine Footwear discovers Summit Trails on the AdServeKit Marketplace. They agree via direct messages to run the campaign, and Alpine Footwear generates a Campaign Connection code.
5. Summit Trails accepts the connection code in their dashboard, assigning it to their 'Gear Review Sidebar' placement.
6. When a reader visits Summit Trails to read a trail guide, the publisher's page tag requests an ad. AdServeKit matches the active connection and serves the Alpine Footwear creative into the sidebar slot.
7. The visitor sees and clicks the ad. Both Summit Trails and Alpine Footwear immediately see the impression and click in their respective real-time analytics.
8. At the end of the month, Summit Trails generates an invoice in AdServeKit for the delivered impressions. Alpine Footwear pays Summit Trails directly via bank transfer, and Summit Trails marks the invoice as Paid.
A Complete Real-World Example: Summit Trails & Alpine Footwear
The Publisher: Summit Trails
Runs an outdoor hiking blog. Registers their website in AdServeKit, verifies domain ownership, and creates a 300×250 placement named “Gear Review Sidebar”.
The Advertiser: Alpine Footwear
Manufacturers trail boots. Builds a 300×250 creative with headline “Conquer Any Trail” and sets up a campaign with flight dates and a $500 budget cap.
- Agreement: Alpine Footwear discovers Summit Trails on the AdServeKit Marketplace. They message via Marketplace Messages and agree on a $10.00 CPM direct sponsorship.
- Connection: Alpine Footwear generates a Campaign Connection code. Summit Trails accepts the code in their dashboard and assigns it to their “Gear Review Sidebar” placement.
- Delivery: A visitor opens a boot review on Summit Trails. The publisher tag requests an ad, AdServeKit selects the connected campaign, and the 300×250 boot creative renders instantly.
- Measurement: The visitor views and clicks the ad. Impressions, viewability, and clicks immediately record in both Summit Trails' and Alpine Footwear's real-time analytics.
- Settlement: At the end of the campaign flight, Summit Trails issues an official invoice with PDF and private review link. Alpine Footwear transfers payment directly via bank transfer, and Summit Trails marks the invoice as Paid.
9. Where to go next
Now that you understand the platform concepts and how the objects connect, choose the setup guide for your role:
- If you are a Publisher wanting to connect your website and show ads: Read the Connect a website guide.
- If you are an Advertiser wanting to build campaigns and buy inventory: Read the Create a campaign guide or the Buying on the Marketplace guide.
Ready to begin? Choose your role
No ad-tech background neededI'm a Publisher — Start here
You own a website, blog, or digital property. Connect your site, create advertising slots (placements), and serve ads or list on the marketplace.
I'm an Advertiser — Start here
You want to promote a product, service, or brand. Design your advertisements (creatives), configure targeting rules (campaigns), and discover verified publishers.