XML Feed tag for Mobile apps

 

 How to retrieve the XML responses?

Nowadays, there are two available options:

1. Response for batch process   (processes that run at the beginning of the day to download the advertising into the application, and at the end of the day to send the metrics).

If this type of response if needed, the tag must be retrieved by checking the option: Response will be cached

2. Response for real time process  (in this case, the advertising download is done in real time when the user runs the application. At the same time, the metrics are recorded).

If this type of response is needed, no other option must be checked. 

 

STEPS TO RETRIEVE THE ADVERTISING REQUESTS URLs

1. Ad a site/zone/spaces.

2. Create campaigns with image, text or flash ads associated to the spaces (created in point 1).

3. Retrieve the URLS or feeds for the ads from Inventory/Spaces - Select the desired space - HTML Code/XML feed.

 

 

4. Indicate the corresponding parameters as required:

• Cached or Real Time response
  
• Request: From a real user or not (if it is selected that the Response is not carried out by the real user, the parameters to identify IP, browser (User Agent) and URL where the tag is running can be added) - See the option highlighted in the screen shot.
  
• Amount of ads
  
• Include price information or not: If included, the price detail will appear in the XML response.
  

Then, retrieve the feed URL:

 

 

If the cached response is used, the information will include: ad, click URL and impression count:

 

 

 If the real time response is used, the information will include: ad, click URL. In this case, the impression is counted when the ad is requested:

 

 

Adding parameters: Ads

In order to show Flash Ads through Feed XML, some extra parameters should be included:

• Flash Version (fv)* - MANDATORY PARAMETER TO SHOW FLASH
  

e.g.: &fv=10

• Character set (crs)**: If defines the format in which the response is sent.

e.g.:&crs=UTF-8   //   &crs=ISO-8859-1

• Users Screen Size (n)**: It must be sent in hexadecimal --> &n=WIDTHxHEIGHT

e.g.: &n=4cdx3b6

To change numbers into hexadecimal format, a scientific calculator can be used:

 

 

* With only adding the Flash Version parameter the ad will be shown.

**The last two (crs//n) are not only available to show Flash ads, but for any kind of ad.

 

 

Adding parameters: Keywords

In order to apply this targeting option using XML Feeds, the corresponding parameters must be added to the tag.

Sending Keywords information to e-planning shall be performed by adding the following parameter:

 

kw_keywordname(identifier)=value

Example with 'Gender'

kw_gen=fem

 

After adding all the needed parameters for targeting, the URL will be:

 

 

 

Third-party tracking URLs (Impressions)

When it comes to 'External Impressions' the feed response will change, and it will also change the way the Impression is recorded.

In a case where the ad does not have an external imp url, the impression will be detected as the feed is executed (in a non-cacheable response). But when the ad has this type of external url, the feed response will detail 2 Impression URLs to be executed:

The one that belongs to eplanning

+

The one that belongs to the third-party system

Ad:

Example of responses without Third-party tracking URLs >>

Example of responses with Third-party tracking URLs >>