Skip to content

Latest commit

 

History

History
610 lines (465 loc) · 15.2 KB

INTEGRATION_GUIDE.md

File metadata and controls

610 lines (465 loc) · 15.2 KB

ADMENSION Integration Guide

From $0 to $6-20 RPM in 4 Weeks

Version: 2.0
Target: $6-20 RPM (Revenue Per Mille/Thousand Sessions)
Timeline: 4 weeks to full monetization
Status: Production-ready ad infrastructure

📋 Table of Contents

  1. Quick Start
  2. Week 1: Foundation (AdSense)
  3. Week 2-3: Header Bidding
  4. Week 4: Optimization
  5. Advanced Strategies
  6. Troubleshooting

🚀 Quick Start

What's Already Built

Your ADMENSION project includes:

  • ✅ Complete UI framework (6 HTML pages)
  • ✅ Session tracking & analytics
  • ✅ ADMENSION payout system
  • ✅ Sponsored sticky slot booking
  • ✅ Ad placeholder infrastructure
  • ✅ NEW: Production ad configuration (ads-config.js)
  • ✅ NEW: GDPR/CCPA consent management (consent.js)
  • ✅ NEW: ads.txt template

What You Need

  1. Domain name (required for ad networks)
  2. Hosting (Netlify, Vercel, Cloudflare Pages - all free)
  3. Traffic source (50-100 daily users minimum)
  4. Content/utility (ad networks reject pure ad platforms)
  5. Time (2-4 weeks for full setup)

📅 Week 1: Foundation

Goal: Get AdSense Approved & Live ($2-4 RPM)

Step 1.1: Prepare Your Site for AdSense

Action Items:

  1. Add actual content to your site

    • Write 10-15 blog posts about trading, crypto, or finance
    • Add a "About" page
    • Add a "Contact" page
    • Create useful tools/calculators related to trading

  2. Create required pages:

    /privacy-policy.html - REQUIRED for AdSense
/terms-of-service.html - Recommended
/about.html - Recommended
/contact.html - Recommended

  3. Ensure your site has:

    • Clear navigation
    • Original content (not copied)
    • Professional design (you already have this!)
    • Mobile-responsive (you already have this!)

Step 1.2: Deploy to Production

Option A: Netlify (Recommended)

# Install Netlify CLI
npm install -g netlify-cli

# Navigate to your project
cd "/Users/TheRustySpoon/Desktop/Projects/Main projects/Trading_bots/ADMENSION"

# Deploy
netlify deploy --prod

Option B: Vercel

# Install Vercel CLI
npm install -g vercel

# Deploy
vercel --prod

Option C: Manual Upload

  • Upload all HTML files to any static hosting
  • Ensure ads.txt is in root directory
  • Verify site is accessible via custom domain

Step 1.3: Configure Ad System

  1. Update ads-config.js:

    • Open the file
    • Wait for AdSense approval to get your publisher ID
    • For now, leave placeholders

  2. Update ads.txt:

    • Wait for AdSense approval
    • Replace pub-XXXXXXXXXXXXXXXX with your actual ID
    • Deploy to site root

  3. Add scripts to HTML files:

Add these lines to the <head> section of each HTML file (index.html, admin.html, create.html, manage.html, stats.html, docs.html):

<!-- Before closing </head> tag -->

<!-- Consent Management (GDPR/CCPA) -->
<script src="/consent.js"></script>

<!-- Ad Configuration -->
<script src="/ads-config.js"></script>
  1. Replace ad placeholder divs:

Find placeholders like:

<div class="ad"><div class="adLabel">TOP — Banner</div></div>

Replace with:

<div id="ad-top-banner" class="ad-container" style="min-height: 90px;"></div>

Do this for all ad slots:

  • id="ad-sticky-footer" (sticky footer)
  • id="ad-top-banner" (top banner on each page)
  • id="ad-rail-left" (left sidebar)
  • id="ad-rail-right" (right sidebar)
  • id="ad-in-content-tall" (in-content units)

Step 1.4: Apply for Google AdSense

  1. Go to https://www.google.com/adsense
  2. Sign up with your Google account
  3. Add your website URL
  4. Wait for site review (1-7 days typically)
  5. Once approved:
    • Copy your publisher ID (pub-XXXXXXXXXXXXXXXX)
    • Update ads-config.js line 18
    • Update ads.txt line 6
    • Redeploy your site

Step 1.5: Drive Initial Traffic

Minimum: 50-100 daily active users

Traffic Sources:

  • Your existing trading bot users
  • Social media (Twitter/X, Reddit crypto communities)
  • Discord/Telegram trading groups
  • Product Hunt launch
  • Hacker News (if you have trading signals/tools)
  • Organic SEO (blog content)

Expected Revenue (Week 1):

  • 100 DAU × 3 pages/session × 4 ads = 1,200 impressions/day
  • At $2 CPM (AdSense baseline) = $2.40/day = $0.80 RPM

📅 Week 2-3: Header Bidding

Goal: 3-4x Revenue Increase ($8-12 RPM)

Once you have:

  • ✅ AdSense approved and serving
  • ✅ 100+ daily users
  • ✅ Baseline revenue data (1-2 weeks)

Step 2.1: Sign Up for Demand Partners

Priority Networks (easiest approval):

  1. Index Exchange → https://www.indexexchange.com/publishers/

    • Apply as publisher
    • Minimum: 10M monthly impressions (or partner via managed service)
    • Alternative: Use managed header bidding service

  2. OpenX → https://www.openx.com/publishers/

    • Apply with traffic proof
    • Minimum: 5M monthly impressions

  3. Sovrn → https://www.sovrn.com/publishers/

    • Lower barriers, good for starting out
    • Decent fill rates

  4. PubMatic → https://pubmatic.com/products/sell-side-platform/

    • Mid-tier approval requirements

Note: If your traffic is < 1M monthly impressions, consider:

  • Ezoic (managed service, easier approval)
  • Mediavine (requires 50k sessions/month)
  • AdThrive (requires 100k pageviews/month)

Step 2.2: Configure Prebid.js

Once approved by 2-3 networks:

  1. Update ads-config.js:

    prebid: {
  enabled: true,  // Change from false
  timeout: 1800,
  priceGranularity: 'medium',
  currency: 'USD'
}

  2. Add your network IDs (lines 266-279):

    bids: [
  {
    bidder: 'ix',
    params: { siteId: 'YOUR_IX_SITE_ID' }
  },
  {
    bidder: 'openx',
    params: { unit: 'YOUR_UNIT_ID', delDomain: 'YOUR-d.openx.net' }
  },
  // etc.
]

  3. Test header bidding:

    • Deploy updated config
    • Open browser console
    • Look for [AdManager] Prebid initialized logs
    • Verify bids are coming through

Step 2.3: Optimize Waterfall

Monitor performance for 7 days, then adjust:

  1. Floor prices: Set minimum bids per placement

    floors: {
  'sticky-footer': 2.50,  // Premium placement
  'top-banner': 2.00,
  'rail-left': 1.50,
  'in-content-tall': 1.75
}

  2. Timeout optimization:

    • Start: 1800ms (1.8s)
    • If fill rate > 95%: Reduce to 1500ms
    • If fill rate < 80%: Increase to 2500ms

  3. A/B test layouts:

    • Test different ad densities
    • Monitor session duration vs RPM
    • Find optimal balance

Expected Revenue (Week 2-3):

  • 200 DAU × 3.5 pages/session × 5 ads = 3,500 impressions/day
  • At $6 CPM (header bidding) = $21/day = $6 RPM
  • With sponsored slots: +$15/day = $10.50 RPM

📅 Week 4: Optimization

Goal: Push to $12-20 RPM

Step 4.1: Activate Advanced Features

  1. Enable lazy loading (already built-in):

    • Verify in console: "[AdManager] Setting up lazy loading"
    • Improves viewability scores
    • Reduces wasted ad calls

  2. Enable navigation refresh:

    • Already active by default
    • Multiplies impressions per session
    • Policy-compliant (triggered by user action)

  3. Activate geo-based density:

    • Already implemented in code
    • Tier 1 geos (US/CA/UK/AU) get full ad density
    • Tier 2/3 get reduced density for better UX

Step 4.2: Launch Sponsored Sticky Marketplace

  1. Set pricing (already in code):

    0-100 DAU: $5 per 72 hours
100-500 DAU: $15 per 72 hours
500-2000 DAU: $50 per 72 hours
2000+ DAU: $150-500 per 72 hours

  2. Create sales page:

    • Add /advertise.html page
    • Explain sponsored sticky benefits
    • Add payment/booking form (Stripe, crypto)

  3. Promote to:

    • Trading tool developers
    • Crypto projects
    • DeFi protocols
    • Competing trading bots

  4. Automate booking:

    • Build simple backend (optional)
    • Or manage manually via admin panel

Step 4.3: Implement Context Skins

Already scaffolded in code, just activate:

  1. Create context variants in ads-config.js:

    contextSkins: {
  'crypto-trading': {
    title: 'Advanced Crypto Trading Signals',
    keywords: 'bitcoin, ethereum, trading, crypto, defi'
  },
  'technical-analysis': {
    title: 'Technical Analysis Tools & Charts',
    keywords: 'charts, indicators, RSI, MACD, trading signals'
  },
  'defi-yields': {
    title: 'DeFi Yield Farming Calculator',
    keywords: 'defi, yield farming, APY, liquidity mining'
  }
}

  2. Rotate contexts based on:

    • Time of day
    • User behavior
    • Trending topics
    • Highest-paying categories

Why this works:

  • Crypto/finance ads pay $15-40 CPM
  • Generic content gets $2-8 CPM
  • Context targeting = 2-3x CPM boost

Step 4.4: Direct Ad Sales

Bypass ad networks, keep 100% margin:

  1. Create ad packages:

    Sticky Footer (week): $200
Sidebar (month): $400
Full page takeover (week): $800

  2. Target buyers:

    • Crypto exchanges
    • Trading platforms
    • NFT marketplaces
    • Web3 tools
    • Competing bots/services

  3. Pitch template:

    Subject: Direct Ad Placement on ADMENSION

Hi [Name],

ADMENSION serves 2,000+ crypto traders daily with 4+ pages/session 
engagement. We're offering direct ad placements (no middleman):

- Sticky footer: Always visible, 100% viewability
- 70% US/UK traffic (premium geos)
- Trading-focused audience with high intent

Pricing: $200/week for sticky footer (vs $600+ via ad networks)

Interested in a test week?

Expected Revenue (Week 4):

  • 500 DAU × 4 pages/session × 6 ads = 12,000 impressions/day
  • At $9 weighted CPM = $108/day
  • Sponsored slots (6 active): $90/day
  • Direct sales: $200/week = $29/day
  • Total: $227/day ÷ 2,000 sessions = $11.35 RPM

🚀 Advanced Strategies

Path to $15-20 RPM

1. Premium Header Bidding Partners

Once you have 1M+ monthly impressions:

  • Amazon TAM (A9): $3-8 CPM additional lift
  • Xandr (AppNexus): Premium demand
  • Magnite (Rubicon): High fill rates
  • PubMatic Premium: Direct deals

2. Trading Signal Integration (Outside the Box)

Concept: Turn ADMENSION into actual utility

  1. Free basic signals:

    • RSI alerts
    • Moving average crossovers
    • Volume spikes
    • Must view 1 ad to receive alert

  2. Premium signals (behind sponsored sticky):

    • Advanced indicators
    • Multi-timeframe analysis
    • Portfolio tracking
    • $10-50/month subscription
    • OR unlock via ad engagement

  3. Why this 10x's revenue:

    • Creates retention (daily active users)
    • Justifies higher ad density
    • Attracts crypto advertisers ($20-40 CPM)
    • Builds actual moat beyond "just ads"

3. ADMENSION Network Effect

Viral growth strategy:

  1. Recruit creators:

    • Offer 13% revenue share
    • Create tracking links
    • Gamify leaderboard

  2. Target:

    • Crypto Twitter influencers
    • YouTube trading channels
    • Trading Discord communities
    • Finance TikTokers

  3. Growth math:

    • 10 creators × 100 referrals each = 1,000 users
    • 1,000 users × 4 pages × 6 ads = 24,000 imp/day
    • At $12 CPM = $288/day
    • 13% pool = $37/day split among creators
    • Scale to 100 creators = 10,000+ users

4. Session Depth Gamification

Increase pages/session from 3 to 6:

  1. Progressive unlocks:

    • Page 1: Basic features
    • Page 2: Unlock calculator
    • Page 3: Unlock charts
    • Page 4: Unlock advanced signals
    • Page 5+: Premium content

  2. Each page = fresh ad impression

    • 3 pages/session → 6 pages = 2x revenue
    • Combined with header bidding = 6x baseline

🛠 Troubleshooting

Ads Not Showing

Check:

  1. Console errors (F12 → Console)
  2. AdSense approval status
  3. ads-config.js publisher ID correct
  4. Consent banner accepted
  5. Ad blocker disabled (for testing)

Common Issues:

// Issue: "AdSense script failed to load"
// Fix: Check publisher ID, verify ads.txt deployed

// Issue: "Div not found: ad-sticky-footer"
// Fix: Ensure you replaced placeholder divs with correct IDs

// Issue: "Advertising disabled - ads will not load"
// Fix: Accept cookies in consent banner

Low RPM (<$2)

Likely causes:

  1. Tier 3 traffic (non-US/EU)
  2. Low session depth (< 2 pages)
  3. Poor ad placement (below fold)
  4. No header bidding yet
  5. Brand safety issues (flagged content)

Fixes:

  • Drive tier 1 traffic (US/CA/UK/AU)
  • Improve UX to increase pages/session
  • Add sticky footer (100% viewability)
  • Implement Prebid.js
  • Review content for policy compliance

AdSense Rejection

Common reasons:

  1. Insufficient content → Add 15-20 quality articles
  2. Pure ad site → Add actual utility/tools
  3. Copied content → Write original content
  4. Under construction → Complete all pages
  5. Traffic source → Avoid bot traffic, use organic

Appeal process:

  1. Fix issues listed
  2. Wait 2 weeks
  3. Reapply via AdSense portal
  4. Provide traffic proof (Google Analytics screenshot)

📊 Success Metrics

Week-by-Week Targets

Week Setup Traffic RPM Daily Revenue
1 AdSense only 100 DAU $0.80 $2.40
2 + 2 SSP partners 200 DAU $4.00 $24
3 + Full Prebid 300 DAU $8.00 $72
4 + Optimizations 500 DAU $12.00 $180
8 + Direct sales 1000 DAU $16.00 $480
12 + Premium SSPs 2000 DAU $20.00 $1,200

Key Performance Indicators

Track daily:

  • RPM (revenue per 1000 sessions)
  • Fill rate (% of ad requests filled)
  • Viewability rate (target: 70%+)
  • Session depth (pages per visit)
  • CTR (natural 0.1-0.5%, don't optimize)

Track weekly:

  • DAU growth rate
  • Geo mix (% tier 1 traffic)
  • Header bidding win rate
  • Direct sales pipeline

Tools:

  • Google Analytics (traffic)
  • AdSense dashboard (revenue)
  • Prebid analytics (bidding)
  • Your built-in stats page

🎯 Final Checklist

Before going live:

  • Domain registered and live
  • All HTML files deployed
  • ads.txt in root directory (with correct IDs)
  • consent.js loaded on all pages
  • ads-config.js loaded on all pages
  • Ad divs replaced with correct IDs
  • Privacy policy page created
  • AdSense application submitted
  • Initial traffic source identified (50+ DAU)
  • Analytics tracking implemented
  • Test on mobile and desktop
  • Ad blocker disabled for testing
  • Console shows no errors
  • First ad impression verified

📞 Support & Resources

Documentation:

Communities:

  • r/adops (Reddit)
  • Digital Point Forums
  • Warrior Forum (monetization section)

Tools:

Built with ADMENSION v2.0
Target: $6-20 RPM | Status: Production-Ready

Good luck scaling to $20 RPM! 🚀