Learning Center
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 |
| 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" |
- 
