Table of Contents | ||||
---|---|---|---|---|
|
Overview
This integration guide applies if all ads are delivered by Snigel on a site with a simple page layout.
For this integration guide, we assume the example of a website with the following two ads on every page:
...
Code Block |
---|
<script data-cfasync="false" async src="https://cdn.snigelweb.com/adengine/**site.domain**/loader.js" type="text/javascript"></script>COPYscript> |
Note:
Replace **site.domain** with the actual site domain
Place the script at the very top of the header to ensure the best performance
If Google Analytics is used, place the AdEngine tag after the Google Analytics tag
...
If there are specific pages where only a subset of the ads are shown, it is important to declare the ad tags, that are used in on the current page. If ad tags are not properly declared, ad units will be auctioned, even if not used. This will lead to false ad impressions, negatively affecting page performance and user experience.
You can declare ad units using the snigelPubConf element.
Please remember:
ad-unit-name:
topleaderboard
div-name:
adngin-topleaderboard-0
...
Code Block |
---|
<script data-cfasync="false" type="text/javascript"> window.snigelPubConf = { "adengine": { "activeAdUnits": ["topleaderboard","sidebar"] } } </script> <script data-cfasync="false" async src="https://cdn.snigelweb.com/adengine/**site.domain**/loader.js" type="text/javascript"></script>COPYscript> |
Note:
Replace **site.domain** with the actual site domain
Place the script at the very top of the header to ensure the best performance
If Google Analytics is used, place the AdEngine tag after the Google Analytics tag
Keep the correct order of the tags: first configuration and then loading of AdEngine
...
If the page used other ad-stacks like AdSense or GPT it is important to remove these tags from the page.
Please follow the Page Cleanup and Compatibility Guide.
Body configuration
The page body needs to define <div>
elements that will be filled with ads. They need to be placed where the ad should be displayed.
The <div>
elements should reserve the maximum width and height of the displayed ad to prevent Cumulative Layout Shift (CLS). If you are using ad labeling, reserve an additional 15px of height for the label. To reserve the proper space please consult your account manager to get the exact ad sizes.
For each <div>
element name, provided by your Your account manager , create tags like in the will provide you with all tags, like this example:
Code Block |
---|
<div id="adngin-topleaderboard-0"></div> <div id="adngin-sidebar-0"></div>COPYdiv> |
Note:
If there are existing
<div>
elements that should be reused, provide the information to your account manager.
...
It is recommended to test an AdEngine integration on a staging page first to prevent any problems , and allow your account manager to review the integration before going live on production.
⚠️ If you apply all steps directly on the live page without a review from your account manager, Snigel can`t be held responsible for any revenue loss.
On the staging page, use the staging version of AdEngine, which is accessible on staging-cdn.snigelweb.com
instead of the production version available at cdn.snigelweb.com
.
Code Block |
---|
<script data-cfasync="false" async src="https://staging-cdn.snigelweb.com/adengine/**site.domain**/loader.js" type="text/javascript"></script>COPY |
...
.
Consent management
If you are using AdConsent to manage user consent, there are additional elements required to be compliant with privacy laws.
Please follow the Consent Management Page Integration Guide.