Promotion codes—also called promo codes—are a great way to keep users engaged by driving interactions with a heavy emphasis on purchases.
With Braze’s Liquid functionality, we offer a way to make widespread promotion code usage a snap, allowing messages to now pull from the promotion list you provided, automatically and intuitively. The promotion codes feature offers expiry dates of up to six months and support for up to 20MM individual codes per list.
Promotion codes can’t be sent in in-app messages.
Creating a promotion code list
Step 1: Navigate to the Promotion Code section
From the dashboard, go to Promotion Codes, located under the Integrations section, then select Create Promotion Code List.
Step 2: Naming and creating your promotion code
Name your promotion code list and add an optional description.
Next, create a code snippet for the promotion code. This code snippet will be what you will reference in Liquid to display this specific set of promotion codes. Make sure that it is a code snippet that is not already being used in another list.
Snippets are case sensitive. For example, “Birthday_promo” and “birthday_promo” will be recognized as two different snippets.
You can’t change the code snippet after saving!
Step 3: Promotion code options
Each promotion code list has a corresponding expiration date and time that get set upon creation. The max expiration length is six months into the future from the day you’re creating or editing your list. Within that time, you can change and update the expiration date repeatedly. This expiration date will apply to all codes added to this list. Upon expiration, the codes will be deleted from the Braze system and any messages calling that list’s code snippet will not be sent.
You also have the option to set up optional and customizable threshold alerts. If set up, these alerts will email the designated recipient either when the list is running low on available promotion codes in this list, or when your promotion code list is close to expiration. The recipient will be notified once a day.
Step 4: Promotion code upload
Braze does not manage code creation or redemption. As a result, you’ll have to generate your promo codes to a CSV file and upload them to Braze. You can use our built-in integration with Voucherify or Talon.One to create and export promo codes. Make sure that there is only one code on each row.
Max file size is 100MB and the max list size is 20MM of unused codes. If you find the wrong file was uploaded, simply upload a new file and the previous file will be replaced.
After the upload is complete, click Save List to save all the details and codes you just entered.
Upon clicking save, you will see that a new row appears in the Import History. To refresh the table to see if your import has finished, click Sync at the top of the table.
Larger files will take a few minutes to import. While you wait, you are free to leave the page and work on something while the import is in progress. When the import is finished, you will see the status change to Complete in the table.
Updating a promotion code list
To update a list, simply open up one of your existing lists. You can change the Name, Description, List Expiration, Threshold Alerts, and add more codes to the list by uploading new files and clicking Update List. All codes in the list will have the same expiration, regardless of the date of import.
Step 5: Use promotion codes
To send promotion codes in messages, click Copy Snippet to copy the code snippet you set when creating your promotion code list.
From there, you can paste this code into a message within the dashboard.
Using Liquid, you can insert one of the unique promotion codes from the uploaded CSV file into a message. That code will be marked as sent on the Braze backend to ensure no other message sends that same code. When a code snippet is used in a multichannel campaign or Canvas component, each user always receives a unique code. If a particular user is eligible to receive a code through more than one channel, this user will receive the same code through each channel.
If the user receives two messages through two channels, they will be reserved two codes, though only one will be shown. For reporting purposes, one code will be sent sent, and the user will receive this code through the two channels. For example, for a multichannel Canvas step, only one code would be used by the user.
If there are no remaining promotion codes available when sending test or live messages from a campaign that pulls in promo codes, the message will not send.
Determining how many codes have been used
You can find the remaining code count in the Remaining column of the promotion code list, located on the Promotion Codes page.
This code count can also be found when revisited a pre-existing promotion code list page.