Page tree
Skip to end of metadata
Go to start of metadata

Adhese supports the integration of the Adhese ad server into mobile applications by means of ad tags.

Ad tags are pieces of code that inform the Adhese ad server about the inventory it can target. This happens by sending an ad request URL that contains the necessary information and targeting parameters. In reply to this request, Adhese returns a JSON response that enables the application to deliver an ad and track its impressions and clicks in a correct way. 

URL structure

An example of a request URL which contains only the basic (required) parts:

  • https://ads-[account]

    • You can find the value of the account attribute in your Adhese subscription information or through our support portal.

  • /json/
    • Adding this part to the URL makes sure that the result you receive is JSON formatted.
    • JSON has a fixed structure and, therefore, fixed fields. Refer to List of JSON response structure object fields for an explanatory list of the fields.
  • /sl[location code]-[format code]/
    • sl is the prefix for the section which contains the position information and is followed by two codes, separated by a dash - .
    • The location code has to match the URL code of the corresponding location in Adhese.
    • The format code has to match the code tag of the format you wish to request.
  • ?t=[timestamp]
    • To avoid caching issues it is necessary to add a timestamp.

Additional parameters

The request URL can contain additional parameters for the purpose of Targeting

An URL which contains targeting will look like this:;OSX/dtdesktop/incars?t=244.18664863333106

A 2-letter combination (e.g. br, dt or in) prefixes every target parameter and the actual target(s) comes after. If a parameter contains more than one target, use a semicolon to separate the different values.

The configuration of your Adhese account determines the available targeting parameters and their prefixes. Please contact our Support team for more details. 

Every account contains the following default parameters:

  • /br: brands or data about the browser and operating system; 
  • /dt: device type, such as phone, tablet, desktop or unknown;
  • /in: interests, this parameter is user defined.
  • /tl: consent indicator, values none|all, default is none

Response structure

The request returns a JSON object with the fields described at List of JSON response structure object fields. Adhese returns an empty JSON object (just two curly brackets) if it cannot deliver a suitable ad for the request.