Jon Yongfook · December 2020
In this tutorial we will add a Code Block to a Mailchimp template that will automatically generate a different image for every user in your Mailchimp audience.
One of the best ways to increase your click rate on email campaigns is through personalization.
With the Bannerbear Query Strings feature you can add dynamic, personalized images to your email campaigns that get auto-generated instantly when a user opens their email.
It's a way to add personalized email touches such as:
In this tutorial we are going to add a code block to our Mailchimp template with a special tag that generates a customized greeting image with the recipient's name. This image will be displayed when the user opens their email.
To get started, add the Simple Email Header Example template to one of your Bannerbear projects:
You can customize this template before proceeding, for example you could change the fonts, change the background color, add your company logo etc.
This is a very simple template, with just one text variable. Bannerbear templates can be a lot more complex than this, you can pass in multiple texts, multiple images etc - but for now lets keep it simple! You should see the template in your project:
To work with Email Service Providers like Mailchimp, you will want to use the Query Strings integration. This allows you to generate dynamic images simply by changing the query string of an image url. Scroll down to the template integrations and choose Query Strings:
Create a new URL Base and click on it to view the documentation for that URL Base.
Ok so what did we just do?
When you create a new URL Base, you are creating a unique URL that can generate dynamic images based on the current template. It will look something like this:
When you change the query string parameters of the URL, a new image will be generated. In this way, you can dynamically generate different images just by changing the query string. As an example that could look something like this:
… but actually in practice the query string will be a bit longer as you may use multiple variables, and the query string parameter names will depend on the names of the layers in your template.
This is a simple template though, so it just has one parameter. If you click the example in your documentation page, an image with the text "Hello World" is displayed.
If you change the "Hello World" text in the query string, a different image is generated.
Copy the example url and move over to Mailchimp.
IMPORTANT! If you played with your query string and generated a few test images, you may trigger the built-in rate limit in the next step. Before going to the next step it's best to create a "fresh" Query String Base URL, copy that and then proceed.
There is more info on Rate Limits at the end of this tutorial.
In Mailchimp create a new campaign. I'm just using a simple template in this example:
Add a Code Block to the campaign template:
In the code block, you will need to add some code that uses your special Query String URL Base with some dynamic tags so that Mailchimp populates the tag with different data for each audience member. Mailchimp calls these tags merge tags and you can see a full list of them here: Mailchimp Merge Tag Cheat Sheet
In this example we are just going to add the First Name merge tag to our URL base. The code block code should look something like this:
<div class="mcnTextContent"><img src="https://on-demand.bannerbear.com/taggedurl/XXXXXXX/image.jpg?modifications=[message---text=Hello+*|URL:FNAME|*]" /></div>
Where XXXXXXX is your URL Base ID.
When you paste this code into the code block, the image will be broken in the preview but that's ok, we will preview the real images in the next step.
Enter preview mode in Mailchimp and switch on Live Merge Tags.
This will insert your merge tag data into the special Bannerbear URL and you will see the images get dynamically generated. You can test a few of these to make sure it is working, and then send your campaign as normal.
Send your campaign as normal. When a recipient opens the email, the header image will get dynamically generated (in one or two seconds) and display their personalized welcome message!
Query String Base URLs give public access to generating images from the template that they are connected to. In most cases this will not be a problem, but it does mean that if someone inspects your email HTML code, they can find your image URL and generate their own images from this template (not sure why they would want to, but they can!).
To prevent misuse, Query String Base URLs have 3 levels of built-in protection:
Other resources on Bannerbear with the tags scale, mailchimp and email
Hello I'm Jon, the founder of Bannerbear — every 2 weeks I send a newsletter with updates from the Product, Marketing and Business sides of my startup, subscribe below to receive it!