-
-
Notifications
You must be signed in to change notification settings - Fork 0
Open
Labels
ad-systemdocumentationImprovements or additions to documentationImprovements or additions to documentation
Description
What
The ad system has been rewritten (PR #22) to use manual placement. Ads will NOT render until you create 3 ad units in your AdSense dashboard and paste the slot IDs into src/ad-loader.js.
Step-by-Step
1. Open AdSense
Go to https://adsense.google.com → Ads → By ad unit → Display ads
2. Create 3 Ad Units
Create each of the following:
Ad Unit A — Banner
- Name:
ADMENSION Banner - Ad shape: Horizontal
- Ad size: Responsive
- Click Create → Copy the slot ID (a number like
1234567890)
Ad Unit B — Rectangle
- Name:
ADMENSION Rectangle - Ad shape: Square
- Ad size: Responsive
- Click Create → Copy the slot ID
Ad Unit C — Vertical
- Name:
ADMENSION Vertical - Ad shape: Vertical
- Ad size: Responsive
- Click Create → Copy the slot ID
3. Paste Slot IDs
Open src/ad-loader.js and find the SLOT_IDS config near the top (~line 28):
const SLOT_IDS = {
BANNER: '', // ← Paste Banner slot ID here
RECTANGLE: '', // ← Paste Rectangle slot ID here
VERTICAL: '', // ← Paste Vertical slot ID here
};Example after pasting:
const SLOT_IDS = {
BANNER: '1234567890',
RECTANGLE: '0987654321',
VERTICAL: '1122334455',
};4. Deploy
Commit, push, and deploy to Netlify.
5. Verify
Open the live site → DevTools Console → Run:
ADMENSION_AD_LOADER.diagnose()
You should see a validation report showing which ads rendered, which were unfilled (normal for new sites), and which failed.
How the 3 Units Map to 21 Containers
The 3 ad units are reused across all pages:
- BANNER →
ad-top-banner,ad-footer-banner,ad-stats-banner,ad-create-banner,ad-create-footer,ad-manage-banner,ad-manage-footer,ad-docs-banner,ad-admin-banner(9 placements) - RECTANGLE →
ad-in-content-tall,ad-stats-tall,ad-create-tall,ad-manage-tall,ad-docs-tall,ad-admin-tall(6 placements) - VERTICAL →
ad-rail-right,ad-stats-rail,ad-create-rail,ad-manage-rail,ad-docs-rail,ad-admin-rail(6 placements, desktop only)
Total: 21 ad containers, all served by just 3 ad units.
Troubleshooting
- "NO SLOT IDs CONFIGURED" in console → You haven't pasted slot IDs yet
- "AdSense script NOT detected" → Ad blocker is active, or AdSense script tag is missing from index.html
- All ads show "unfilled" → Normal for new sites. AdSense needs time to start serving ads (can take 24-48h)
- Placeholder boxes with dashed borders → Slot IDs not configured; see step 3
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
ad-systemdocumentationImprovements or additions to documentationImprovements or additions to documentation