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 delivery 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-demo.adhese.com/json/sl_sdk_example_-leaderboard/?t=244.18664863333106

  • https://ads-[account].adhese.com

    • The value of the account attribute can be found 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]
    • Adding a timestamp is necessary to avoid caching issues.

Additional parameters

If necessary, additional parameters can be added to the request URL for the purpose of Targeting

An URL which contains targeting will look like this:  https://ads-demo.adhese.com/json/sl_sdk_example_-leaderboard/brChrome;OSX/dtdesktop/incars?t=244.18664863333106

Every target parameter is prefixed by a 2 letter combination, followed by the actual target(s). If more than one value is sent within one target, the values should be separated by a semicolon.  

The available targeting parameters and their prefixes are determined by your Adhese account configuration. Please contact our Support team for more details. 

The following list contains default parameters which are set up on every account:

  • /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.

Response structure

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

  • No labels