Clickio Tags Implementation Guide
Correct implementation of Clickio tags is essential for ensuring that ads display properly, run smoothly, and generate maximum revenue. This guide explains how to insert ad codes on your site or app, configure options, and test the integration.
Before You Start
Ensure the Clickio Header Code is present on your site pages. Example:
<script async type="text/javascript" src="//s.clickiocdn.com/t/123456/360_light.js"></script>
You can find the correct header code for your site in the Clickio Publisher Platform. Always exclude Clickio scripts from caching/minification plugins to avoid display issues (full instructions).
Implementation Tab
When you create an ad unit, the Implementation tab provides the codes and integration methods. It includes three sub-tabs:
-
On-Page Code: copy/paste ad unit code directly into your website’s <body> section. Best for sites managed manually or with CMS templates.
- Google Ad Manager: instructions and line items for inserting Clickio units inside GAM. Recommended for publishers who manage inventory through GAM.
- Google Tag Manager: pre-configured tags for deploying Clickio codes via GTM. Recommended if your site already uses GTM for tracking and ads.
Ad Unit Insertion Methods
1. Direct On-Page Insertion
-
Available via the On-Page Code sub-tab.
- Insert the code manually into your HTML structure.
- Formats like Smart Banner, Horizontal Sticky, Interstitial, Splashscreen don’t require a fixed placement — they can be added anywhere inside <body>.
2. Auto-Insertion (by Clickio Team)
-
Not available in the interface.
-
Automates placement of ad units using client-side JS logic.
- Requires only the header code on pages. Contact Clickio Support at support@clickio.com or your Account Manager to enable.
3. Single Page Applications (SPA)
-
SPA websites require special routing event setup.
-
Ad codes must reload on each “virtual page view” for ads to display correctly.
- More details: Web SPA Tags Implementation Guide.
Clickio Code Placement Recommendations
- Place the header code inside <head> for optimal performance.
- Place ad unit code inside <body> where ads should appear.
- Avoid caching/minification (e.g., WP Rocket, Cloudflare). Follow this WP Rocket exclusion guide.
Ad Unit & Site Options
Available in the Platform:
-
Create/delete ad units
- Pause/resume ad units
-
Select device targeting (Desktop + Tablet / Mobile)
- Set rendering for unfilled inventory
Require Support Assistance:
-
Frequency caps, size adjustments, URL targeting
-
Horizontal Sticky: disable close button, set offsets, top/bottom placement
-
Splashscreen: timers, auto-close
-
Smart Banner: CSS selectors, max number, spacing rules
- Floater & Vertical Sticky: scroll/offset configuration
Debugging & Testing Tools
-
Image stubs → use
?lx_debug_pb_show_stubs=1
to test placement with Clickio logos instead of live ads.
-
Debug Mode → enabled by Clickio team. Trigger with
?show_debug_units=1
or?show_debug_units=adunit_id
. - Chrome DevTools → analyze ad script loading and resolve errors.
For App Developers
If you are adding Clickio ads to a mobile app (Android or iOS), the setup is different from web integration.
1. Use the SDK
- Install the official SDK for Android/iOS to make sure ads load correctly and are tracked.
- The SDK supports banners, sticky ads, interstitials, rewarded ads, and video formats.
2. Initialization
-
Add your App ID and Ad Unit IDs, which will be provided by the Clickio Technical Team.
- Make sure initialization runs when the app starts.
3. Ad Placement
4. Testing Ads
- Use the test ad units from the Clickio Technical Team.
- Check requests with logcat (Android) or Xcode console (iOS).
5. Best Practices
-
Don’t overload your app with ads, keep a good user experience.
- Follow Google Play and App Store ad policies.
- Always use the latest SDK version for best performance and compliance.
Frequently Asked Questions (FAQ)
1. Do I need to install the Clickio header code on every page of my site?
No. The Clickio header code only needs to be added once in the <head> section of your site. This ensures all ad units work properly.
2. Where should I place the ad unit code on my site?
The ad unit (body) code should be placed between the <body></body> tags on the pages where you want ads to appear. For auto-insert formats like Smart Banner, Sticky, Interstitial, or Splashscreen, the placement is handled automatically.
3. Can I use Google Ad Manager or Google Tag Manager instead of inserting code directly?
Yes. The Implementation tab in the Clickio Platform provides instructions for:
-
On-Page Code (manual placement),
-
Google Ad Manager,
-
Google Tag Manager.
Choose the method that best fits your site setup.
4. What should I do if my ads are not showing?
-
Check if the header code is correctly added.
-
Make sure caching or optimization plugins (e.g., WP Rocket) are not blocking or minifying Clickio scripts.
-
Confirm that your ads.txt (for websites) or app-ads.txt (for apps) file is present and includes all required Clickio lines.
-
If you have EU/UK traffic, ensure a CMP (Consent Management Platform) is installed and properly configured for GDPR/TCF compliance.
-
Use debug parameters like
?lx_debug_pb_show_stubs=1
to test ad placements.
5. Are Clickio ad formats mobile-friendly?
Yes. Most ad formats are responsive and support device targeting (Desktop, Tablet, Mobile). We recommend creating separate ad units for desktop & tablet and for mobile.
6. I use a Single Page Application (SPA). How should I integrate Clickio tags?
For SPAs, ensure ad codes are triggered on routing events so ads reload correctly when users navigate between pages.
7. Can I implement Clickio ads in my mobile app?
Yes. For apps, you’ll need the SDK (Android/iOS). It supports banners, sticky ads, interstitials, rewarded ads, and video ads. Contact support@clickio.com for the latest SDK guide and test credentials.
8. Will Clickio ads affect my site speed or Core Web Vitals?
Clickio tags are optimized for performance. To avoid issues, always:
-
Place the header code in <head>.
-
Exclude Clickio scripts from caching/minification.
- Keep your integration updated according to this Clickio Tags Implementation Guide.