Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 12 Next »


Introduction

Adding Verve ad tags to your mobile application is quick and easy.

We support three kinds of integration

  • We offer an SDK for integration into your mobile apps
  • We offer server-side integration via an API
  • We offer javascript ad tags for integrating into Mobile WAP/Web sites.

SDK Integration

Talk to your publisher services representative for access to our SDK.

Server-Side Integration

Our AdCel API provides a server-side method of integrating with publishers.

Talk to your publisher services representative for provisioning of your production service on our API.

Mobile WAP/Web Integration

Mobile WAP/Web Integration is the simplest form of integration that Verve Wireless supports.

Verve has two kinds of tags that you may use for your integration.

The first is a simple call to a hosted javascript file. It looks like this:

<script type="text/javascript" src="http://adcel.vrvm.com/adtag.js?c=999&b=sampletag&p=ptnr"></script>

This is a simple wrapper for the actual Verve tag, which looks similar to this:

<script type='text/javascript'><!--//<![CDATA[
var m3_u = 'http://adcel.vrvm.com/adtag.js';
var m3_r = Math.floor(Math.random() * 99999999999);
var category="999";  // use 999
if (!document.MAX_used) document.MAX_used = ',';
document.write("<scr" + "ipt type='text/javascript' src='" + m3_u);
document.write("?c=" + category +"&b=sampletag&p=apcl&key=946c33cd0666143eea9edf7c555772fa");
document.write('&cb=' + m3_r);
if (document.MAX_used != ',') document.write("&exclude=" + document.MAX_used);
document.write(document.charset ? '&charset=' + document.charset :
(document.characterSet ? '&charset=' + document.characterSet : ''));
document.write("&loc=" + escape(window.location));
if (document.referrer) document.write("&referer=" + escape(document.referrer));
if (document.context) document.write("&context=" + escape(document.context));
if (document.mmm_fo) document.write("&mmm_fo=1");
document.write("'><\/scr" + "ipt>");
//]]>--></script>

For normal client-side integration, simply insert your Verve Ad Tag where you want your ad to appear.

In general, Verve prefers you to use the actual verve tag as opposed to the simplified Javascript wrapper tag because it will incrementally reduce latency of ad serving to host the tag directly on your page.

For a client-side integration using DFP Mobile, some minor changes should be made.

Required parameters

There are three parameters that are required in every tag.

Unknown macro: {table-plus}

Parameter

Name

Description

p

Portal keyword

Portal keyword. This is a Verve-assigned value identifying the distribution portal on which the advertisement is being displayed. In most cases, a mobile website accessed directly using the publisher's hostname is on the default portal (keyword: "def"). The portal will change if the site is accessed through a mobile carrier's "deck". Mobile client applications are typically segregated by platform (e.g., iPhone, BlackBerry, Windows Mobile, etc.) using portals.

b

Partner (publisher) keyword.

This is a Verve-assigned value identifying the publisher of the mobile content. Note that there's a one-to-one relationship between a mobile site and a publisher. For example, for the Daily Planet's mobile site, the partner keyword might be "dailyplanet".

c

Content Category

Content category ID. This is an integer which identifies the type of content available on the page for which an ad is requested. For example, a page of sports news will have one category ID, while a page of movie reviews will have another.

 

If you set the "category" variable to a value in our Ad Category Codes this provides us with metadata about the content type for the impression that allows us to serve higher value ad inventory. A list of acceptable category values can be found in the AdCel API.

Optional Parameters

If you are able to pass us additional information such as postal code, visitor demographic information or visitor latitude/longitude, speak with your publisher services representative about how to customize your tag to pass this data. Simply appending the parameters you wish to pass in standard query string format (i.e. "&parameter1=value&parameter2=value") will send that information to Verve. For a list of available parameters, read more here: AdCel API

For example, if you have an application that gathers lat/long from its users and you wished to share that data with Verve to improve your monetization, if you were using the hosted javascript file, it might look like this:

<script type="text/javascript" src="http://adcel.vrvm.com/adtag.js?c=999&b=sampletag&p=ptnr&lat=<INSERT_LAT_HERE>&long=<INSERT_LONG_HERE>"></script>

Testing and Certification

To create a tag that returns a banner every time, the following values should be used:

  • b=sampletag
  • p=ptnr
  • c=999

By changing the category ("c") to "888", you will get a Celtra rich media banner rather than a static image. Using this, you can test a wide range of possible Verve responses.

Ad Formats and Size

The Verve Ad Tag will automatically sense the device requesting a page and serve an appropriately sized advertisement. Generally, Verve Ad Tags comply closely with MMA specifications and come in the following sizes:

  • 320x53
  • 320x50
  • 300x50
  • 216x36

The supported formats are .jpg, .gif, and .png.

Interstitial Inventory

If you wish to display interstitial ads or have interstitial units today and would like Verve to show interstitial ads into it, please speak with your publisher services representative.

Passbacks

By default, if there was no ad available for the request, a zero-byte HTTP 200 response will be returned. Here is a sample of the headers:

Server: Apache-Coyote/1.1
Content-Type: text/plain
Transfer-Encoding: chunked
Date: Wed, 24 Sep 2008 20:44:40 GMT
200 OK

If you have a roll-over tag that you would prefer us to use, give that tag to your Verve publisher services representative and Verve will integrate that on your behalf. Verve works with many third party advertising networks - please make sure you let your Verve publisher services representative know whether you would like the benefit of these advertising partners looking at inventory before we pass the ad back to you. Adding Verve ad tags to your mobile application is quick and easy.

  • No labels