Follow

Mobile Banner Tag Integration

 
Did you know? 
Publishers using the AerServ SDK have seen a 795% improvement in Fill Rate and 286% more Revenue when compared to S2S connections. Try the SDK >>

 

Overview

The AerServ mobile banner tag is intended for publishers that would like to integrate banner ads into their mobile properties, and are not able to integrate the AerServ SDK. The mobile banner ad tag is a small piece of JavaScript code that displays a mobile banner ad.

Ad Tag Types

AerServ offers multiple mobile banner ad tag types outside of the SDK.  We strongly recommend publishers integrate via JavaScript to fully maximize their revenue opportunities. 

Example JavaScript Tag

 <script src="//ads.aerserv.com/as/?plc=xxxx&key=1&cb=&adid=&lat=&long=&dh=&dw="></script>

 

Example Iframe Tag

320x50

 <iframe src="//ads.aerserv.com/as/?plc=XXXX&key=2&cb=&lat=&long=&url=&ua=&ip=&locationsource=&age=&yob=&gender=&mraid=&coppa=" frameBorder="0" border="0" scrolling="no" width="320px" height="50px"></iframe>

 300x250

 <iframe src="//ads.aerserv.com/as/?plc=XXXX&key=2&cb=&lat=&long=&url=&ua=&ip=&locationsource=&age=&yob=&gender=&mraid=&coppa=" frameBorder="0" border="0" scrolling="no" width="300px" height="250px"></iframe>

 320x480

 <iframe src="//ads.aerserv.com/as/?plc=XXXX&key=2&cb=&lat=&long=&url=&ua=&ip=&locationsource=&age=&yob=&gender=&mraid=&coppa=" frameBorder="0" border="0" scrolling="no" width="320px" height="480px"></iframe>

 

For publishers using a third party SDK, we do not allow iFrame tags to be used. JavaScript tags must be used.

Integration Options

AerServ offers multiple mobile banner integration options outside of the SDK. 

Direct on Page

Publishers not using an adserver have the option of trafficking the mobile banner tag directly within the page code of their mobile website or app.  This is not the suggested or ideal integration as the publisher will have less control over delivery.

Adserver

The mobile banner code can also be placed within an adserver to give the publisher additional flexibility, but testing needs to be done to ensure it works properly within your adserver.

PLC

The JavaScript code provided to each publisher contains a Placement (PLC) number that is unique to each publisher account and has ad campaigns assigned just for their site.  A PLC is a unique ID that is used to retrieve ads for a particular site and placement created within the AerServ platform.  Your PLC can be found within the Inventory section of the AerServ platform. Please reach out to your Account Manager with any questions regarding your PLC or how to obtain it.

Passback Tags

In the event that AerServ cannot fill a banner request, we are able to "pass back" the impression to your adserver via a "passback tag".  This is a recommended step as it allows AerServ to send the ad request back to the publisher, allowing the publisher to monetize the request somewhere else within their system.  Please contact your Account Manager for help setting up passback tags.

Macros

Keys=Macro are separated by "&" in the ad tag URI. And should be placed after the "key" key=value

 

It is important that each publisher using a third party adserver notifies AerServ regarding the macros they are able to populate and pass through.

If integrating at the tag level, please replace our internal macros with your server macro's.

Key Parameter Definitions

Name
Key
Scope
Mobile Web /App Integration
Description
age age optional

Both

age demographic information ie.  age=22
Cachebuster cb required

 Both

Timestamp or unique value to differentiate requests
Click clk optional  Both click macro allows you to track clicks on third party creatives ** not available for all placements or campaigns - (click macro needs to be encoded when sent in the query string)
Coppa coppa optional Both coppa compliance of app (1=compliant, 2=not coppa compiant) ex. coppa=1
Advertising ID adid required

App

IDFA - iOS

Advertising ID - Android

Network network optional - strongly recommended

App

Wifi, 3G, 4G
gender gender optional

Both

gender demographic information ie.  gender=male
Carrier carrier optional - strongly recommended

App

Att, Verizon
Lat lat optional - strongly recommended

Both

Latitude of device location
Long long optional - strongly recommended

Both

Longitude of device location
Location Source locationsource optional

Both

Values: 1 or 2 - Origination of Lat/Long values - 1 = GPS, 2 = Derived from IP
IP ip optional - strongly recommended

Both

IP of end user's device
Custom 1 ctm1 optional

Both

custom value pub would like to pass
Custom 2...etc through custom 10 ctm2 optional

Both

custom value pub would like to pass
App Name appname optional - strongly recommended

App

app name placement is running on
Base Domain Site URL siteurl optional - strongly recommended

Web

Base domain of website. Example: www.aerserv.com
Device Make make optional - strongly recommended

Both

Apple Inc.
Device Model model optional - strongly recommended

Both

iPhone
Device OS os optional - strongly recommended

Both

iOS
Device OSV osv optional - strongly recommended

Both

5.0.0
Device Type type optional - strongly recommended

Both

Phone, Tablet
User Agent ua optional - strongly recommended Both encoded user agent of end user (user agent needs to be encoded when sent in the query string)
Cell Carrier carrier optional Both Cell Carrier - i.e. Verizon
MRAID  mraid optional Both MRAID Flag (1=allow MRAID, 0=do not allow) ex. mraid=1
year of birth yob optional Both yob demographic information - ex. yob=1985

Headers:
If sending an IP through the ad request parameter (i.e. http://ads.aerserv.com/as/?plc=[PLACEMENT]&key=2&ip=xxx.xx.xxx), make sure the same IP value in the ad request parameter is contained in the request headers for the IP

 

 

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments