TrackImage
Tracking Offer Impressions
The purpose of this document is to detail the necessary technical steps for providing the Aptimus Network accurate offer impressions. This functionality is ONLY necessary for partners that don't request offers from Aptimus in real-time. Partners that get an html or xml stream from Aptimus every time they display offers do not need to send offer impression data to Aptimus.
Who needs to send offer impression to Aptimus
The TrackImage functionality is ONLY necessary for partners that don't request offers from Aptimus in real-time. Partners that get an html or xml stream from Aptimus every time they display offers do not need to send offer impression data to Aptimus.
Aptimus uses impression data to gain insight into the performance of a placement so it is critical that this information be provided to enable optimization to occur.
Specifications
"TrackImage" uses a transparent gif. uses a transparent gif. The partner can accomplish this by embedding an image tag next to the html section displaying the offers as follows
- This example assumes that poid 1_123_23_6 is in the first position of the page and following that offer is poid 2_234_34_7
- The name value pair format for sending Aptimus impression activity using TrackImage is always: position=<poid>|<position_on_page>
Example HTML:
<html>
.....
<!-- display first offer here (poid=1_123_23_6)-->
<!-- display second offer here (poid=2_234_34_7)-->
<!-- set a one pixel image tag for transparent gif file - sending offer impression to Aptimus -->
<img src="http: //network.aptimus.com
/AptiNet/TrackImage?position=1_123_23_6|1&position=2_234_34_7|2"
height="1" width="1">
......
</html>
|
By putting a <img /> tag in the page that displays the offers, partners will be able to indicate which offers were displayed in which position without causing any page load time problems, as the request for the image is separate from the other request/responses for the page. When using an image tag, use the TrackImage Servlet instead of the TrackAction. That way a transparent "spacer" gif file will be returned and will not corrupt the page being displayed.
Example use:
<img height="1" width="1" src="http://network.aptimus.com/AptiNet/TrackImage?position=1_123_23_6|1&position=1_123_23_6|2&position=1_123_23_6|3"/>
Parameters Available
| Name |
Required |
Description |
| poid |
Y |
Placement & Offer Identifier |
| position |
Y |
Display position of offer on page |
| upsell |
N |
If the offer is shown as an upsell. Avail. values: { true | false } Defualt: false |
For Aptimus Publisher Use Only
©2007 All Rights Reserved
Last Updated
5/1/07
|
