Documentation

Pops.gg is a premium advertising marketplace that connects advertisers with high-quality publishers. Our platform specializes in popunder ad formats while providing robust tools for campaign management, targeting, and performance analysis.

Pops.gg is operated by CASH.BH LTD, a private limited company registered in England & Wales (Company No. 14298863). The platform is strictly business-to-business: every advertiser and every publisher must be a registered business entity with valid documentation.

This documentation will guide you through setting up your account, creating campaigns as an advertiser, monetizing your traffic as a publisher, and making the most of our platform's features.

Registration

To get started with Pops.gg, you'll need to create an account. You can register as either an advertiser, a publisher, or both.

1. Visit the Pops.gg sign-up page
2. Choose your account type (Advertiser, Publisher, or Both)
3. Fill in your personal and company information
4. Verify your email address
5. Complete your profile setup

Account Verification

To ensure the quality and security of our platform, all accounts need to go through a verification process. This typically includes:

• Email verification
• Phone verification
• ID verification (for larger accounts)
• Website verification (for publishers)

After logging in, you'll be greeted with your personalized dashboard, which provides an overview of your account performance and quick access to all platform features.

Key Dashboard Elements

For more detailed information about specific features, please refer to the corresponding sections in this documentation.

Advertising on Pops.gg is open to registered business entities only. All advertisers provide valid business registration documents and pass due diligence before a campaign can run.

The Four Steps

1. Create your account — sign up and verify your business details.
2. Set up the campaign — choose your targeting options and upload your creative assets.
3. Fund the account — the minimum initial deposit is $500, so there is enough budget to test and optimize properly.
4. Launch and optimize — go live, then adjust based on real-time performance data.

Funding and Fees

• There are no setup fees for advertisers; the platform fee is included in the pricing structure.
• All transactions are conducted in USD or GBP.
• Unused funds are refundable within 14 business days, subject to fraud checks and compliance verification.

Campaigns can be narrowed down along the following dimensions:

Each option is described in more detail on the Targeting Options page, and can be read and configured programmatically through the /targeting API endpoint.

Pops.gg runs on real-time bidding with transparent reporting: you pay for the traffic you receive, at the rates agreed for your account. There are no setup fees on either side of the marketplace.

Controls Available

• Real-time bid adjustments and campaign scaling
• Custom frequency capping and dayparting
• A/B testing for creative optimization
• Automated rules that act on performance data

Campaign performance is reported in the dashboard and is also available through the API. The metrics tracked per campaign are:

• Impressions — inventory delivered against the campaign
• Clicks — click events recorded on delivered inventory
• Spend vs. budget — how much of the allocated budget has been consumed
• Campaign status — active, paused or completed

The same figures are returned by the /reports endpoint of the API, so they can be pulled into your own BI stack. See the API Reference for the request and response format.

Publishers are integrated through a feed URL, not a pasted script. After approval you are issued one feed per traffic type in your publisher panel, and you call that feed from your own ad server or rotator.

Feed Request Format

http://xml.pops.gg/search?format=json&feed=YOUR_FEED_ID&auth=YOUR_AUTH
  &subid={subid}&query={query}&user_ip={user_ip}&ua={ua}&url={url}&count={count}

• feed — the numeric feed ID issued to you for that traffic type
• auth — the auth token issued with your feed
• {user_ip}, {ua}, {url} — must carry the real end-user values; substituting your own server's IP or user agent will fail traffic quality checks
• {subid} — your own sub-identifier, echoed back in reporting
• {count} — number of results requested

Pops.gg specializes in popunder advertising. Feeds are issued per format and per traffic category, and the format you receive is set on the feed itself, not in your page code.

Feed Quality Tiers

• Normal — IP-match filtering only
• High Coverage — IP match with an IP frequency limit
• HQ — all filters applied, with an IP frequency limit

Publisher earnings are reported in your panel and settled against the platform's own delivery figures.

Once you are live, the levers that actually move publisher revenue on this platform are traffic quality and feed fit — not placement cosmetics.

• Monitor initial traffic and earnings in your dashboard before scaling volume.
• Review performance per feed and per sub-ID, and shift volume toward the feeds that convert.
• Pass accurate end-user IP, user agent and referring URL — filtered traffic earns nothing and lowers your quality score.
• Keep traffic sources legitimate: bot or incentivized traffic is detected and removed from payable volume.
• Ask your account manager which additional feed types your traffic qualifies for.

How traffic is scored and filtered is described on the Anti-Fraud Technology page.

The REST API, in summary:

• Base URL: https://api.pops.gg/v1/
• Authentication: Authorization: Bearer YOUR_API_KEY
• Format: JSON, with standard HTTP status codes

Endpoints

• /campaigns — create, read and update campaigns
• /reports — performance data
• /publishers — publisher records
• /targeting — read and configure targeting

API keys are issued per account from your dashboard. Treat a key as a credential: it carries the same authority as a login.

There is no official Pops.gg SDK. The API is plain REST over HTTPS with a bearer token, so any standard HTTP client in your language works without a wrapper.

curl -X GET "https://api.pops.gg/v1/campaigns" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

If an official client library is ever published it will be announced on the blog and listed here. Until then, treat any third-party package claiming to be an official Pops.gg SDK as untrusted.

Webhooks let your systems receive notifications about events in your Pops.gg account instead of polling the API. The following events are available:

• campaign.createdA new campaign is created
• campaign.updatedA campaign is updated
• payment.receivedA payment is processed
• report.generatedA report is ready for download

Webhook endpoints are configured per account. See the API Reference for setup, and always verify that a delivery came from us before acting on it.