Creating an Ad Unit (Step-by-Step)
Setting up an ad unit is a quick, two-step process.
Step 1: Ad Unit Setup
In this step, you define the properties of your ad unit and the website where it will be placed.
- Ad Unit Details:
- Ad Unit Name: Give your ad unit a descriptive name for your own reference.
- Site Category: Select the category that best describes your website's content (e.g., News & Media, Analytics & Data Platform).
- Website URL: Enter the full URL of the website. This site must pass our verification process before ads can be served.
- Ad Content Restrictions:
- Exclude Ad Topics: You have full control to block ads from specific categories (e.g., Gambling, Memecoins) to ensure all content aligns with your brand.
Step 2: Integration & Code
Once you've configured your ad unit, you'll receive the code to place on your site.
- Your Ad Unit Code: Copy the provided JS code snippet.
- Placement: Paste this code directly into your site's HTML in the exact location where you want the ad to appear.
- Submission: Click Send for Review. Our team will review your website to ensure it meets our quality guidelines. Once approved, ads will begin to serve automatically.
Script Customization Guide
You're in full control of how the ad unit appears and behaves on your site. Just tweak the <ins> tag's attributes to match your design and performance goals.
Styling with style
The style attribute lets you define the ad container's size and layout. Make sure to:
- Set both width and height to match your selected ad size - this ensures banners render correctly.
- Use display: block so the unit behaves like a proper container.
Choosing an Ad Format with data-ad-size
This attribute tells our system which banner format to serve. Use a fixed value to lock in the design:
- square (250×250)
- medium-rectangle (300×250)
- billboard (970×250)
- leaderboard (728×90)
- large-rectangle (300×600)
- skyscraper (160×600)
- mobile-leaderboard (320×50)
- mobile-interstitial (320×480)
These formats are optimized for specific placements across desktop and mobile layouts.
Identifying Your Ad Source with data-ad-client
Important: This is your unique publisher ID. Do not edit or replace this value - it ensures your ad impressions and earnings are tracked correctly.