AdEngine Setup Overview
- Nelson Pina
- Reinhard Steiner
Setup Overview
To setup Snigel AdEngine only three steps are required:
Page Head Configuration
Page Body Configuration
Ads.txt Configuration
Your account manager will provide you with a document containing all necessary tags to add to your page, in order to get AdEngine running.
The following steps give an overview of how to set up and add the tags to the page. After reading the overview, follow the detailed integration guide that matches the page setup.
Head Configuration
The head section modifications are the fundamental part of the integration. Without adding AdEngine's script and configuration to the head, the ads won't render.
To have an optimized and effective setup to bid on the site, a few code tags need to be implemented as outlined below.
Configure AdEngine
AdEngine's initial configuration must be defined before its script is loaded. It is used to configure page-specific settings, like available ad tags or publisher ad tags. If no page-specific configuration is required, this section can be skipped.
If your site has different page layouts with different amounts of ad tags, it is important to declare the ad tags, that are used in the current page, in the configuration section. If ad tags are not properly declared, ad units will be auctioned but remain unused. This will lead to a false ad impression, negatively affecting page performance and user experience.
Otherwise, if you use the same ad tags on every page, an automatic auction without ad tag declaration is fine.
Load AdEngine script asynchronously
When the page configuration is applied the AdEngine script is loaded and will automatically start the auction and ad delivery.
AdEngine includes and loads AdConsent, the Snigel IAB-certified Consent Management Platform (CMP), and will manage consent for the users affected by consent laws like GDPR and CCPA.
AdEngine is compatible and can be used with any IAB-certified CMP. If there is already an IAB-certified CMP available, it needs to be loaded synchronously before AdEngine and it will be automatically used to process consent.
Body configuration
The body configuration is the easy part. Create ad tags where the ads should be displayed. It is recommended to reserve the maximum size for the ad to prevent Cumulative Layout Shift.
Ads.txt configuration
Please follow the Ads.txt Implementation Guide.
Use cases
Follow the use case that matches the current setup of the site.