Mobile ad request examples

Last updated January 16, 2019

You can use mobile ad requests to send an ad requestCommunication from a web browser or app to an ad server to display an ad. URL and OpenX will send a structured delivery response in one of the following formats:

To render ads appropriately in your mobile appSynonymous with mobile. Refers to the use of an app via a mobile device, specifically to differentiate from mobile web. or siteAn OpenX component that represents top-level domains or subdomains and is used to organize ad units. Sites enable you to target and report on inventory performance., you must configure your app to interpret the response.

If no matching ads are available for a particular ad request, OpenX returns an empty response. You should test a few ad requests to review how OpenX represents objects in its responses and make sure that your app is configured handle them.

Each mobile ad request contains an ad request URL, which references the ad unit to deliver an ad for and various parameters. For example:

Format Mobile ad request example
HTML
http://delivery_server_domain/ma/1.0/arh?auid=6
JSON
http://delivery_server_domain/ma/1.0/arj?auid=6
XML
http://delivery_server_domain/ma/1.0/arx?auid=6

Where:

HTTP header forwarding

To proxy ad or tracking request not sent directly from a mobile device to OpenX, an HTTP header must be forwarded to OpenX with the request. For details, see HTTP header forwarding.

Impression counting

To implement a client-side impression counting mechanism, your app must make a call to OpenX via an impression confirmation beaconA tracking pixel, or a piece of code represented by a graphic with dimensions of 1x1 pixels, which is placed into the code of a publisher's web page and is loaded whenever a user visits the page. While invisible to users, beacons are used to track certain user activities, allowing you to group visitors by interest or product for future retargeting those specific users with more relevant messaging and creatives., which is embedded in pre-formatted responses. If your app does the final formatting, you must ensure proper handling of the beacon. To ensure a complete and proper integration, please visit the OpenX Support Community.

Managing refresh

For details on how to use the refresh_delay and refresh_max fields to manage refresh, see Structured responses.

Fill out my online form.