Learning Center
Learning Center Home
Code Series

 
Audience

This document is designed for people that are already familiar with the concept of System Codes and Dynamic Parameters


What is a Code Series?

Whenever you need to create several codes that share a similar URL, you should consider the Code Series feature instead of generating each code one-by-one.
A simplified example will be presented to explain the idea of Code Series.
 
Let’s assume you are a real estate agent and want to use QR Codes for each of your 135 properties. You want to print the QR Codes on the sign in front of each property so visitors can scan the code and learn more about that particular property (pictures, factsheet to download, etc.).
The mobile website of one of your properties can be accessed via the following URL:
 
http://www.a-real-estate-propertypage.com/properties.php?propertyid=65 
 
This will display the content of the property with ID 65 in your database.
The standard way without Code Series would be to generate 135 codes:
 
http://www.a-real-estate-propertypage.com/properties.php?propertyid=
http://www.a-real-estate-propertypage.com/properties.php?propertyid=
http://www.a-real-estate-propertypage.com/properties.php?propertyid=
http://www.a-real-estate-propertypage.com/properties.php?propertyid=135
 
This approach has several disadvantages:
  • Time consuming. What if you have 5000 items in your database?
  • Error prone because of repetition.
  • Unmanageable. What happens if the URL structure changes after 6 months? Do you really want to update 135 codes?
  • Cost ineffective.
Wouldn’t it be great, if you could simple tell our system that you need 135 QR Codes with the following URL?
 
http://www.a-real-estate-propertypage.com/properties.php?propertyid=CODENUMBER
 
That’s exactly what you can do with Code Series. It’s available for all code systems (QR Code, BeeTagg Code, Datamatrix), and, because the Code Series is a feature of the Dynamic Link Code, you can use all the features awarded to Dynamic Link Codes including Encryption, Custom Hostname, Dynamic Parameters, Statistics, etc. In the future, you are able to create a million codes in a snap!
 

Hello, World!

The easiest way to start learning about the Code Series is to step through a simple example. Let’s stick with the example above.
 
Step 1: Creating the Code Series
  1. Go to Dashboard -> Dynamic Link -> Advanced Tab
  2. Enter your following URL-Pattern: 
    http://www.a-real-estate-propertypage.com/properties.php?propertyid=%(codeoffset)
    Note the special Dynamic Parameter %(codeoffset). Upon Redirection, this special Dynamic Parameter will be replaced with the number of the code in the Code Series that gets scanned. E.g. if code number 5 is scanned it will result in …properties.php?propertyid=5
  3. Enter the number of codes that you need in the textbox Size of Code Series.
  4. Click the “Create” button.

 

Step 2: Downloading the QR Codes with the Bulk Renderer
 
After creating the Code Series, you now have to get the actual code images (PDF, PNG, etc.). You can either get each image for free one-by-one or, you use the newly introduced Bulk Renderer.
 
With the Bulk Renderer you can download all codes of the Code Series at once in a nicely packed ZIP file.
 
 
Step 3: Scanning
 
Unzip the just downloaded ZIP file and you can start scanning the codes. They will begin working immediately.
 
 
Step 4: Statistics
 
The Statistics / Reports for Code Series work slightly differently. 
Go to the Manager -> Click the Statistic icon of your Code Series
You will now see a new tab called “Total Per Code”.
 
 
Click this tab and you will see the total click per code in your Code Series. The one with the highest scans will be listed first. All other tabs show the clicks cumulated for the whole Code Series!
 

 

Advanced: Code Series with additional Redirect Data

The above example is simplified, because it only works if you have URLs with an increasing number and starts with "1" (for cases where it does not start with 1 you can use Programmable Code - see example 3 here).
 
But what if your URL uses some arbitrary parameters and the structure looks like this?
 
http://www.a-real-estate-propertypage.com/properties.php?propertname=BurbankBlvd%2b12%2cLA 
http://www.a-real-estate-propertypage.com/properties.php?propertname=RiversideDr%2b24a%2cLA
http://www.a-real-estate-propertypage.com/properties.php?propertname=ADDRESS-IN-URL-ENCODED-FORMAT
 
In cases where you do not have a simply increasing number, you can use Redirect Data.
You tell the system how many codes you need (size of Code Series) and upload some data in the CSV (Comma separated value) format.
 
In our example the CSV data file looks like this:
 
 
and the URL like this:
 
http://www.a-real-estate-propertypage.com/properties.php?propertname=%(attrenc:Address)
 
Note the special Dynamic Parameter %(attrenc:fieldname). If the value should not get URL encoded, use the Dynamic Parameter %(attr:fieldname).
 
What happens here?
 
If code number 2 (Offset = 2) of the Code Series is scanned, the Redirector will replace the parameter %(attrenc:Address) with “RiversideDr%2b24a%2cLA” (note the URL-encoded form).
 
The rest is the same as in the simplified case.

 

Cost

Good news first: codes are cheaper if you buy them in a series than if you buy them one-by-one. The more codes you buy, the cheaper each code becomes.
And this is the magic formula (don’t worry, there is a calculator on our website):
 
Cost in BeeTagg Credits = ln(size + 100) * 400 - 1841 + size * 0.00001 * 1.2 * 100
 
 

FAQ

Are Code Series compatible with all QR Readers?
Yes, it’s a server side feature and therefore not dependent on the reader used.
 
Can the Code Series feature be used with QR Codes, BeeTagg Codes and Datamatrix?
Yes, you can use Programmable Code with all supported code systems.
 
Can the Custom Hostname feature be used with Code Series?
Yes.
 
Can you use Dynamic Parameters with Codes Series?
Yes.
 
Am I allowed to use Code Series to build my own Code Redirection Service?
No. The Terms of Use do explicitly not allow you to create a Redirection Service based on Code Series.
 

 

©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!