Difference between revisions of "Tracking - Banner advertisements"

From Silent Wings Wiki
Jump to: navigation, search
 
(One intermediate revision by the same user not shown)
Line 11: Line 11:
 
A simple example of what getbannerinfo.php should return in your web browser could look like this:
 
A simple example of what getbannerinfo.php should return in your web browser could look like this:
  
  {banner}buynlarge.jpg{/banner}
+
  {banner}buynlarge.tif{/banner}
  {banner}silentwings.png{/banner}
+
  {banner}silentwings.tif{/banner}
  {banner}youradhere.png{/banner}
+
  {banner}youradhere.tif{/banner}
 
  {time}10.5{/time}
 
  {time}10.5{/time}
  
 
In this case, the viewer will show the banners in this order, in an ever-going loop. Each banner will be displayed for 10.5 seconds.  
 
In this case, the viewer will show the banners in this order, in an ever-going loop. Each banner will be displayed for 10.5 seconds.  
  
Several common image file formats are supported, including .jpg, .png and .gif. We recommend using .png files as these do not have any compression artifacts, and you can use the transparency function to make it blend with the background. You can also add some invisible border to the images if you want the banner to get some margin distance from the upper left screen edges.
+
The image format supported is currently TIFF (.tif, .tiff). Alpha channel (transparency) and LZW compression can be used.  
  
 
The images must be placed so that they can be opened in any web browser, using the url  
 
The images must be placed so that they can be opened in any web browser, using the url  
Line 32: Line 32:
 
* The banners are displayed in the upper left corner. If they are wider than 2/3 of the screen width, they will be scaled down to fit within the 2/3 screen width.
 
* The banners are displayed in the upper left corner. If they are wider than 2/3 of the screen width, they will be scaled down to fit within the 2/3 screen width.
 
* The banners are downloaded when a viewer starts up. So to re-load getbannerinfo.php, the viewer must be restarted.
 
* The banners are downloaded when a viewer starts up. So to re-load getbannerinfo.php, the viewer must be restarted.
 +
* The banners do not contain web links. You cannot click them to open a web browser.
  
 
[[Category:Tracking]]
 
[[Category:Tracking]]

Latest revision as of 10:39, 15 September 2009

Note: This feature is implemented in Silent Wings Viewer 1.10. It will not work with earlier versions

If you are running a tracking event server, you have the possibility to show banner ads in the viewer. This has been implemented to help getting sponsors that help financing such events. Currently, this only works with vPos-compatible servers.

To set it up, you need to add an additional php query to your server, called

getbannerinfo.php

It must return a list of banner ad files and a tag for how many seconds each ad should be shown. It must be reachable by any web browser with the url (replace mytrackingserver.com with your own ;-) )

http://mytrackingserver.com/getbannerinfo.php

A simple example of what getbannerinfo.php should return in your web browser could look like this:

{banner}buynlarge.tif{/banner}
{banner}silentwings.tif{/banner}
{banner}youradhere.tif{/banner}
{time}10.5{/time}

In this case, the viewer will show the banners in this order, in an ever-going loop. Each banner will be displayed for 10.5 seconds.

The image format supported is currently TIFF (.tif, .tiff). Alpha channel (transparency) and LZW compression can be used.

The images must be placed so that they can be opened in any web browser, using the url

http://mytrackingserver.com/image.png. 

You may also for example define a path in the banner tag, like this:

{banner}banners/image.png{/banner}

where the url then becomes

http://mytrackingserver.com/banners/image.png. 

Hints:

  • If you want a pause without any banner, create a banner which is empty. It could be a one-pixel transparent .png file, for example. Put this empty image in between in the list of images, where you want the blank.
  • The banners are displayed in the upper left corner. If they are wider than 2/3 of the screen width, they will be scaled down to fit within the 2/3 screen width.
  • The banners are downloaded when a viewer starts up. So to re-load getbannerinfo.php, the viewer must be restarted.
  • The banners do not contain web links. You cannot click them to open a web browser.