Popunder.AI — Documentation

Back to home

1. Overview

Popunder.AI is a media management platform for pop-under, popup and auto-redirect advertising. It allows agencies, brands and affiliates to configure ad campaigns, generate a lightweight embed script for publisher sites, and track clicks, impressions and conversions in real time through server-to-server (S2S) postbacks and conversion pixels.

The system is organised around three core entities: Traffic Sources (zones/projects), Campaigns(creative + targeting configuration), and Zones(publisher inventory where campaigns are delivered, with weighted rotation support).

2. Module Architecture

  • Authentication — sign in, sign up, password recovery and reset. Session-based access control for all internal modules.
  • Dashboard — global overview of traffic sources, campaign performance, signups, FTDs and cost metrics, with date-range filtering.
  • Traffic Sources (admin) — registration of traffic projects, monthly cost tracking, workspace scope (public/private), automatic Zone ID generation.
  • Campaigns — creation and configuration of ad campaigns: format type, target URL with dynamic tokens, popup or auto-redirect settings, status control.
  • Ad Zones — publisher-facing delivery units that can rotate between multiple campaigns using weighted distribution.
  • Pixels — conversion tracking pixels for signup and first deposit (FTD) events, with test tools to validate firing.
  • Domains (admin) — registration of publisher domains linked to campaigns, used to resolve the base URL embedded in delivery scripts.
  • Tracking & Postback (admin) — S2S postback URL generation compatible with third-party trackers (Voluum, Binom, RedTrack), with configurable tokens.
  • Users (admin) — user account management and role/permission assignment.
  • Monitoring — Health Score reporting, URL status checks, and pre-flight checks that validate a campaign end to end before it goes live.
  • API Test — internal tooling to validate API connectivity and campaign queries.

3. Flow & Steps

  1. Sign in to the platform with your account credentials.
  2. Create a Traffic Source — register a project name, workspace scope and monthly cost. A unique Zone ID is generated automatically.
  3. Create a Campaign — choose a campaign type (popup with banner, auto-redirect without banner, multiple banners, banner rotation, etc.), set the target URL with tracking tokens, and configure visual/behavioural options.
  4. Install the embed script — copy the generated loader script from the campaign and add it to the publisher site. The script is served through a dedicated API endpoint and protected with Subresource Integrity (SRI).
  5. Configure tracking — set up S2S postback URLs and/or conversion pixels (signup, FTD) so conversions reported by the advertiser or tracker are recorded against the correct click/visitor.
  6. Monitor performance — use the Dashboard, Health Score report, Check Status and Pre-flight Checks to validate delivery, availability and conversion tracking over time.

4. Actions & Features

ModuleAvailable actions
Traffic SourcesCreate/edit/delete sources; auto-generate Zone ID; set monthly cost and currency; scope as public or private.
CampaignsCreate/edit/pause/archive campaigns; select campaign type (popup, auto-redirect, banner rotation); configure target URL with dynamic tokens; customise popup design (image, colours, delay, trigger); set CTA mask coordinates.
Ad ZonesCreate/edit/pause zones; link zones to a domain; attach multiple campaigns with weighted rotation; view per-zone performance.
PixelsRetrieve signup and FTD pixel URLs per campaign; fire test events to validate integration; copy ready-to-use pixel snippets.
DomainsRegister/edit/delete publisher domains; associate a domain with campaigns for base URL resolution.
Tracking & PostbackGenerate global or per-source S2S postback URLs; configure visitor ID and payout tokens; view conversion metrics (clicks, conversions, conversion rate).
UsersCreate/edit/delete user accounts; assign roles and permissions (admin-only).
MonitoringView Health Score reports and impression trends; check target URL availability/status; run pre-flight checks that validate a campaign end to end before launch.
DashboardView global metrics across all traffic sources and campaigns; filter by date range; navigate directly to any module.