DOWNLOADS EXAMPLES SKINS DOCS SUPPORT
 
 

trackPlays

(PHP)

trackPlays -- Returns information about each file that is played.

Usage

wimpy.php?trackPlays=http://www/path/to/tracking_app.php

Description

This option allows you to set up a script that gets "pinged" each time a track is played.

HINT: If you are using an XML playlist, you have the option of including extra tags to each <item>. Any extra tags that are included will also be returned..

To use this option, enter the URL to a script that can receive and process token pairs that Wimpy issues. We have developed a simple example so that you can get a feel for how the information is transmitted from Wimpy to the script that you define with this option.

You can download the "Track Plays" example by clicking here.

WARNING: The example provided above is NOT secure. It is provided so that you can get a feel for how the information is returned to your script. We have not developed a "standardized" application to handle "track plays" or "votes" because each webmaster has a different set of requirements. It is up to you to create a script to conform to the way you would like to track the information.

If this option is set, Wimpy will return all the information that it has received about each file. Wimpy will return the information about each file that is played using a standard "GET":

action : trackPlays
flashlistID : 46
entity : m
filename : http://www/path/to/Sanctify.mp3
artist : Delirious
album : King Of Fools
title : Sanctify
track : 1
comments : http://www/graphic/or/ecom/hyperlink.html
genre : Other
seconds : 252.891428571
filesize : 7.48
bitrate : 236
visual : http://www/path/to/graphic.jpg

If the getMyid3info option is not used, some of the information listed above will not be returned.

Wimpy will also return three additional tokens: action, flashlistID and entity.

action
Since track Plays and Vote return the same information, the action token allows you to distinguish the kind of request that is made. For Track Plays, action is set to "trackPlays," for the Voting, action is set to "vote." This is helpful if you have developed a single script that can receive the information from either Track Plays or Vote.

flashlistID
This is a reference to the item number in the playlist. For example, if the file is the first item in the playlist, flashlistID would return '1" -- if the file is the third item in the playlist flashlistID would be "3"

entity
This defines what kind of file it is. MP3 files return "m" XML files return "x" SWF files return "s" FLV files return "v"

 

 

 

 

.

 

trackPlays

 

 

 

 

  ©Copyright Plaino LLC. All rights reserved.