Skip to main content

Creative Setup

1. Overview​

This guide provides instructions for publishers and media owners to integrate Frolics.Digital demand into their existing ad stacks. Our "Edge Loader" technology ensures high-speed delivery, professional masking, and seamless compatibility with all major ad serving platforms.

2. Implementation: Third-Party Tag (Ad Server)​

Most publishers traffic Frolics demand as a Third-Party HTML Creative. Use the following configuration within your ad server (OpenX, Revive, Xandr, etc.) to begin delivery.

Placement Details​

  • Inventory Type: [Display]
  • Creative Type: HTML / Custom Script
  • Format: [Size, e.g., 300x250]

The Frolics Edge Tag​

Copy and paste this code into your ad server's creative field:

<div id="frolics-ad-[Unique-ID]" style="width:[Width]px; height:[Height]px; margin:0 auto; text-align:center;">
    <script>
        (function () {
            // 1. Placement Configuration
            var adConfig = {
                "type": "banner",
                "adUnit": "[Frolics-Placement-Path]", // Managed by Frolics CMS
                "divId": "frolics-ad-[Unique-ID]",
                "sizes": [[ [Width], [Height] ]],
                "clickTracking": "%%CLICK_MACRO%%" // Replace with your ad server's click macro
            };

            // 2. Initialize Frolics Edge Loader
            window.adNovaQueue = window.adNovaQueue || [];
            window.adNovaQueue.push(adConfig);

            if (!window.adNovaLoaded) {
                window.adNovaLoaded = true;
                var script = document.createElement('script');
                script.src = 'https://assets.frolics.digital/adserver/v1.1.1/adunit-loader.min.js';
                script.async = true;
                (document.head || document.documentElement).appendChild(script);
            }
        })();
    </script>
</div>

3. Advanced Tracking Configuration​

To ensure synchronization between your local reporting and the Frolics.Digital Dashboard, please utilize your ad server's native macros within the clickTracking parameter.

Your Ad ServerClick Macro to Use
Google Ad Manager (GAM)%%CLICK_URL_ESC%%
OpenX{clickurl}
Revive Adserver{clickurl} or [clickurl]
Xandr / AppNexus${CLICK_URL_ESC}

4. Technical Specifications​

Universal Compatibility​

The Frolics Edge Loader is designed to be environment-aware. It automatically detects if it is being served within an iFrame or a SafeFrame and adjusts its delivery protocol to ensure the creative renders correctly without "breaking out" of your layout.

Layout & Performance​

  • Zero-Latency Loading: Our scripts are hosted on a global CDN and load asynchronously to ensure your page's "Time to Interactive" is never delayed.
  • CLS Protection: Every Frolics container uses pre-defined dimensions to prevent layout shifts, maintaining your site’s SEO health and user experience.
  • Cache Management: The delivery system handles all cache-busting internally. No manual timestamp macros are required in the script source.

Reporting​

Real-time metrics for impressions, clicks, and fill rates are available 24/7 via your Frolics.Digital Publishers Portal.