Publisher Integration & Setup Documentation
Comprehensive step-by-step developer guidelines for domain verification, smart ad tag deployments, real-time CPC bidding, and Net-30 revenue disbursements.
Account Registration & 2FA Email Verification
To ensure high traffic authenticity, all publishers undergo automated 2-Factor authentication powered by Brevo HTTPS OTP infrastructure before platform access is granted.
1. Publisher Profile Submission
Register with your official contact details, website category, monthly traffic tier, and optional Telegram handle for dedicated account management.
2. Brevo 6-Digit OTP Protocol
A secure 6-digit confirmation token is dispatched instantly. Codes remain valid for 15 minutes with instant self-service resend capability.
Domain Ownership Verification
Submit your clean domain name (e.g., example.com) under Websites ➔ Add Website. To protect site owners, you must verify domain ownership using either of the following two methods:
Method A: HTML Meta Tag Placement (Recommended)
Copy your unique verification token and insert the meta tag inside the <head> container of your website's homepage:
<meta name="pubbidder-verification" content="pb_verify_YOUR_UNIQUE_TOKEN" />
Method B: Root Verification TXT File Upload
Create a plain text file named pubbidder-verify.txt containing solely your verification token, and place it in the public root directory of your web host:
https://yourdomain.com/pubbidder-verify.txt
Click "Verify Domain" in your dashboard. Once validated, our quality team reviews and approves your website for ad delivery within 2–6 hours.
Ad Unit Tags & Integration Codes
Once your domain status is Approved, generate your desired ad format under Ad Units ➔ Create New Ad Unit.
1. Native In-Page Push Banner (Floating Widget)
A non-intrusive floating push notification card that appears at the bottom-left of the user screen. Pulls real-time native creatives (image, title, description) dynamically from Adon3 SSP.
<!-- PubBidder Dynamic In-Page Push Tag --> <script src="https://pub.heyswan.site/tag/inpage/YOUR_SUBID.js" async></script>
📌 Placement: Place this tag immediately before the closing </body> tag on all pages.
2. Direct SmartLink (Popunder / Action Trigger)
Direct smart URL that routes visitor clicks through our programmatic waterfall mediation engine to secure the top CPC advertiser bid.
https://pub.heyswan.site/click/YOUR_SUBID
📌 Placement: Bind this URL behind download buttons, video players, navigation elements, or custom popup scripts.
3. Full-Page Auto Popunder Script
Lightweight JavaScript trigger with built-in 10-minute user capping via localStorage to deliver popunder ads without degrading user experience.
<!-- PubBidder Popunder Auto-Trigger --> <script src="https://pub.heyswan.site/tag/popunder/YOUR_SUBID.js" async></script>
Revenue Attribution & Net-30 Payout Terms
Publisher earnings are calculated in real-time on every qualified ad interaction based on our dynamic Revenue Share split and deposited immediately into your platform balance.
| Payout Method | Minimum Threshold | Fee & Processing Time |
|---|---|---|
| Bank Wire (SWIFT / IBAN) | $500.00 USD | Net-30 (3–5 Business Days) |
| Payoneer | $300.00 USD | Net-30 (Instant / Within 24h) |
| PayPal | $300.00 USD | Net-30 (Instant / Within 24h) |
Ensure your payout credentials (IBAN, Swift, or Payoneer/PayPal email) are configured under Settings ➔ Payout Settings.
Traffic Quality & Anti-Fraud Compliance
Our autonomous traffic analysis engine actively inspects incoming requests using Cloudflare threat intelligence to maintain brand safety for our demand partners.
❌ Strictly Prohibited Traffic
Automated bots, headless browsers, proxy/VPN networks, PTC sites, auto-refresh iframes, and fake misleading click overlays.
🛡️ Policy Enforcement
Accounts found generating invalid artificial traffic are subject to immediate suspension, domain blacklisting, and balance forfeiture.