╔═══════════════════════════════════════════════════════════════════════════╗
║ ║
║ ADHUB - GUIDA INTEGRAZIONE SEMPLIFICATA ║
║ Site: topboatmarket.com ║
║ ║
╚═══════════════════════════════════════════════════════════════════════════╝
Build Date: 2026-01-15 09:12:41
Bundle Version: 2.0.0 (GDPR/TCF 2.2 + Video Ads + Playlists)
═══════════════════════════════════════════════════════════════════════════
1. INTEGRAZIONE SCRIPT
═══════════════════════════════════════════════════════════════════════════
Aggiungi SOLO questo script nel del tuo sito:
┌───────────────────────────────────────────────────────────────────────────┐
│
└───────────────────────────────────────────────────────────────────────────┘
⚠️ IMPORTANTE:
• Il bundle include TUTTO: Prebid.js, GAM, CMP, Video, Analytics
• Il CSS viene caricato automaticamente dal bundle (nessun file CSS esterno)
• Gli ad units si attivano automaticamente dopo il consenso GDPR
🔧 Per debug/development usa il bundle esteso:
═══════════════════════════════════════════════════════════════════════════
2. PLACEHOLDER AD UNITS (Display Ads)
═══════════════════════════════════════════════════════════════════════════
Aggiungi questi div nel dove vuoi mostrare gli annunci display:
💡 Gli ad units verranno stilizzati automaticamente dal CSS dinamico nel bundle.
═══════════════════════════════════════════════════════════════════════════
3. VIDEO PLAYER (Single Video Ad) - AUTO-INIT
═══════════════════════════════════════════════════════════════════════════
✨ INIZIALIZZAZIONE AUTOMATICA - Aggiungi SOLO il div con attributo data-adhub-video:
┌─── STICKY LEFT (Automatico) ──────────────────────────────────────────────┐
│ │
└───────────────────────────────────────────────────────────────────────────┘
┌─── STICKY RIGHT (Automatico) ─────────────────────────────────────────────┐
│ │
└───────────────────────────────────────────────────────────────────────────┘
┌─── IN-ARTICLE (Automatico) ───────────────────────────────────────────────┐
│ │
└───────────────────────────────────────────────────────────────────────────┘
⚙️ INIZIALIZZAZIONE MANUALE (Opzionale, per controllo avanzato):
💡 L'auto-init è RACCOMANDATO - zero JavaScript necessario!
═══════════════════════════════════════════════════════════════════════════
4. VIDEO PLAYLISTS (Continuous Video Content + Ads) - AUTO-INIT
═══════════════════════════════════════════════════════════════════════════
Le playlists alternano video content e video ads automaticamente.
✨ INIZIALIZZAZIONE AUTOMATICA - Aggiungi SOLO il div con attributi data-*:
┌─── STICKY PLAYLIST LEFT (Automatico) ─────────────────────────────────────┐
│ │
└───────────────────────────────────────────────────────────────────────────┘
┌─── STICKY PLAYLIST RIGHT (Automatico) ────────────────────────────────────┐
│ │
└───────────────────────────────────────────────────────────────────────────┘
┌─── IN-CONTENT PLAYLIST (Automatico) ──────────────────────────────────────┐
│ │
└───────────────────────────────────────────────────────────────────────────┘
Attributi disponibili:
• data-adhub-playlist → Posizione: sticky-left, sticky-right, in-content
• data-playlist-code → Playlist: viral, news, gossip, donnemagazine, actualidad
• data-enable-ads → Ads: true (default) o false
🔄 RETROCOMPATIBILITÀ (vecchia sintassi ancora supportata):
• → Funziona ancora!
• Posizione dedotta automaticamente dall'ID (sticky-left, sticky-right, o in-content)
⚙️ INIZIALIZZAZIONE MANUALE (Opzionale, per controllo avanzato):
🎬 PLAYLIST DISPONIBILI:
• viral - Lifestyle: acne, ansia, capelli, dormire
• news - News: avvocato incidenti, difesa, multe
• gossip - Spettacolo: off camera interviste
• donnemagazine - Donna: chirurgo botox, psicologa
• actualidad - Actualidad: vari temi (ES)
💡 Le playlist vengono stilizzate automaticamente (player controls, progress bar,
close button, next button, video counter, etc.)
═══════════════════════════════════════════════════════════════════════════
5. CSS AUTOMATICO
═══════════════════════════════════════════════════════════════════════════
✅ Il bundle carica automaticamente tutti gli stili CSS necessari:
• Ad containers responsive
• Video player (sticky + in-content)
• Video playlists (sticky + in-content)
• Controls, buttons, overlays
• Mobile responsive breakpoints
❌ NON devi aggiungere nessun CSS manualmente!
Il modulo AdHubCSS inietta dinamicamente ~9KB di stili ottimizzati nel .
═══════════════════════════════════════════════════════════════════════════
6. DEBUG & API
═══════════════════════════════════════════════════════════════════════════
Apri la console JavaScript per accedere alle API di debug:
┌─── GAM ───────────────────────────────────────────────────────────────────┐
│ AdHubGAM.getState() // Stato sistema GAM │
│ AdHubGAM.getSlotCodes() // Lista slot configurati │
│ AdHubGAM.refreshSlots([...]) // Refresh specifici slot │
└───────────────────────────────────────────────────────────────────────────┘
┌─── PREBID ────────────────────────────────────────────────────────────────┐
│ pbjs.getBidResponses() // Risposte bid │
│ pbjs.getAdserverTargeting() // Targeting GAM │
└───────────────────────────────────────────────────────────────────────────┘
┌─── CONSENT (GDPR) ────────────────────────────────────────────────────────┐
│ AdHubCMP.getState() // Stato consenso │
│ AdHubCMP.checkConsent() // Verifica consenso │
└───────────────────────────────────────────────────────────────────────────┘
┌─── SITE CONFIG ───────────────────────────────────────────────────────────┐
│ Topboatmarket.comDebug.getConfig() // Config sito │
│ Topboatmarket.comDebug.getBids() // Bids Prebid │
│ Topboatmarket.comDebug.showSSPConfig() // Config SSP │
└───────────────────────────────────────────────────────────────────────────┘
┌─── VIDEO PLAYLISTS ───────────────────────────────────────────────────────┐
│ Topboatmarket.comPlaylist.listPlaylists() // Lista playlist disponibili │
│ Topboatmarket.comPlaylist.getConfig() // Config playlist │
└───────────────────────────────────────────────────────────────────────────┘
┌─── CSS ───────────────────────────────────────────────────────────────────┐
│ AdHubCSS.loaded // Verifica se CSS è caricato │
│ AdHubCSS.reload() // Ricarica CSS (per debug) │
└───────────────────────────────────────────────────────────────────────────┘
═══════════════════════════════════════════════════════════════════════════
7. DEBUG URL PARAMETERS
═══════════════════════════════════════════════════════════════════════════
Aggiungi questi parametri all'URL per attivare debug mode:
?debug=1 → Debug generale AdHub
?debug=cmp → Debug sistema consenso GDPR
?debug=ssp → Debug configurazione SSP
?debug=prebid → Debug Prebid.js
?debug=playlist → Debug video playlists
?pbjs_debug=true → Debug Prebid dettagliato
═══════════════════════════════════════════════════════════════════════════
8. FILE GENERATI
═══════════════════════════════════════════════════════════════════════════
📦 Bundle JavaScript:
• dist/topboatmarket.com/adhub-topboatmarket.com.js (extended, con logs)
• dist/topboatmarket.com/adhub-topboatmarket.com.min.js (minified, production)
📄 Altri file:
• dist/topboatmarket.com/ads.txt (da caricare in root dominio)
• dist/topboatmarket.com/integration-guide.txt (questo file)
⚠️ IMPORTANTE: Carica ads.txt nella root del tuo dominio!
Esempio: https://tuodominio.com/ads.txt
═══════════════════════════════════════════════════════════════════════════
9. CHECKLIST INTEGRAZIONE
═══════════════════════════════════════════════════════════════════════════
□ Script bundle incluso nel
□ Placeholder div aggiunti al
□ ads.txt caricato nella root del dominio
□ Console JavaScript senza errori
□ AdHubGAM.getState() mostra initialized: true
□ AdHubCMP.getState() mostra consenso valido
□ AdHubCSS.loaded ritorna true
□ Annunci display visibili nei container
□ Video player/playlist funzionanti (se implementati)
═══════════════════════════════════════════════════════════════════════════
🎉 Setup completato! Il tuo sito è pronto per monetizzare con AdHub.
Build by: AdHub Bundle Builder v2.0.0
Date: 2026-01-15 09:12:41
═══════════════════════════════════════════════════════════════════════════