How do I install a static ad unit?_
In order to use AdUp ads on your website, you must have created a page and a corresponding ad unit in your publisher account.
In order for static ads to behave correctly, make sure that the "Type of integration" in the ad unit layout form is set to "Static-Ads".
How it works
The ad media is loaded within an iFrame at the position on your website where you position our embed code or the placeholder HTML container. The size of the iFrame, as well as the number and design of the ads can be freely configured by you via the ad unit layout form in the publisher frontend.
As the name "Static-Ads" implies, the size of the ad is static and therefore should rather be used in the desktop area. However, if you optimize your website for different screen sizes, then we recommend using Responsive-Ads.
Asynchronous (Recommended)
Through the asynchronous integration, your website is loaded independently of the advertising call of our ads. First, you place the desired placeholder HTML elements at the locations on your website where you want ads to appear. Then, our delivery API is loaded once and asynchronously using a dynamic <script> tag. Once the API has finished loading, a global callback function is executed which stores your actual embedding logic.
This type of integration is especially useful if you want to place multiple AdUp ads on your site. Due to the programmatic definition of the ad units, you also have various events available to which you can react accordingly (e.g. "onClick" or "onNoAds").
<!-- 1. Define a HTML placeholder with a unique ID -->
<div id="adup1"></div>
<!-- 2. Load our JavaScript API and replace the placeholder with
the placement in the callback as soon as the API is available -->
<script type="text/javascript">
window.uAd_init = function() {
window.uAd.embed("adup1", {
param1: "value1",
param2: "value2"
...
});
};
if (typeof window.uAd === "object") window.uAd_init();
else (function(d, t) {
var g = d.createElement(t), s = d.getElementsByTagName(t)[0];
g.src = "https://s.d.adup-tech.com/jsapi"
g.async = true;
s.parentNode.insertBefore(g, s);
}(document, "script"));
</script>Synchronous
With synchronous integration, a <script> tag is specified directly at the position on your website where the advertising material should appear. When your website is loaded, the script is then executed automatically (synchronously) and creates an iFrame with our ads at the corresponding position.
This is the easiest way to integrate AdUp ads. However, due to the definition of the ad unit via URL parameters, not all options are available to you here in contrast to the asynchronous integration.
<!-- Your desired placement will appear on your website at the location
where you place this script -->
<script type="text/javascript"
src="https://s.d.adup-tech.com/ads/display.js?param1=value1¶m2=value2...">
</script>Optional parameters
| Name | Description | Example |
|---|---|---|
| responsive | Activates the Responsive-Ads feature for the placement.
| |
| query | Keywords by which the ads should be filtered. Multiple keywords can be separated by a semicolon.
| |
| pageurl | The current URL of the page on which the advertisement is played. Should always be set if our ads are embedded within one or more nested iFrames, so AdUp may then no longer be able to determine the correct url.
| |
| skip | Number of ads to be skipped during delivery. This is useful if you have multiple placements on your page and want to avoid duplicate or repetitive ads.
| |
| mincpc | This is the minimum price you want to earn for a click. Generally, the lower the minimum price, the more campaigns you will be presented with and the more money you can earn due to greater competition for the position.
| |
| lazy | Activates the "Lazy Loading" feature. This means that the ad will only be loaded (and thus the impression will only be tracked) as soon as it is visible for the user.
| |
| lazyoffset | By default, "lazy loaded" ads are only displayed when they gets visible for the user. The “lazyoffset” option allows you to define an additional offset (in pixels). This means that the ads load a little earlier, as soon as they come “close” to the visible area.
| |
| colormode | By default, the color mode used for placements is based on the user-defined color scheme of the operating system (Light/Dark) – not on the design mode of the respective website. If a website does not support native dark mode, a placement configured specifically for this mode may appear visually inappropriate on a light page. Here you have the option to force a color mode:
| |
| placeholdervalues | Values for dynamic ads placeholders can be transferred here. | |
| flyin | Activates the "Fly-In-Ads" feature for the ad unit. For more information and options, see the Fly-In Ads documentation. | |
| adtest | Impressions and clicks are not tracked when activated. Should only be used for test purposes!
| |
| gdpr | Usually, AdUp determines the required GDPR information automatically using the TCF API built into the website. If this is not available, or if it is not possible to use it for technical reasons, you have the option to manually provide the GDPR data.
| |
| gdpr_consent | Usually, AdUp determines the required GDPR information automatically using the TCF API built into the website. If this is not available, or if it is not possible to use it for technical reasons, you have the option to manually provide the IAB consent string (base64url-encoded).
|