DocsPublishers

Publisher Documentation

Everything you need to know about earning with PopLayer as a publisher.

Blockchain Payments

Instant, transparent, and secure payments powered by blockchain technology.

Why Blockchain?

Traditional ad networks often have payment delays, high fees, and opaque reporting. PopLayer uses blockchain to solve these problems.

Traditional Ad Networks

✗ Net-30 to Net-90 payment terms
✗ High minimum payout thresholds
✗ Wire transfer fees ($25-50)
✗ Black-box revenue calculations

PopLayer Blockchain

✓ On-demand payouts when deals end (<1 min)
✓ No minimum payout threshold
✓ Minimal gas fees (~$0.01)
✓ Every transaction on-chain verifiable

Transparency by Design

Every impression, click, and payment is recorded on the blockchain. You can independently verify your earnings against on-chain data at any time.

How Blockchain Payments Work

Simple 4-step process from impression to payout:

Traffic Served

Your placement serves an impression or click. Event is logged with timestamp and metadata.

Revenue Calculated

CPM/CPC rates are applied based on the agreed deal rate.

Settlement Batch

Earnings are aggregated into settlement batches. Smart contract prepares the payout transaction.

Payout Executed

USDT is sent directly to your wallet. Transaction hash provided for verification.

Smart Contract Settlement

Payments are executed by an audited smart contract, not manual processes. This eliminates human error and ensures consistent, predictable payouts.

Supported Tokens & Networks

Token	Network	Avg. Gas Fee	Confirmation
USDT	Polygon	~$0.01	~2 seconds
USDT	BNB Chain	~$0.05	~3 seconds
USDT	Ethereum	~$2-10	~15 seconds

Why USDT?

USDT (Tether) is a stablecoin pegged 1:1 to USD. This protects your earnings from crypto volatility — $100 earned today will still be worth $100 when you withdraw.

Settlement Cycle

<1 min

On-demand withdrawals

Minimum payout

Platform withdrawal fee

Two Settlement Types

Instant Settlement (<1 min)

Triggered automatically when:

• Campaign is completed
• Publisher exits a deal
• Buyer disconnects your placement

Periodic Settlement (7 days)

For ongoing campaigns:

• Automatic weekly payouts
• All accumulated earnings
• No action required from you

No Waiting for Payouts

Unlike traditional ad networks with Net-30 or Net-60 terms, PopLayer settles automatically when deals end. For active campaigns, you receive automatic weekly payouts — no minimum threshold, no withdrawal requests needed.

Wallet Setup

You need a compatible wallet to receive payments.

Compatible Wallets

MetaMask

Trust Wallet

Coinbase Wallet

Any EVM wallet

Setup Steps

Install a compatible wallet (MetaMask recommended)

Copy your wallet address (starts with 0x...)

Paste it in PopLayer Settings → Payout Wallet

Select your preferred network (Polygon recommended)

Important

Always double-check your wallet address before saving. Blockchain transactions are irreversible — funds sent to the wrong address cannot be recovered.

Blockchain FAQ

Do I need to understand crypto to use PopLayer?

No. You just need a wallet address. PopLayer handles all the blockchain complexity — you simply receive USDT payments.

Can I convert USDT to regular money?

Yes. You can withdraw USDT to any crypto exchange (Binance, Coinbase, Kraken) and convert to USD, EUR, or your local currency.

What if gas fees spike?

PopLayer covers gas fees for settlements. You receive the full amount you earned, minus only the network's minimal transaction cost.

Is my wallet address private?

Your wallet address is visible on-chain (like all blockchain transactions), but it's not linked to your personal identity unless you choose to connect it publicly.

What happens if I lose access to my wallet?

We cannot recover funds sent to a wallet. Always backup your wallet's seed phrase securely. You can update your payout address at any time before settlement.

Referral Program

Invite publishers and earn commission from their earnings.

How the Referral Program Works

Simple 3-step process to start earning referral commission:

Get Your Code

Your unique 6-character referral code is automatically generated when you register as a publisher.

Share with Publishers

Invite other website owners to join PopLayer using your referral code during their registration.

Earn Commission

When your referrals earn money, you automatically receive a percentage of their earnings as commission.

Key Benefits

Lifetime earnings — You earn commission for as long as your referrals are active
Passive income — No extra work required after sharing your code
On-demand payouts — Commission is included in your regular blockchain settlements
Unlimited referrals — No cap on how many publishers you can invite

Commission Rates

5%of your referral's earnings, paid automatically

Example Calculation

Referral's monthly earnings	$1,000
Your commission rate	5%
Your referral earnings	$50

Commission is calculated in basis points (1 basis point = 0.01%). A rate of 500 basis points equals 5%. The commission is calculated from your referral's net earnings (after platform fees) and is paid directly to your wallet during regular settlement cycles.

What Counts Towards Commission

• Impression revenue
• Click revenue
• Conversion bonuses

Sharing Your Referral Code

Your Referral Link Format

https://app.poplayer.io/register?ref=YOUR_CODE

Replace YOUR_CODE with your actual 6-character referral code.

Where to Share

Forums	Webmaster forums, affiliate marketing communities, publisher groups
Direct Outreach	Website owners who might benefit from PopLayer monetization
Social Media	Twitter, LinkedIn, Telegram groups

Tips for Success

• Share your actual earnings results to build trust
• Explain the blockchain payment benefits (fast, transparent)
• Help new referrals get started with integration

Tracking Your Referral Earnings

Referral Dashboard

• Total referred publishers
• Active referrals (earning)
• Total commission earned
• This month's earnings

Earnings Chart

• Daily, weekly, monthly views
• Earnings by referral breakdown
• Growth trends and projections

Payout Rules

Settlement Schedule

• Calculated during each settlement cycle
• Paid with your regular earnings
• Direct to your blockchain wallet

Requirements

• Referral must use your code at registration
• Referral must have an active wallet
• Referral must generate actual earnings

No Minimum Threshold

Even small amounts are included in your regular settlements.

Referral FAQ

Can I refer media buyers too?

Currently, the referral program is only available for publishers. You can only earn commission from referred publishers.

How long do I earn commission from a referral?

You earn commission for as long as your referral remains active on the platform. There's no time limit — it's a lifetime commission.

What if my referral becomes inactive?

You won't receive commission during inactive periods. When they become active again, commission resumes.

Can referrals change their referrer?

No, the referral relationship is permanent. Once a publisher registers with your code, you'll always be their referrer.

Is there a limit to referrals?

No. You can refer as many publishers as you want and earn commission from all of them.

SDK Integration

Step-by-step guide to integrate PopLayer SDK on your website.

Overview

To start earning with PopLayer, you need to:

Add a Traffic Source

Create a Placement

Define where and how ads will be shown

Integrate the SDK

Add the script to your website

Configure TrafficBack

Monetize unfilled traffic (optional but recommended)

Automatic Optimization

The PopLayer SDK handles ad serving, frequency capping, and mobile optimization automatically.

Basic Integration

Add this script to your website's <head> section:

<script src="https://cdn.poplayer.io/sdk/poplayer.js"
        data-source-id="YOUR_SOURCE_ID"
        data-placement-id="YOUR_PLACEMENT_ID"
        data-debug="false"></script>

Replace YOUR_SOURCE_ID and YOUR_PLACEMENT_ID with values from your dashboard.

Advanced Integration

For more control, use programmatic initialization:

<script src="https://cdn.poplayer.io/sdk/poplayer.js"></script>
<script>
PopLayer.init({
    sourceId: 'YOUR_SOURCE_ID',
    placementId: 'YOUR_PLACEMENT_ID',
    debug: false,
    frequency: {
        enabled: true,
        maxPerSession: 3,
        maxPerDay: 10
    },
    popup: {
        enabled: true,
        width: 800,
        height: 600
    },
    delay: {
        initial: 0,      // Ads shown on user clicks
        between: 60000   // 1 minute between ads
    },
    // Optional: Target specific elements
    clickSelectors: ['a', 'button', '.clickable'],
    // Optional: Exclude elements
    excludeSelectors: ['.no-ads', 'a[href^="mailto:"]']
});
</script>

Mobile Optimization

The SDK automatically detects mobile devices and applies optimal settings:

PopLayer.init({
    sourceId: 'YOUR_SOURCE_ID',
    placementId: 'YOUR_PLACEMENT_ID',
    // Desktop settings
    frequency: {
        maxPerSession: 3,
        maxPerDay: 10
    },
    // Mobile-specific overrides
    mobileSettings: {
        enabled: true,
        useRedirect: true,   // New tabs instead of popups
        maxPerSession: 1,
        maxPerDay: 3
    }
});

Configuration Parameters

Parameter	Default	Description
sourceId	required	Your traffic source ID
placementId	optional	Specific placement ID
frequency.maxPerSession	3	Max ads per browser session
frequency.maxPerDay	10	Max ads per day
popup.width / height	800x600	Popup window size (desktop)
delay.between	60000	Minimum interval between ads (ms)
clickSelectors	[]	CSS selectors that trigger ads
mobileSettings.useRedirect	true	Use new tabs on mobile

API Methods

Method	Description
PopLayer.init(options)	Initialize SDK with settings
PopLayer.pause()	Pause ad serving
PopLayer.resume()	Resume ad serving
PopLayer.getStats()	Get current session statistics
PopLayer.forceShow()	Force ad on next eligible click
PopLayer.excludeSelector(sel)	Exclude element from ad triggers

Direct Link Integration

For placements with "Direct Link" ad format, use the provided URL directly:

https://api.poplayer.io/ads/direct/YOUR_PLACEMENT_ID/

Use this link in:

Email campaigns

Social media

Affiliate promotions

Any traffic source

TrafficBack

Monetize 100% of your traffic — even when no PopLayer campaigns are available.

What is TrafficBack?

TrafficBack (also called Fallback) lets you monetize traffic that can't be served by PopLayer campaigns. When no matching advertiser is found, your fallback kicks in instead of showing nothing.

Scenario	Without TrafficBack	With TrafficBack
No matching campaigns	Nothing happens	Fallback URL runs
Budget exhausted	Lost opportunity	Fallback monetizes
Frequency cap reached	User sees nothing	Another network serves

When TrafficBack Triggers

TrafficBack activates when PopLayer can't serve an ad:

No matching campaigns

No active campaigns for this geo/device/OS

Budget exhausted

All matching campaigns spent their daily budget

Frequency cap reached

User already saw maximum allowed ads

Blocked by antifraud

Traffic flagged by buyer's antifraud settings

Rate below floor

Campaign rate lower than your floor CPM

Targeting mismatch

User doesn't match campaign criteria

Fallback Types

URL Redirect

Simple redirect to another ad network's smart link or any URL:

# Ad network smart link
https://adnetwork.com/smartlink?pubid=YOUR_ID

# Your own offer
https://yoursite.com/special-offer

# Affiliate link
https://affiliate.com/offer?ref=YOUR_REF

Compatible with: PropellerAds, Adsterra, TrafficStars, ExoClick, and any URL.

JavaScript Script

Execute custom JavaScript — perfect for ad networks requiring script tags:

// PropellerAds example
(function(d,z,s){
  s.src='https://'+d+'/400/'+z;
  try{
    (document.body||document.documentElement).appendChild(s)
  }catch(e){}
})(
  'propellerads.com',
  'YOUR_ZONE_ID',
  document.createElement('script')
);

Configuration Levels

Global: Applies to all placements (default fallback). Per-Placement: Overrides global for specific placements. Per-placement settings take priority.

Revenue Impact

Without TrafficBack, you could be losing 20-40% of potential revenue.

Example Calculation

Total daily clicks	10,000
PopLayer fill rate	70%
Unfilled clicks	3,000
Fallback CPM	$0.50
Additional monthly revenue	+$45.00

• Use reputable ad networks as fallback
• Test fallback before going live
• Use smart links that auto-optimize by geo
• Monitor fallback performance

Don't

• Use broken or expired URLs
• Use malicious landing pages
• Forget to update credentials
• Leave TrafficBack empty!

TrafficBack FAQ

Does TrafficBack affect my PopLayer earnings?

No. TrafficBack only activates when PopLayer cannot serve an ad. Your PopLayer revenue is unaffected.

Can I use multiple ad networks as fallback?

The built-in TrafficBack supports one fallback. For advanced setups, use JavaScript to create a waterfall.

How do I know how much traffic goes to fallback?

Check your PopLayer statistics for 'fill rate'. If fill rate is 70%, then 30% goes to fallback.

Is there any delay when TrafficBack triggers?

The fallback triggers almost instantly (milliseconds) when PopLayer determines no ad can be served.

Does TrafficBack work on mobile?

Yes, TrafficBack works on all devices. Ensure your fallback URL/script is mobile-compatible.

Settlement & Payout System

Understanding when and how you get paid for delivered traffic.

Overview

PopLayer uses a blockchain-based settlement system that ensures transparent, trustless payments. All payments are made in cryptocurrency (USDT, USDC, or MATIC) directly to your wallet.

Core Principle

You are paid for all traffic that passes antifraud verification, regardless of why the campaign ends. If a buyer stops a campaign, removes your placement, or the budget runs out — you still get paid for all legitimate traffic delivered.

Guaranteed Payment

Buyers cannot refuse to pay for traffic that passed antifraud checks.

Blockchain Escrow

Buyer funds are locked in smart contract before campaign starts.

No Minimum

Even small amounts are settled and transferred to your wallet.

Settlement Triggers

You receive payments in several scenarios:

Trigger	Description	Type
Weekly Settlement	Regular 7-day payment cycle for ongoing campaigns	Automatic
Campaign Completion	Buyer ends campaign or budget exhausted	Final
Your Withdrawal	You remove your placement/bundle from campaign	Exit
Buyer Removes You	Buyer removes your placement from their campaign	Removal
Campaign Expiration	Campaign reaches its end date	Final

Key Point

In all scenarios, you receive payment for all clean traffic delivered up to that moment. There is no way for a buyer to withhold payment for legitimate traffic.

Weekly Settlements

For long-running campaigns, you receive payments automatically every 7 days.

How It Works

Traffic Delivery (Day 1-7)

Your impressions and clicks are recorded continuously

Cycle Close (Day 7)

Settlement cycle ends, statistics are compiled

Antifraud Verification

Only clean traffic is counted for payment

Payment Release

Smart contract transfers funds to your wallet

What's Included in Your Payout

You Get Paid For

✓ All impressions that passed antifraud
✓ All verified clicks
✓ Referral commissions (if any)

Not Included

✗ Traffic blocked by antifraud
✗ Fraudulent clicks/impressions

Payout Calculation

Your Payout = (Valid Impressions × CPM / 1000) - Platform Fee

Campaign Scenarios

What happens to your earnings in different situations:

Scenario: Buyer Stops Campaign Early

If a buyer decides to stop their campaign before the budget is spent, you still receive payment for all traffic you delivered.

→

Final settlement triggered automatically

→

All your clean traffic since last settlement is counted

→

Payment released within 24-48 hours

Scenario: You Withdraw Your Placement

If you decide to remove your placement from a campaign (for better opportunity, targeting mismatch, etc.), you get paid for all traffic delivered before withdrawal.

→

Exit settlement calculated immediately

→

Grace period traffic included (if configured)

→

You're free to join other campaigns

Scenario: Buyer Removes Your Placement

If a buyer decides to remove your placement from their campaign (ROI optimization, budget reallocation), you're protected:

✓

Full payment for all clean traffic delivered

✓

All verified clicks paid

→

Payment processed within 24-48 hours

→

You receive notification about removal

Timeline & Statuses

How long settlements take and what each status means.

Processing Timeline

Event	Processing Time
Weekly settlement	Within 24 hours of cycle end
Campaign completion	24-48 hours
Your withdrawal	24-48 hours after exit
Buyer removes you	24-48 hours
Smart contract execution	Minutes (after processing)

Settlement Statuses

Pending

Awaiting processing

Processing

Being calculated

Completed

Funds sent!

Failed

Being retried

Manual

Admin review

Notifications You'll Receive

✉️ Settlement processed — funds sent to wallet
✉️ Settlement failed — action may be required
✉️ Removed from campaign — exit settlement pending

Settlement FAQ

What if a campaign stops with my traffic unsettled?

All unsettled traffic is included in the final settlement. You receive payment for all clean traffic regardless of why the campaign ended.

Can a buyer refuse to pay me?

No. The blockchain escrow system ensures you're paid for all traffic that passes antifraud verification. Buyers cannot withhold payment for legitimate traffic — the smart contract enforces this.

How quickly do I receive payment after settlement?

Once the smart contract executes, funds are transferred directly to your wallet within minutes. The main processing time is in the verification and calculation phase (24-48 hours).

What happens if settlement fails?

Failed settlements are retried automatically. If issues persist, they're flagged for manual review by platform admins. You'll be notified of any delays.

Can I see why some traffic was blocked?

Yes. Your antifraud dashboard shows blocked traffic with specific reasons. This helps you identify and fix issues with your traffic sources.

Are my referral commissions included?

Yes! If you referred other publishers, your referral commission is calculated and included in your regular settlement payouts.

What if I disagree with the antifraud results?

You can review blocked traffic in your dashboard. If you believe traffic was incorrectly blocked, contact support with specific details for review.

Is there a minimum payout amount?

No minimum threshold. Even small amounts are settled and transferred to your wallet via blockchain.