Adding QR codes
Lob’s QR code services allow you to generate a QR code for each individual mailpiece you send. We offer this ability via our Campaigns UI, our Print & Mail API, and also support the use of 3rd-party APIs or Javascript to generate QR codes.
We also offer attribution analytics to measure the impact of every mailpiece you send. Personalized response tracking is a standard feature of digital marketing channels, but has traditionally been difficult to replicate in Direct Mail. However, with Lob’s QR code service, personalized tracking can now be easily incorporated into your Direct Mail campaigns. This gives you the ability to track individual user responses, personalize landing page experiences, capture Direct Mail response data in real-time, long before any conversion event ultimately takes place.
This feature is available for all paid editions. Upgrade your Print & Mail edition to gain access to this feature, or reach out to our sales team to learn more.
QR codes can be generated via the Campaigns tool in the dashboard for postcards, letters, and self-mailers.
In Step 3 of Campaigns generation, a user can add one black and white QR code to their mail pieces. Once "Add QR code" is selected, you will be prompted to enter the landing page URL, then adjust the size and the placement of the QR code.
This feature is available for all paid editions. Upgrade your Print & Mail edition to gain access to this feature, or reach out to our sales team to learn more.
QR Codes can be generated for Postcards, Letters, and Self-mailers via the API.
QR Codes are generated within the API call to create a Lob mailpiece. In addition to passing Lob the name, address, and creative you would like to send the recipient, you will also pass the required parameters to create a QR code: size, positioning, and the URL where you want to send the user upon a scan. Then, when Lob generates the mailpiece, Lob will also dynamically generate the unique QR code and incorporate it into your design.
Lob QR codes can be generated by including the
qr_code object in the API request body while creating Letters, Postcards, or Self-mailers. This is only available via the single-endpoint APIs today.
qr_code object for letters
Lob QR codes will be printed in black, on a white background. They will be pasted over your design in a manner similar to how Lob places the ‘Address Block’, so make sure to designate the size and positioning of your QR code away from any critical designs when making the API request.
Next, indicate the position of your QR code in your mailpiece by setting the required
Position parameter to relative, then setting the distance from a reference position of the “Bottom/Top” and “Right/Left” of your design, in inches. Here, you will set your vertical and horizontal parameters:
- Use
bottomfor your vertical parameter: The field takes in a value between 0 to max length of the creative - Use
rightfor your horizontal parameter: The field takes in a value between 0 to max width of a creative
Lob recommends using 'bottom-right' as your placement anchor; however, there are a total of 4 anchor combinations available for potential use: top-left, top-right, bottom-left, or bottom-right.
- Make sure to leave 0.25” of space between your QR code position and any content of your mailpiece that you don’t want to be covered.
- When positioning your QR code, make sure to take into account the bleed edge added to the artboard dimensions of the mailpiece. For example, the dimensions of a 4x6” Postcard in Lob are actually 4.25” x 6.25”.
- Do not place your QR code over the area in which the mailing address will be printed. Reference the Ink-Free areas for each template here.
Then, set the size of your QR Code by passing through the
Width parameter of your QR code in inches. The minimum Width is at least 1” in size, so that the code can be easily scanned.An optional
Pages parameter can be used to specify the pages, in a ‘comma separated’ format, where the QR code should appear. If not included, the default is page 1 for letters, or front for postcards.- For Postcards, the values should be either
front,back, orfront,back. - For Letters, the values can be specific page numbers or page number ranges (ex:
2,5or1-3) - For Self-mailers, the values should be
inside,outside,orinside,outside.
Currently, you cannot generate QR codes with different locations on different pages.
Also, only 1 QR code per mailpiece is supported at this time.
Finally, you will set the Destination URL that the QR code resolves to by passing it into the
Redirect_URL parameter. Since Lob QR codes are dynamic, you can pass a unique URL for every single mailpiece you create, such as to direct every mail recipient to a unique landing page, or to capture data using unique UTM parameters. For example, in the sample API request body above, we are capturing the specific user ID of the intended recipient of the mailpiece in Lob’s website analytics when the QR code is scanned.
Every QR code generated will have a short Redirect URL assigned to it, which will resolve through to the Destination URL passed in the API call. This means you have the flexibility to change the Destination URL after the QR code has been generated, even if the mail has already been sent, as the initial Redirect URL will remain the same.
Once a QR code is scanned, the user will see a redirect screen (as shown on the right). |  |
All URLs passed in the
Redirect_URL parameter should begin with “http://” or “https://”Lob API errors contain human readable explanations in the
message parameter. For example, you may receive a
422 error containing the message “qr_code.position is required”. This indicates that no value was passed to the API in the position parameter.- Lob QR Codes do not expire. If your destination URL expires, you may want to update live QR codes to redirect to an active landing page.
- Remember to test! To ensure your QR code is placed correctly over your design, use your Test API Key to preview your creative in Lob and verify that everything looks as intended.
As part of Lob’s suite of Mail measurement and tracking features, you can capture impact and engagement metrics from your mail sends with QR codes. Below are the options for retrieving Lob QR code tracking data for each scanned mailpiece.
In the Mail Analytics in your Dashboard, navigate to Attribution Analytics tab to see data on the number of mailpieces sent with QR codes, and the number of scans those QR codes received.
Analytics for Lob-native QR codes can be retrieved from Lob’s
qr-code-service.lob.com API endpoint. More specific data can be retrieved from the API (see the QR Code section in our API documentation). Every QR code generated in Lob will return a QR Code ID, which can be used to retrieve activity data for that specific QR code. You can pass a date range or list of resources to retrieve the total number of QR Code scans, as well as detailed information on each scan including IP address, the date of scan, and the number of times the QR code was scanned. QR Code scan data is deleted after 90 days.
Whenever a QR code is scanned from a mailpiece, there will be an event generated, such as
postcard.viewed or letter.viewed. You can enable notifications on these events by setting up webhooks that will alert you when the scans occur. This can be incorporated into your omnichannel marketing campaign to subsequently trigger an email, mailpiece, or other action when a mailpiece is viewed.
UTM parameters are short text codes that you add to URLs (or links) that help track performance. Because QR codes can be generated dynamically at the time of their creation, we can generate QR codes with UTM parameters that correlate to the recipient.
For instance, if we are sending a mailpiece to a recognized user that we’ve assigned a Customer ID of “
12345”, we can append that ID to their Destination Page URL, so that the user can be recognized by our web analytics once they reach the page: www.lob-example.com/login?customer_id=12345. This enables you to more easily attribute customer activity back to this mailpiece.UTM parameters can also be used to track Campaign responses, A/B test variants, and other key data points that inform your understanding of the response to your campaign.
If you plan on submitting a static (non-personalized) creative via PDF, simply include the QR code image anywhere on the PDF in a way that is compliant with our PDF guidelines.
Dynamic QR codes generated by third-party APIs can be added to your HTML templates. For example, a common tool for this is Quickchart.io. To leverage this, simply use the API endpoint URL as the source of an image within your HTML.
The example below generates a QR code that resolves to lob.com, which you can change simply by changing the URL after
text=https://quickchart.io/qr?text=https://www.lob.com
So, in a Lob template it might look something like:
<img src="
https://quickchart.io/qr?text=https://www.google.com
">
You can incorporate merge variables to make it dynamic, for example using
{{qr_url}} as a merge variable that you can use to pass in a unique URL.<img src="{{qr_url}}">
Or the variable can be incorporated into the URL, such as:
<img src="
https://quickchart.io/qr?text=https://www.google.com&customid={{cid}
}">
Just note that if you are doing this at scale, you will want to subscribe to Quickchart.io, and incorporate your Quickchart.io API Key into the URL so that you don’t encounter rate-limiting errors with Quickchart.
You can also incorporate Javascript into your template, and leverage this
qrcode.js script for dynamically creating a QR code.Below is an example of how to reference the
qrcode.js file (in this case, hosted in an external location for the sake of brevity, but it actually works best when the entire script is incorporated directly into a <script> tag in the HTML template). You can see that this is generating a QR code that resolves to the following URL containing merge variables that you can inform dynamically:
https://www.url.com/?utm_source={{Campaign_Name}}&utm_customer={{Customer_ID}}&utm_name={{Recipient_Name}}
Example Script tag:
1
<div id="qrcode"></div>
2
<script type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/qrcodejs/1.0.0/qrcode.min.js"></script>
3
<script type="text/javascript">
4
var qrcode = new QRCode(document.getElementById("qrcode"), {
5
text: "https://www.url.com/?utm_source={{Campaign_Name}}&utm_customer={{Customer_ID}}&utm_name={{Recipient_Name}}",
6
width: 100,
7
height: 100,
8
});
9
</script>
Last modified 1mo ago