DocsAdvertisers

Advertiser Documentation

Professional tools to automate, schedule, and protect your advertising campaigns.

Blockchain Billing

Transparent, efficient, and secure campaign funding powered by blockchain.

Why Blockchain for Advertisers?

Blockchain technology brings transparency and efficiency to advertising payments that traditional systems can't match.

Traditional Ad Platforms

✗ Credit card fees (2-4%)
✗ Opaque auction mechanics
✗ Delayed spend reconciliation
✗ Hard to audit traffic quality

PopTrade Blockchain

✓ Near-zero transaction fees
✓ Every transaction verifiable on-chain
✓ Real-time balance updates
✓ Immutable traffic logs for auditing

Trustless Verification

Don't trust — verify. Every impression you pay for is logged on-chain with full metadata. You can independently audit your campaign performance against blockchain records.

How Blockchain Billing Works

Prepaid balance system with real-time deductions:

Deposit USDT

Send USDT to your PopTrade wallet address. Funds are credited instantly upon blockchain confirmation.

Access Traffic

Your campaigns receive traffic from placements you have access to. Each impression is recorded on-chain.

Real-time Deduction

Your balance is updated in real-time as impressions are served. No surprises at the end of the month.

Settlement

Funds are distributed to publishers via smart contract. Transaction hashes available for verification.

Smart Contract Escrow

Your deposits are held in an audited smart contract, not a company bank account. Funds can only be released according to the contract's rules — either to publishers for verified traffic, or back to you as a refund.

Depositing Funds

Supported Deposit Methods

Token	Network	Min. Deposit	Confirmation Time
USDT	Polygon	$10	~30 seconds
USDT	BNB Chain	$10	~1 minute
USDT	Ethereum	$50	~3 minutes

How to Deposit

Go to Billing → Deposit in your PopTrade dashboard

Select your preferred network (Polygon recommended for lowest fees)

Copy the deposit address or scan the QR code

Send USDT from your wallet or exchange

Balance credited automatically after confirmation

Important

Only send USDT to your deposit address. Sending other tokens may result in permanent loss. Always verify you're using the correct network.

Spending & Tracking

Monitor your spending in real-time with full transparency.

Live Balance

See your balance update in real-time as campaigns spend.

Transaction History

Every charge includes impression ID, timestamp, and amount.

On-Chain Verification

Cross-reference any transaction with blockchain explorers.

Spend Breakdown

Component	Description	Visibility
Impression Cost	Your winning bid amount	On-chain
Platform Fee	15% of spend	On-chain
Publisher Payout	85% goes to publisher	On-chain

Refunds & Disputes

Transparent dispute resolution backed by on-chain evidence.

Automatic Refunds

• Traffic blocked by anti-fraud — never charged
• Invalid impressions detected post-settlement
• Publisher violations confirmed

Dispute Process

1. Submit dispute with evidence
2. On-chain data reviewed
3. Resolution within 48 hours
4. Refund via smart contract

Withdrawal of Unused Funds

You can withdraw your unused balance at any time. Withdrawals are processed via smart contract within 24 hours to your registered wallet address.

Blockchain Billing FAQ

Do I need crypto experience to use PopTrade?

Basic knowledge helps, but we've simplified the process. You just need a wallet and some USDT. Our guides walk you through each step.

Where can I buy USDT?

You can purchase USDT on any major exchange: Binance, Coinbase, Kraken, etc. Then withdraw to your wallet and deposit to PopTrade.

What if I deposit the wrong token?

Only USDT is supported. If you accidentally send another token, contact support immediately. Recovery may not always be possible depending on the token.

Are there any hidden fees?

No. You pay: (1) network gas for deposits/withdrawals (~$0.01-2), (2) 15% platform fee on spend. Both are fully transparent and visible on-chain.

Can I get an invoice for accounting?

Yes. You can export detailed invoices from Billing → Invoices. All transactions include on-chain references for audit purposes.

Smart Rules

Automate your campaign optimization with intelligent rules.

What Are Smart Rules?

Smart Rules are if-then automation rules that monitor your campaign performance and automatically take action when certain conditions are met.

Basic Structure

IF [metric] [condition] [threshold] THEN [action]

How It Works

Monitor

Track KPIs in real-time

Evaluate

Check against thresholds

Act

Execute automatically

Rule Conditions

Metrics and thresholds you can use to trigger rules.

Available Metrics

Metric	Description	Example
CTR	Click-Through Rate	IF CTR < 0.5%
Spend	Total amount spent	IF spend > $100
Conversions	Number of tracked conversions	IF conversions < 5
ROI	Return on Investment	IF ROI > 150%
CPA	Cost Per Acquisition	IF CPA > $10
Impressions	Total ad impressions	IF impressions > 10000

Comparison Operators

>

Greater than

<

Less than

=

Equals

>=

Greater or equal

<=

Less or equal

!=

Not equal

Rule Actions

What happens when a rule condition is met.

Action	Description	Use Case
Pause Campaign	Stop immediately	Prevent budget waste
Resume Campaign	Restart paused campaign	Auto-resume when performance improves
Increase Bid	Raise CPM bid	Scale profitable traffic
Decrease Bid	Lower CPM bid	Reduce bids on poor performance

Example Rules

Safety Rule: Stop Low-Performing Campaigns

IF spend > $50 AND conversions = 0 THEN pause campaign

Pauses if you've spent $50 without any conversion.

Scaling Rule: Scale Profitable Campaigns

IF ROI > 150% THEN increase bid by 10%

Automatically increases bids when ROI is strong.

Optimization Rule: Reduce Bids on Low CTR

IF CTR < 0.3% AND impressions > 5000 THEN decrease bid by 15%

Lowers bids when CTR is poor after significant impressions.

CPA Control: Cap Acquisition Cost

IF CPA > $15 THEN pause campaign

Pauses when cost per acquisition exceeds target.

Best Practices

1. Start with Safety Rules

Always create rules that protect your budget first. Set up pause rules for high spend with no conversions.

2. Use Sufficient Data Thresholds

Add conditions like `impressions > 1000` to ensure statistical significance.

3. Set Reasonable Bid Adjustments

Use moderate bid changes (5-15%) rather than dramatic swings.

4. Combine with Scheduling

Smart rules work well with scheduling for advanced optimization strategies.

5. Monitor Rule Activity

Regularly check which rules are triggering and adjust thresholds as needed.

Important Considerations

• Smart rules are evaluated periodically, not in real-time
• Multiple rules can be active on the same campaign
• Rule actions are logged for your review
• You can disable rules without deleting them

Smart Rules FAQ

How often are rules evaluated?

Smart rules are evaluated every few minutes. The exact frequency depends on your campaign activity level.

Can I have multiple rules on one campaign?

Yes, you can have multiple rules per campaign. They are evaluated independently.

What happens if conflicting rules trigger?

Rules are processed in order of creation. Pause actions take priority over bid adjustments.

Can I see when rules triggered?

Yes, each rule shows its last trigger time and a history of actions taken.

Campaign Scheduling

Control when your campaigns are active with precision timing.

Scheduling Overview

Campaign scheduling lets you control exactly when your campaigns are active. This helps you target users at optimal times and manage your budget more effectively.

Weekly Matrix

Select active hours per day

Date Ranges

Set start and end dates

Timezone Support

Target audience's local time

Weekly Schedule Matrix

Select specific hours for each day of the week.

Visual Schedule Editor

Click cells to toggle. Filled = active.

     0  1  2  3  4  5  6  7  8  9  10 11 12 13 14 15 16 17 18 19 20 21 22 23
Mon  ·  ·  ·  ·  ·  ·  ·  ·  ·  █  █  █  █  █  █  █  █  █  ·  ·  ·  ·  ·  ·
Tue  ·  ·  ·  ·  ·  ·  ·  ·  ·  █  █  █  █  █  █  █  █  █  ·  ·  ·  ·  ·  ·
Wed  ·  ·  ·  ·  ·  ·  ·  ·  ·  █  █  █  █  █  █  █  █  █  ·  ·  ·  ·  ·  ·
Thu  ·  ·  ·  ·  ·  ·  ·  ·  ·  █  █  █  █  █  █  █  █  █  ·  ·  ·  ·  ·  ·
Fri  ·  ·  ·  ·  ·  ·  ·  ·  ·  █  █  █  █  █  █  █  █  █  ·  ·  ·  ·  ·  ·
Sat  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·
Sun  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·

Example: Business hours (9 AM - 6 PM) on weekdays only

Day Targeting

• Select specific days of the week
• Different hours for different days
• Exclude weekends or weekdays

Hour Targeting

• 24-hour granularity
• Click to toggle individual hours
• Quick select for common patterns

Date Range Targeting

Limit campaigns to specific date periods.

Setting	Description	Example
Start Date	Campaign won't run before this date	2024-01-15
End Date	Campaign stops after this date	2024-02-15

Common Use Cases

• Holiday campaigns: Black Friday, Christmas
• Product launches: Launch week only
• Seasonal promotions: Summer sale
• Event marketing: Conference, webinar

Timezone Settings

The timezone setting determines how your schedule is interpreted.

Option	Description
Account Timezone	Uses your account's default timezone. Good for local market campaigns.
Target Audience Timezone	Select a specific timezone for your target audience. Ideal for international campaigns.

Example

You're in London (GMT) targeting US customers. Set the timezone to EST or PST to ensure your ads run during US business hours.

Common Use Cases

Industry	Strategy	Description
E-commerce	Shopping Hours	Run during evenings and weekends when people shop online.
B2B	Business Hours	Target Monday-Friday 9 AM - 6 PM.
Gaming	Evening & Weekend	Gaming audiences are most active evenings and weekends.
International	Multi-Timezone	Separate campaigns for different regions with local peak hours.

Combining with Smart Rules

Scheduling and Smart Rules complement each other.

Peak Hours Optimization

Schedule: 6 PM - 11 PM daily

Rule: IF ROI > 200% THEN increase bid by 15%

Weekend Campaign

Schedule: Saturday & Sunday only

Rule: IF spend > $200/day THEN pause

Scheduling FAQ

What happens outside scheduled hours?

Your campaign doesn't receive any traffic. No impressions, no spend.

Can I have multiple schedules per campaign?

Each campaign has one schedule. Use the weekly matrix for complex patterns.

Does scheduling affect my budget?

Yes, since your campaign runs fewer hours, you may not spend your full daily budget.

How do I run 24/7 with no restrictions?

Don't create a schedule, or create one with all hours selected.

Anti-Fraud Protection

Multi-layer fraud detection to protect your campaign budget.

How Anti-Fraud Works

PopTrade uses a two-layer protection system:

Layer	Description	Status
Layer 1: Built-in Detection	PopTrade's own fraud detection with 12 signals	Always Active
Layer 2: External Providers	Integration with 5 industry-leading antifraud services	Optional (BYOAF)

Fraud Score Calculation

Each request receives a fraud score from 0.0 to 1.0. Higher scores = more suspicious. When the score exceeds your threshold, the request is blocked and you don't pay for it.

Built-in Detection Signals

PopTradeDetector analyzes 12 signals to identify fraud.

Critical Signals (0.85-0.95 weight)

Signal	Weight	Description
webdriver	0.95	navigator.webdriver = true (Selenium, Puppeteer)
automation	0.90	window.callPhantom, window._phantom detected
headless	0.85	HeadlessChrome, PhantomJS in User-Agent

Behavioral Signals (0.60-0.70 weight)

Signal	Weight	Description
no_interactions	0.60	No mouse, keyboard, or scroll events
too_fast_click	0.70	Click within 500ms of page load
suspicious_timing	0.65	Time on page < 50ms (impossible)

Technical Signals (0.30-0.80 weight)

Signal	Weight	Description
no_plugins	0.30	navigator.plugins.length = 0 (desktop)
untrusted_event	0.80	event.isTrusted = false (programmatic)
invalid_coordinates	0.75	Click outside screen bounds
suspicious_ip	0.40	IP in known fraud/proxy blacklist

External Providers (BYOAF)

Bring Your Own Antifraud — integrate with industry leaders using your own API keys.

Provider	Type	Features
IPQualityScore	IP/Device	Proxy detection, device fingerprinting
Pixalate	MRC-accredited	Invalid traffic detection
Fraudlogix	Real-time	Bot detection, click fraud prevention
Forensiq (Impact)	Attribution	Ad fraud prevention
HUMAN (White Ops)	Enterprise	Sophisticated bot detection

Benefits of External Providers

• Industry-leading detection accuracy
• Constantly updated threat intelligence
• MRC-accredited (some providers)
• Results cached 5-15 min to reduce costs

Strictness Levels

Choose how aggressive your fraud filtering should be.

Level	Threshold	Description
Low	0.8	Only blocks obvious fraud. Good for maximizing volume.
Medium	0.6	Balanced approach. Recommended for most campaigns.
High	0.4	Aggressive filtering. May block some legitimate traffic.

IP Blacklist Management

Manually blacklist problematic IP addresses. Blacklisted IPs are instantly blocked from all campaigns.

Format	Example	Description
Single IP	192.168.1.100	Block individual IP addresses
IP Range (CIDR)	192.168.1.0/24	Block entire IP ranges

Frequency Cap vs Antifraud

Feature	Frequency Cap	Antifraud
Purpose	Limits impressions per user	Detects fake/bot traffic
Timing	Checked BEFORE ad serving	Checked AFTER frequency cap
Scope	Campaign-specific	Buyer-level

Recommended Settings

Performance Campaigns

CPA/ROI focused

• Strictness: High
• External providers: 1-2 enabled
• IP blacklist: Active monitoring

Branding Campaigns

Reach focused

• Strictness: Medium
• External providers: Optional
• IP blacklist: Basic setup

Testing Campaigns

New traffic sources

• Strictness: Low initially
• Monitor fraud signals
• Increase based on data

Anti-Fraud FAQ

Do I pay for blocked traffic?

No. Traffic blocked by antifraud is not charged. You only pay for impressions that pass fraud detection.

Can I see why traffic was blocked?

Yes. Your antifraud dashboard shows blocked requests with the specific signals that triggered the block.

How do I add external provider API keys?

Go to Antifraud Settings, select the provider, and enter your API credentials. Results are cached automatically.

Does high strictness hurt my volume?

Higher strictness may reduce total impressions, but the remaining traffic is higher quality.

SDK Integration

Track conversions and optimize campaigns with the PopTrade SDK.

Overview

The PopTrade SDK enables automatic conversion tracking on your landing pages. When a user clicks your ad and completes an action, the SDK reports the conversion back to PopTrade.

Track ROI in real-time

Use Smart Rules with conversions

Optimize for specific actions

Measure true performance

How It Works

1. User clicks ad → lands on your page with ?ptclick=CLICK_ID

2. SDK loads and stores the click ID

3. User navigates through your site

4. User reaches conversion page (e.g., /thank-you.php)

5. SDK detects URL match → sends conversion to PopTrade

Quick Start

Step 1: Add the SDK Script

Add this to your website's <head> section on all pages:

<script src="https://app.tradepop.io/poptrade-sdk.js"
    data-campaign-id="YOUR_CAMPAIGN_ID">
</script>

Step 2: Configure Conversion Tracking

<script>
PopTradeSDK.init({
    campaignId: 'YOUR_CAMPAIGN_ID',
    conversions: {
        sale: '/thank-you.php',
        lead: '/contact-success.php',
        signup: '/welcome.php'
    },
    values: {
        sale: 0,      // Dynamic from URL (?value=99.99)
        lead: 25.00,  // Fixed value
        signup: 15.00
    }
});
</script>

SDK Generator

Use the SDK Code Generator in your dashboard (Documentation → SDK Integration) to create ready-to-use code for your campaigns.

Conversion Types

The SDK supports these built-in conversion types:

Type	Description	Use Case
lead	Lead generation	Contact forms, quote requests
signup	User registration	Account creation, trial signups
sale	Purchase completion	E-commerce orders, subscriptions
deposit	Balance top-up	Gaming, trading platforms
install	Software installation	App downloads, software trials
custom	Custom action	Any other trackable event

Conversion Values

Fixed Values

values: {
  lead: 50.00,   // $50 per lead
  signup: 25.00  // $25 per signup
}

Dynamic Values (from URL)

values: {
  sale: 0  // From ?value=149.99
}
// URL: /thank-you.php?value=149.99

URL Pattern Matching

The SDK detects conversions by matching the current URL against your configured patterns.

Pattern	Description	Example Match
/success.php	Exact path	yoursite.com/success.php
/order/	Contains path	yoursite.com/order/123/complete
#/checkout/success	Hash-based (SPA)	yoursite.com/#/checkout/success
?status=complete	Query parameter	yoursite.com/order?status=complete

Integration Methods

Basic Integration (Recommended)

<script src="https://app.tradepop.io/poptrade-sdk.js"
    data-campaign-id="YOUR_CAMPAIGN_ID">
</script>
<script>
PopTradeSDK.init({
    campaignId: 'YOUR_CAMPAIGN_ID',
    conversions: { sale: '/thank-you.php' },
    values: { sale: 0 }
});
</script>

Data Attributes Only (No JavaScript)

<script src="https://app.tradepop.io/poptrade-sdk.js"
    data-campaign-id="YOUR_CAMPAIGN_ID"
    data-conversions="sale:/thank-you.php:0|lead:/contact.php:25">
</script>

Format: type:urlPattern:value|type:urlPattern:value

Manual Tracking (for SPAs)

// After successful checkout
PopTradeSDK.conversion({
    type: 'sale',
    value: orderData.total
});

Testing Conversions

Enable Debug Mode

PopTradeSDK.init({
    campaignId: 'YOUR_CAMPAIGN_ID',
    debug: true,  // Enable console logging
    // ...
});

Test Flow

Open your landing page with test click ID: ?ptclick=test_123

Navigate to your conversion page

Check browser console for SDK messages

Verify conversion in PopTrade dashboard

Debug Console Output

[PopTradeSDK] Initialized with campaign: YOUR_CAMPAIGN_ID
[PopTradeSDK] Click ID found: test_123
[PopTradeSDK] Checking URL: /thank-you.php
[PopTradeSDK] ✓ Conversion match: sale
[PopTradeSDK] ✓ Conversion recorded successfully

SDK Integration FAQ

Do I need the SDK on every page?

Yes, include the SDK on all pages. It stores the click ID on landing and tracks conversions on thank-you pages.

What if my thank-you page has dynamic URLs?

Use partial URL matching (e.g., '/order/success') or manual conversion tracking for SPAs.

Can I track multiple conversion types?

Yes, configure as many types as needed. Each can have its own URL pattern and value.

How quickly do conversions appear?

Conversions typically appear within seconds in your campaign statistics.

Can I use the SDK with Google Tag Manager?

Yes, add the SDK as a custom HTML tag and trigger it on page load.

Is there an attribution window?

Conversions are attributed within the same browser session. There's no multi-day attribution window.

Settlement & Payout System

Understanding when and how publishers get paid for delivered traffic.

Overview

PopTrade uses a blockchain-based settlement system that ensures transparent, trustless payments between buyers and publishers. All payments are made in cryptocurrency (USDT, USDC, or MATIC) directly to publisher wallets.

Core Principle

Publishers are paid for all traffic that passes antifraud verification, regardless of why the campaign ends.

Transparent

All settlements are recorded on-chain for full auditability.

Trustless

Smart contracts ensure payments are automatic and non-reversible.

Fair

Publishers get paid for all legitimate traffic, no exceptions.

Settlement Triggers

Payments to publishers are triggered in several scenarios:

Trigger	Description	Type
Weekly Settlement	Regular 7-day payment cycle for ongoing campaigns	Automatic
Campaign Completion	Buyer ends campaign early or budget exhausted	Final
Publisher Withdrawal	Publisher removes placement/bundle from campaign	Exit
Buyer-Initiated Removal	Buyer removes a placement/bundle from campaign	Removal
Campaign Expiration	Campaign reaches end date	Final

Weekly Settlements

For long-running campaigns, settlements occur automatically every 7 days.

Settlement Flow

Traffic Delivery (Day 1-7)

Impressions and clicks are recorded continuously

Cycle Close (Day 7)

Settlement cycle ends, aggregation begins

Antifraud Check

Only clean traffic is counted for payment

Oracle Submission

Quality metrics submitted to blockchain

Smart Contract Execution

Payment released to publisher wallets

What Gets Paid

Included

✓ Impressions that passed antifraud
✓ Clicks from verified traffic

Excluded

✗ Traffic blocked by antifraud
✗ Fraudulent clicks/impressions

Settlement Calculation

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

Early Campaign Completion by Buyer

When a buyer stops or completes a campaign early, publishers are still paid for all delivered traffic.

What Happens

Buyer clicks "Stop Campaign" or campaign status changes

Final settlement triggered for all unsettled traffic

Traffic aggregation counts all events since last settlement

Antifraud verification filters fraudulent traffic

Payment released to all publishers who delivered traffic

Remaining budget (if any) returned to buyer's escrow

Important

Publishers receive payment for all clean traffic delivered up to the stop moment. Buyer cannot reverse payments for legitimately delivered traffic. Settlement processes within 24-48 hours of campaign stop.

Publisher Placement/Bundle Withdrawal

When a publisher removes their placement or bundle from an active campaign, they receive payment for traffic delivered before withdrawal.

Withdrawal Process

Publisher initiates withdrawal

Grace period begins (optional, configured by buyer)

Placement/bundle removed from campaign

Exit settlement calculated

Antifraud verification applied

Payment released to publisher

Exit Settlement Rules

Scenario	Payment
Immediate withdrawal	Full payment for clean traffic to date
Grace period withdrawal	Full payment + grace period traffic
Withdrawal with pending settlement	Combined with exit settlement

Buyer-Initiated Removal

When a buyer removes a placement or bundle from their campaign, the publisher still receives payment for delivered traffic.

Removal Process

Buyer removes placement/bundle from campaign sources

Removal settlement calculated for that publisher

All clean traffic from that publisher is paid out

Notification sent to publisher about removal

Campaign continues with remaining sources (if any)

Why Buyers Might Remove Sources

• Traffic quality not meeting expectations
• ROI below target for specific source
• Campaign optimization based on performance data
• Budget reallocation to better-performing sources

Publisher Protection

Even when removed by a buyer, publishers are guaranteed payment for all impressions that passed antifraud and all verified clicks.

Antifraud Verification in Settlements

All settlements undergo antifraud verification. Only traffic that passes verification is included in payouts.

Verification Flow

Traffic event recorded

Built-in detector check (12 signals)

External provider check (if enabled)

Fraud score calculated (0.0 - 1.0)

Compare to threshold

For Publishers

• Focus on quality traffic to maximize payouts
• High fraud rates reduce earnings
• Reputation affects buyer trust
• Clean traffic = full payment

For Buyers

• Only pay for traffic meeting antifraud standards
• Blocked traffic is not charged
• Threshold settings determine strictness
• Higher strictness = less volume, better quality

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
Publisher withdrawal	24-48 hours after exit
Buyer removal	24-48 hours
Manual settlement	1-3 business days

Settlement Statuses

Pending

Awaiting processing

Processing

Contract executing

Completed

Funds transferred

Failed

Requires investigation

Manual

Admin required

Settlement FAQ

What if a campaign stops with unsettled traffic?

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

Can a buyer refuse to pay for delivered traffic?

No. The blockchain escrow system ensures publishers are paid for all traffic that passes antifraud verification. Buyers cannot withhold payment for legitimate traffic.

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.

What happens if settlement fails?

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

Can I see details of what was paid and blocked?

Yes. Settlement history shows total traffic, blocked traffic (with reasons), and final payout amount.

Are referral commissions included in settlements?

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 antifraud dashboard. If you believe traffic was incorrectly blocked, contact support with specific details for review.

Is there a minimum settlement amount?

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