Skip to content

Latest commit

 

History

History
417 lines (286 loc) · 18.1 KB

publisher-display-reference.md

File metadata and controls

417 lines (286 loc) · 18.1 KB

Integration - Online Desktop & Mobile Advertisement

Table of Contents

Introduction

This document describes the necessary steps for integrating online advertisements on desktop and mobile websites for Axel Springer. The delivery of ads utilizes a "One Call" function, which have to be included in the <head> part of the websites. This will receive the booked campaigns and will let them in the background for lately rendering. The Ad Placements are <div>'s which have to be placed in the wished position for the ad. All Advertisements can be managed via Appnexus.

Overview

In the following you will find an overview of the necessary components which must be implemented to deliver and display the advertising media.

Ad Integration

Elements in the <head> of the website:

<script type="text/javascript">

1. Set the viewport of the website. Use for desktop "d" and for mobile "m"

adSSetup = {view: "[View]", // has to fit the design of the page, please use m for mobile and d for desktop

2. Switch for the 3th party scripts. We strictly recommend to set it as "false" only on pages for directsales campaign only the max out the revenue

partners: true,

3. Define the ad placements for the website

Desktop:

adPlacements: ["superbanner","sky","billboard","mrec","mrec_btf","mrec_btf_2","mrec_btf_3","inpage"],

Mobile:

adPlacements: ["banner","mrec","mrec_btf","mrec_btf_2","mrec_btf_3","inpage"],

For Desktop:

Mandatory:

  • superbanner
  • sky
  • billboard
  • mrec
  • inpage

Optional

  • billboard_btf
  • mrec_btf
  • sky_btf

For Mobile:

Mandatory:

  • banner
  • mrec
  • inpage
  • mrec_btf

Optional

  • banner_sticky

_You can repeat the btf placements as much as you want. Please use the following schema:

Example for 3 Medium Rectangle btf

  • mrec_btf
  • mrec_btf_2
  • mrec_btf_3

4. Define the sizes for every ad placement:

Desktop:

	adSlotSizes: {
		"superbanner": [{
			"minWidth": 1,
			"sizes": [[728,90],[728,600],[1000,600]]
		}],
     
		"sky": [{
			"minWidth": 1,
			"sizes": [[160,600],[120,600],[300,600],[500,1000],[1000,1000]]
		}],
     
		"billboard": [{
			"minWidth": 799,
			"sizes": [[800,250]]
		},{
			"minWidth": 969,
			"sizes": [[970,250],[800,250]]
		}],
     
		"mrec": [{
			"minWidth": 1,
			"sizes": [[300,250],[300,600]]
		}],
     
		"mrec_btf": [{
			"minWidth": 1,
			"sizes": [[300,250],[300,600]]
		}],
     
		"mrec_btf_2": [{
			"minWidth": 1,
			"sizes": [[300,250],[300,600]]
		}],
     
		"mrec_btf_3": [{
			"minWidth": 1,
			"sizes": [[300,250],[300,600]]
		}],
     
		"inpage": [{
			"minWidth": 1,
			"sizes": [[1,1],[640,360],[1000,300]]
		}],
     
	},

Mobile:

	adSlotSizes: {
		"banner": [{
			"minWidth": 1,
			"sizes": [[320,50],[320,75],[320,80]]
		}],
     
		"mrec": [{
			"minWidth": 1,
			"sizes": [[300,250],[320,50],[320,75],[320,160],[300,300]]
		}],
     
		"mrec_btf": [{
			"minWidth": 1,
			"sizes": [[300,250],[320,50],[320,75],[320,160],[300,300]]
		}],
     
		"mrec_btf_2": [{
			"minWidth": 1,
			"sizes": [[300,250],[320,50],[320,75],[320,160],[300,300]]
		}],
     
		"mrec_btf_3": [{
			"minWidth": 1,
			"sizes": [[300,250],[320,50],[320,75],[320,160],[300,300]]
		}],
     
		"inpage": [{
			"minWidth": 1,
			"sizes": [[1,1],[640,360],[1000,300]]
		}],
     
	}
}

Ad Sizes for every placement:

For Desktop:

Placement Size 1 Size 2 Size 3 Size 4 Size 5
superbanner [728,90] [728,600] [1000,600]
sky [160,600] [120,600] [300,600] [500,1000] [1000,1000]
billboard [970,250] [800,250]
mrec [300,250] [300,600]
inpage [1,1] [640,360] [1000,300]

For Mobile:

Placement Size 1 Size 2 Size 3 Size 4 Size 5 Size 6
banner [320,50] [320,75] [320,80]
mrec [300,250] [320,50] [320,75] [320,80] [320,160] [300,300]
inpage [1,1] [640,360] [1000,300]

5. Page configuration

	colorBg: true, // enable/disable coloring of the page-background
	bgClick: true, // enable/disable click on page-background
	stickySky: true, // enable/disable stickiness for skyscraper
	pageName: "demo_story", // channel/article name from CMS
       	target: "value1;value2;value3;key1=value1,value2;key2=value1,value2;"
}

We recommend the following schema for pageName:

  • Home Site --> "home_index"
  • Channel, e.g. sport --> "sport_index"
  • Sub-Channel e.g. soccer --> "sport.soccer_index"
  • Article e.g. soccer article --> "sport.soccer_story"

target: Every editorial keyword or custom target

  • you can use stand alone keywords with semicolon ; separately
  • key/values are also supported. key=value1,value2;
  • please ensure to end the line with a semicolon

</script>

6. AdLib

<script type="text/javascript" src="https://acdn.adnxs.com/as/1h/pages/mywebsite.js"></script>

This js contains the whole Ad Library. Every website will get its own js from Axel Springer.

</head>

Ad Placements in the <body> of the website:

<div id="${adPlacement}"></div>

This div has to be wrapped in an own container, has to be free of Styles/CSS and the div id must be the name of the placement. See from line 24 of this document.

Example

Superbanner

<div id="superbannerWrapper" class="container"><div id="superbanner"></div></div>

</body>

Ad Placements Overview

Display

superbanner

<div id="superbanner"></div>

superbanner

This placement should be positioned at the top of the web page. Wallpapers and fireplaces are also delivered via this placement. These sizes must be used.

superbanner | [728,90] | [728,600] | [1000,600]

sky

<div id="sky"></div>

sky

This placement is to be positioned on the left side of the website content. Sitebars, dynamic sitebars, and double-dinamic sitebars are also delivered via this placement. These sizes must be used.

sky | [160,600] | [120,600] | [300,600] | [500,1000] | [1000,1000]

billboard

<div id="billboard"></div>

billboard

This placement is to be placed directly under the navigation or under the first teaser of the website. These sizes must be used.

billboard | [970,250] | [800,250]

mrec

<div id="mrec"></div>

mrec

We recommend to place the first Mrec above the fold (ATF). These sizes must be used.

mrec | [300,250] | [300,600]

inpage

<div id="inpage"></div>

inpage

Interstitials, Understitials, and InText-Outstream Advertising Materials are delivered through the inpage Placement. This placement is to be placed in the position requested by the publisher for InText- Outstream ads. These sizes must be used.

inpage | [1,1] | [640,360] | [1000,300]

Mobile

banner

<div id="banner"></div>

banner

This placement should be positioned at the top of the web page. These sizes must be used.

banner | [320,50] | [320,75] | [320,80]

mrec

<div id="mrec"></div>

mrec

We recommend to place the first Mrec above the fold (ATF). These sizes must be used.

mrec | [300,250] | [320,50] | [320,75] | [320,80] | [320,160] | [300,300]

inpage

<div id="inpage"></div>

inpage

Interstitials, Understitials, and InText-Outstream Advertising Materials are delivered through the inpage Placement. This placement is to be placed in the position requested by the publisher for InText- Outstream ads. This sizes must be used.

inpage | [1,1] | [640,360] | [1000,300]

mrec_btf

<div id="mrec"></div>

mrec_btf

This placement can be placed multiple times on a page. We stron recommend to place one mrec_btf after 3 blocks of text. Please use the following schema

  • mrec_btf
  • mrec_btf_2
  • mrec_btf_3

This sizes must be used.

mrec | [300,250] | [320,50] | [320,75] | [320,80] | [320,160] | [300,300]

Creative Sizes Reference

Each Size belongs to a certain creative. For standard creatives we use the IAB standards.

Size Creative IAB Preview
728,90 Superbanner/Leaderboard YES superbanner
728,600 Wallpaper NO wallpaper
1000,600 Fireplace NO fireplace
120,600 / 160,600 Skyscraper/Wide Skyscraper YES sky
500,1000 Sitebar / Dynamic Sitebar NO sitebar
1000,1000 Double Dynamic Sitebar NO ddsitebar
970,250 / 800,250 Billboard YES billboard
320,50 Mobile Banner 6:1 YES banner
320,75 / 320,160 Mobile Banner 4:1, 2:1 NO banner
300,300 Premium Content Ad / 1:1 NO banner
1,1 Interstitial / Layer NO layer
640,360 InText Outstream NO intext
1000,300 Understitial NO understitial

QA and Testing

Please don't try to test ads on Localhost. Ads will be not delivered on localhost.

Anti - Blacklisting Chrome Plugin

Appnexus blocks clients or ip-address that make too many ad requests on a determined placement or in a too short time interval. For it is strongly recommended that before you start testing, to change the browser headers.

We recomend to use the browser plugin modheaders:

https://chrome.google.com/webstore/detail/modheader/idgpnmonknjnojddfkpgkljpfnnfcklj?hl=de

After installing the plugin please insert the following Request Header: 'X-Is-Test:1'

Test Ads

Test Ads for standard placements

In order to get test advertising please open the following URL at first, it will turn on the test ads for 30 days. Please be sure that your browsers accepts 3th party cookies.

https://adtechnology.axelspringer.com/testads.html

Test Ads for special placements

If your website hast special placement f.e. Teaser, multilinks, etc., please contact [email protected] to get the test-instructions.