Getting started

Getting started

The goal of the first session: create one ad, place it on a page, confirm impressions and clicks are tracking.

1. Open the admin

OAds in the WP admin sidebar (or under Orravo Core if Core is active). The header has three rows: brand bar, tabs (Manage Ads, Analytics, Zones, Ad Groups, Log, Settings), and the sticky action bar.

Dark/light theme toggle in the top right stores preference in localStorage under oads_theme.

2. Create your first ad

1. Manage Ads -> New Ad.
2. Pick a type:

- image (banner with optional overlay headline)

- text (headline + body + CTA)

- html (raw HTML/script, passes through wp_kses_post)

- video (self-hosted MP4 or YouTube embed)

- sponsored (image + headline + desc + CTA)

- sticky (fixed top/bottom bar with close button)

1. Fill in the type-specific fields (image URL, destination URL, headline, etc.).
2. Set Disclosure label (defaults to Sponsored).
3. Section is the slug used in shortcodes and zones. Use global if unsure.
4. Save.

3. Place the ad on a page

Three options:

• Block editor: insert the OAds block, pick the section.
• Shortcode: [oads section="global" count="1"].
• PHP: <?php oads_show( 'global', 1 ); ?> in your template.

Auto-injection is enabled by default. OAds injects after paragraph 3 and 7 of in-content posts, and into archive grids every N items. Capped at 3 ads per page total.

4. Verify tracking

1. Visit the page in an incognito window. Scroll until the ad is in view.
2. OAds -> Log. An impression row should appear within a few seconds.
3. Click the ad. A clicks row should appear with the destination URL stored as redirect target.

Impressions fire on 50% visibility via IntersectionObserver. Clicks go through /oads-click/{id}/ for server-side logging before redirecting.

5. Review analytics

Analytics tab shows impressions, clicks, CTR, unique IPs, estimated revenue, daily bar chart, per-ad breakdown, by-section table. Time periods: 7d, 30d, 90d, all.