Ad request parameters

This page contains a summary of the different parameters used in ad requests.

Only use the same parameter once - if the exact same parameter is sent more than once, the result is unspecified.

Values should always be percent-encoded. The default encoding is latin-1, but this can be changed.

Targeting

cat, cat1, cat2, cat3
Category shortname. cat and cat1 are two different ways of sending in Category 1 - use one or the other, not both
c1-x-y
Custom targeting, multiple choice
c2-x
Custom targeting, integer range
c3-x
Custom targeting, boolean groups
c4-
Profile targeting
EAST<name>
Name-value pairs.
kw, kw1, kw2, kw3
Keywords
kw and kw1 are two different ways of sending in Keyword 1 - use one or the other, not both
sw, sw1, sw2, sw3
Search words.
sw and sw1 are two different ways of sending in Search word 1 - use one or the other, not both.
cman1, cman2
Manually inserted Semantic Targeting categories
url
Manually inserted URL for url targeting

Campaign selection

eas_uid
Unique browser ID. Generated by the site or app.
upair
Used for image tags, to connect the click tag to the selected campaign in situations where Emediate can't set a cookie.
pageviewid
Unique ID for this particular page. Changes on page reload. In the form of a UUID
cssm=1
“Client-Side State Management” Allows displaying frequency-targeted campaigns to browsers even if the client does not have a user id cookie yet. Use this setting only if it is known that the client's browser can set cookies, and it is necessary to show frequency-targeted campaigns on new clients' first ad request!

Selecting one campaign

camp
Campaign ID
cu
Content unit ID
cu_key
Content unit key
no
Creative ID

Selecting more than campaign

  • Composed JavaScript
  • Video Playlist

When using Emediate's functions for Composed JavaScript, these are automatically added to the ad request.

EAScus
Content unit IDs
EAScamps
Campaign IDs
EAScres
Creative IDs
EAScu_keys
Content unit keys
exclCamp
Each campaign may appear at most once in the result.

Format / content

cre
''img''
Specifies that the campaign should be returned as an image.
''mu''
Specifies that the campaign should be returned as HTML. Combine with js=y to get JavaScript.
''log''
Specifies that this request should log an impression on the given parameters. Returns a 1z1 pixel.
EASformat
''jsvars''
Automatically added to the request when using Composed Javascript
''nocontent''
Specifies that only the selected campaign and creative IDs should be returned, not the ad content. When using this parameter, campaign and content unit impressions aren't logged. Contact Emediate before using this parameter
encoding
The only allowed value is utf-8. If not present, latin-1 is used.
Applies to all targeting parameters after this one, and thus should be used in the start of the ad request
fif
Automatically added when using Friendly Iframe.
js
The only allowed value is y. Specifies that the campaign should be returned as JavaScript.
target
Link target for image creatives, text links, and backup images in templates.
ty
ct
Click
pc
Post-impression / post-click. If this registers as a post-click or post-impression is decided by the information stored in the browser cookie.
ti
True impression
EASClick
Third party click counter.
EASInclude, EASInclude1, EASInclude2, EASInclude3, EASInclude4, EASInclude5
Values for HTML text macros. This text will replace the corresponding macros in the HTML of the selected campaign. EASInclude and EASInclude1 are the same.
EASLink
Target URL for click links, when this is not booked on the campaign.
meta
meta=y will return a HTML/JavaScript comment containing campaign-id, width, height, etc, for the response. meta=set will do the same thing except that it will not just be a comment, instead a global variable EAS_meta_magic_var will contain all the values

VAST

VMaxd
Maximum allowed duration of video
VPl
Not supported
Player framewords accepted
Vwd
Not supported
Expected width of video in pixels
Vht
Not supported
Expected height of video in pixels
Vbw
Not supported
Maximum bandwidth of video in bits/sec
Vstrm
0 for progressive, 1 for streaming Not supported

Logging

EASevent
Event logging. Used to track e.g. actions in Flash banners.

logrest
Add extra information to the Emediate log files. The value will be appended as-is to the logfile.
The max length is around 1024 characters - the exact length is depending on which other values are logged for this request.

This information will not be available in reports or for any sort of data extraction. Do not use without Emediate approval.

Automatically added parameters

These parameters are added automatically to clicks by Emediate. Do not edit these.

ccat
Semantic Targeting categories.
csit
Brand Protection categories.
EASrot
Revenue optimization type used.
uuid
Unique impression ID. Used to connect impressions with clicks, post impressions and post clicks
EASflash
Flash version detected. Used by - and added automatically by - Composed JavaScript.

Debugging

Do not use these parameters unless debugging something together with Emediate

debug
Log extra debug information
EASadno
Select admatcher

Cxense © 2012 | Support