Learning Center
Learning Center Home
Dynamic Parameters for System Codes
Audience

This document is designed for people that are familiar with the concept of System Codes.

 
What are Dynamic Parameters?

Dynamic Parameters are available for all System Codes.
 
You can use Dynamic Parameters to make your own campaign or application more sophisticated. Dynamic Parameters can be used to personalize content, restrict access to content or chose what content is delivered to whom.
 
Currently, the following Parameters are available:
 
Parameter Description
%(uid) The anonymous id of the user or device.
%(ulang) The currently set language of the user.
%(screenwidth) The screen width of the used device.
%(ipcountrycode) The country code from where the user scans.
%(ipcity) The city name from where the user scans.
%(iplongitude) The longitude from where the user scans (based on IP).
%(iplatitude) The latitude from where the user scans (based on IP).
%(salt) A number that increases with every scan.
%(platformid) The platforms' id
%(devicename) The name the device.
%(codeoffset) The code number of the scanned code of the Code Series (for Code Series only)
%(attr:<field name>) Code Series field value
%(attrenc:<field name>) Code Series field value (URL encoded)
 
 
Typical Uses of Dynamic Parameters
 
Here are some examples what you can use Dynamic Parameters for:
 
  • Automatically resize pictures so they fit in mobile browsers.
  • Set the language of the page depending on the users’ language
  • Prevent users from seeing your content if they are not accessing the page from a certain country.

 

How are they used?
 
Examples 1)
 
URL definition:
http://www.yoursite.com/somepage.php?userid=%(uid)
 
Result after scanning:
http://www.yoursite.com/somepage.php?userid=16161626
 
 
Example 2)
 
URL definition:
http://www.yoursite.com/somepage.php?city=%(ipcity)
 
Result after scanning:
http://www.yoursite.com/somepage.php?city=London
 
 
Example 3)
 
You can also combine them:
 
URL definition:
http://www.yoursite.com/%(ulang)/somepage.php?city=%(ipcity)&country=%(ipcountrycode)
 
Result after scanning:
http://www.yoursite.com/en/somepage.php?city=London&country=GB
 
 
 
Specification
 
Parameter name Value Works with all Readers Example
uid

number (integer)

or 

hex 40 (string)
Yes
12313
 
or
 
1337C001FACEDBEEC8454F03F88C2E2954F92A77
ulang Two-character language code based on ISO 639-1. (string) Yes en, de, fr, es
screenwidth Pixel (integer) - 0 if not available Yes 360, 240, 0
ipcountrycode
Two-character country code based 
on ISO 3166. (string)
Yes DE, CH, US
ipcity City name (string) Yes London, Houston
iplongitude
City longitude. Default to capital city 
longitude if city is unknown. (double)
Yes -97 or 65.55
iplatitude
City latitude. Default to capital city 
longitude if city is unknown. (double)
Yes 29.775 or -26.14
devicename The name of the device (string). Yes (if recognized) Nokia N8
platformid The id of the devices platform (a BeeTagg Internal number) Yes

0 = Unknown
1 = Symbian S60 3rd
2 = Symbian S60 2nd
3 = Symbian UIQ3
4 = Symbian UIQ2
5 = J2me
6 = J2me generic
7 = Windows Mobile 5,6,6.5
8 = Palm OS 5.x
9 = Windows Desktop Reader
10 = iPhone
11 = Blackberry Non-Touch
12 = Android
13 = J2me full signed
14 = Symbian S60 5th
15 = Blackberry Touch
16 = Samsung Bada
17 = Windows Phone 7, 7.5
18 = Blackberry OS7

codeoffset The number of the code of the Code Series (BigInteger in the form of a string). Yes 1 to Size of Code Series
attr:<field name> Code Series field value (type depends on your input). Yes Any string is possible. E.g. "This is a value"
attrenc:<field name> Code Series field value in URL encoded form (type depends on your input). Yes Any string is possible. E.g. "This+is+a+URL+encoded+value"
 
 
 

 

©2005-2017 connvision Ltd - Contact - Privacy - Terms Of Service
German - English - DutchDutch is currently in Beta. Help us to improve! - RussianRussian is currently in Beta. Help us to improve! - TurkishTurkish is currently in Beta. Help us to improve!