Adding a new venue to DemonstratorGauge is simple. Please check first that the venue you want to add is not already on the list. Go to Settings > Add/modify Venues. Fill in details – make sure you add Postcode. Select a Retail Chain to aid reporting.

Importing

If you have a long list of venues to add (50+), we are able to “bulk upload” the data. Please ensure all fields are correctly filled in (postcode, retail chain, Venue Name). Please contact us so we can arrange it.

You can download the DemonstratorGauge Venue Import excel template: Examplevenues.

Note that you can get a list of venues using the API – demonstratorgauge-data-download

A note about adding venues

It’s important that the venue list is as clean as possible, with no duplicates to confuse demonstrators. Before adding a venue, please check whether is already stored. We can modify venues, and merge them, but we are not able to delete venues as they are used for multiple purposes.

What this API does:

SUMMARY: The objective is to provide the correct ID numbers for Demonstrators, Products and Venues in the DemonstratorGauge field marketing system. Using an HTML request, a remote call can be made to the DemonstratorGauge database to retrieve a list of:

• Demonstrators
• Products
• Venues

It is designed to be used in conjunction with the API: DemonstratorGauge Event Upload

Detail:

A correctly formed HTTP request will deliver a file in CSV format of fields from the tables containing demonstrators, products and venues.

Restrictions:

• You are restricted to 100 API calls (total) per day.
• You can only retrieve Venue data for your specified Country
• You can only retrieve Person data for your specified Agency AND country
• You need a valid API key – please request one from API@directness.net

Using the API

To get a list of venues in your country:

http://www.d1-gauge.com/canon/API/GetInfo.php?key=xxxxxxxxx&type=Venue

To get a list of products:

http://www.d1-gauge.com/canon/API/GetInfo.php?key=xxxxxxxxx&type=Product

To get a list of persons/demonstrators for your Agency Name:

http://www.d1-gauge.com/canon/API/GetInfo.php?key=xxxxxxxxx&type=Person

NB Replace xxxxxxxx with your API key.

Example Output WIth Person List (restricted to Agency Name)

Example Output with Venue List (restricted to Country)

Example Output with Product List

Example with PHP

<?

// DemonstatorGauge Data Download 4 December 2009 - v0.1

url = "http://www.d1-gauge.com/canon/API/GetInfo.php?key=xxxxxxxxx&type=Product";

// replace xxxxxxxxx with your API key

// type=Product

// type=Venue

// type=Person

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, $url);

curl_setopt($ch, CURLOPT_BINARYTRANSFER, 1);

curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);

curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);

$result = curl_exec($ch);

curl_close($ch);

print $result;

?>

Validation

A CSV (Comma Separated Variable) file can be downloaded.

Error messages:

API Key expired - please ask for a new key
API key not valid - please request key with your API 
Support

Please send comments to API@directness.net

Cool-Iris Wall of Photos in DemonstratorGauge

New feature on our field marketing measurement solution DemonstratorGauge: A wall of photos to allow browsing, searching and downloading. It uses an excellent plug-in from Cool-Iris which looks rather like the fancy photo-manipulation you see Tom Cruise doing in the movie Minority Report.

After logging in, you have a super-easy way of looking through the photos collected by field agents. We have it set up to show the last 30 days of photos, which currently displays around 2000 images. No extra software is needed, but the small download from Cool-Iris gives a slightly better user experience.

If you wish to collect images from marketing activities from thousands of agents in multi-country locations, DemonstratorGauge is the natural choice. Enjoy this 90-second demo here (and for iphone users it’s also on YouTube).

Full screen view, wall of photos

Short tutorial video presentation here on how to use the new features to upload the “perfect event”. You can see how a demonstrator can log event details, time, comments, products sold, upload photos with captions.