Simplified URL tags for mobile

You can use simplified URLs in the following cases:

  • Environments where devices don't support JavaScript tags.
  • As redirects for trafficking on other ad servers.
  • Applications where an SDK is not provided, such as BlackBerry.

Simplified URLs follow this format:

  • For non-SSL: http://pubads.g.doubleclick.net/gampad/request-type?parameters
  • For SSL: https://pubads.g.doubleclick.net/gampad/request-type?parameters
Simplified URLs have some limitations:
  • They do not work with AdSense, Ad Exchange or AdMob dynamic allocation.
  • They don't support the use of cookies in applications. Therefore audience tracking, frequency capping and creative rotation won't work with in-app ads.

The sections below describe the contents of the request-type and parameters sections of these URLs.

Request types

DFP supports the following values for the request-type section of the URL.

Request type Description
ad If the request URL contains /ad, the ad server returns an image creative or an internal redirect to an image creative.

Only used for creatives that are images or redirect to images. If there is any customised code (HTML, XML etc.) nothing will be returned for this call.
jump If the request URL contains /jump, the ad server logs an ad click and returns a redirect to the landing page of the creative.
adx Returns the raw code of the creative trafficked in DFP.

Parameters

DFP supports the following values for the parameters section of the URL.

Parameter Request type Required Description
iu ad
jump
adx
required The code of the ad unit of the DFP network. To include multiple-level ad units, use the slash (/) as a separator between different levels.

To include several ad units, use the pipe (|) character as a separator between them.

Examples:
iu=1234/Europe|1234/Americas/US
iu=1234 for a RON
sz ad
jump
adx
required Creative size specification. To include multiple sizes, use the pipe (|) character as a separator between them.

Examples:
sz=320 x 50 for a single size
sz=320 x 50|300 x 50 for multiple sizes
t ad
jump
adx
optional Slot-level customised targeting that represents key-value pairs. Each key and value is separated by the equal sign = character; key-value pairs are separated by the ampersand & character. Each key and value should be URL encoded individually and then the entire string should be URL encoded. For example:

t=genre%3Daction%26film=Mr+%2526+Mrs+Smith would assign the key "genre" to the value "action" and the key "film" to "Mr & Mrs Smith". (Note that the & is singly encoded to %26 where it separates the key-value pairs and doubly encoded to %2526 when it occurs within a value).

Furthermore, the following characters are not permitted in keys or values: " ' ! + # * ~ ; ^ ( ) < > [ ] = . So for example, the query t=a%3Db%252Bc (setting the key "a" to the value "b+c") will not work. Spaces are allowed in values (escaped as %20 or +) but not in keys.

c ad
jump
adx
required Correlator/cache-busting parameter. This is a random number (can only include 0-9; letters are not permitted) that's used to ensure that a fresh call to the ad server happens every time the page loads, avoiding discrepancies in impression counts. Ad requests work without the correlator/cache-busting parameter, but omitting this parameter can lead to under-counting of impressions, negatively affecting both the advertiser/client and the publisher websites.

Example:
c=123456789
m adx optional Set the mime-type value on the HTTP header to a desired value.

Examples:
m=text/wml
m=text/oml
submodel ad
jump
adx
optional Mobile device hardware information (model), which overrides the automatic detection carried out by the ad server.

Example:
submodel=iPhone4,1

Possible submodel values are listed below. Note that you must encode the submodel value, so iPhone1,1 would be iPhone1%2C1.
  • iPhone (first gen): iPhone1,1
  • iPhone 3G: iPhone1,2
  • iPhone 3GS: iPhone2,1
  • iPhone 4 (GSM): iPhone3,1
  • iPhone 4 (GSM): iPhone3,2
  • iPhone 4 (CDMA): iPhone3,3
  • iPhone 4S: iPhone4,1
  • iPhone 5 (GSM and LTE): iPhone5,1
  • iPhone 5 (CDMA and LTE): iPhone5,2
  • iPhone 5c: (GSM and CDMA): iPhone5,3
  • iPhone 5c (GSM and CDMA): iPhone5,4
  • iPhone 5s (GSM and CDMA): iPhone6,1
  • iPhone 5s (GSM and CDMA): iPhone6,2
  • 1st Gen iPod: iPod1,1
  • 2nd Gen iPod: iPod2,1
  • 3rd Gen iPod: iPod3,1
  • 4th Gen iPod: iPod4,1
  • 5th Gen iPod: iPod5,1
  • 1st Gen iPad (Wi-Fi): iPad1,1
  • 1st Gen iPad (AT&T): iPad1,2
  • 2nd Gen iPad (Wi-Fi): iPad2,1
  • 2nd Gen iPad (AT&T): iPad2,2
  • 2nd Gen iPad (Verizon): iPad2,3
  • 2nd Gen iPad (Wi-Fi): iPad2,4
  • 3rd Gen iPad (Wi-Fi): iPad3,1
  • 3rd Gen iPad (Verizon): iPad3,2
  • 3rd Gen iPad (AT&T): iPad3,3
  • 4th Gen iPad (Wi-Fi): iPad3,4
  • 4th Gen iPad (AT&T): iPad3,5
  • 4th Gen iPad (Verizon): iPad3,6
  • iPad Mini (Wi-Fi): iPad2,5
  • iPad Mini (AT&T-US; GSM & LTE 4, 17): iPad2,6
  • iPad Mini (Verizon-World; GSM, DMA & LTE 1,3,5,13,25): iPad2,7
  • iPad Mini Retina (Wi-Fi): iPad4,4
  • iPad Mini Retina (LTE): iPad4,5
  • iPad Air (Wi-Fi): iPad4,1
  • iPad Air (LTE): iPad4,2
u_w ad
jump
adx
optional Mobile device screen width, which overrides the automatic detection completed by the ad server.

Example:
u_w=1024
u_h ad
jump
adx
optional Mobile device screen height, which overrides the automatic detection done by the ad server.

Example:
u_h=768

Customised environments for image and non-image ads

You can use the adx form of the simplified URL to request any ad from DFP.

Environments that could request ads from DFP include the following:

  • Windows Phone 7 or BlackBerry applications where there is no DoubleClick SDK.
  • iOS and Android applications written in a non-native language, such as C++.
  • Other customised environments such as Connected TVs or set-top boxes.

These environments should adhere to the following principles to request an ad from DFP:

  • Ensure that the environment in question can handle Rich Media behaviours. Things to consider include running JavaScript, expansion and so on.
  • Use one of the available libraries in this environment to make a HTTP request to DFP.

  • Make sure that you set a valid user agent (User-Agent) in the request header to ensure that targeting will work properly. In addition, we recommend performing a small load test (1-2% of anticipated volume) to validate the request before going live.

  • Inspect the response status to make sure that the request was well formed. DFP Mobile will return a HTTP 200 / OK if the request is well formed.
  • If an ad is found, DFP returns the raw creative code associated to ad exactly as trafficked.
  • If an ad is not found, DFP returns a 200 / OK with an empty response.

A call that uses adx could look like this:

http://pubads.g.doubleclick.net/gampad/adx?iu=6837/Mobsite/Europe&sz=6x1&c=123456

A call that uses both jump and ad could look like this:

<a href="http://pubads.g.doubleclick.net/gampad/jump?iu=6837/TestMobileWeb&sz=320x50&c=12345">
<img src="http://pubads.g.doubleclick.net/gampad/ad?iu=6837/TestMobileWeb&sz=320x50&c=12345"></a>

Delayed impressions

DFP supports delayed impressions for use cases such as pre-caching ads. Please contact your Technical Account Manager for more information.