E-Commerce Marketers often need to include 1-time use promotion codes in their marketing. Blueshift makes it easy to create Promo Codes and dynamically allocate them. However, redemption and validation will have to be managed by your e-commerce system.

To add promotions to your campaigns, complete the following steps:

  1. Prepare a CSV of promo codes
  2. Create a Promotion Code Bucket
  3. Use Promotion Codes in Your Templates
  4. Use Promotion Codes in Your Campaigns
  5. Track Distribution
  6. Monitor Alerts
  7. Add promotion codes to existing bucket if required


  • Promo code syntax must be inserted in the template.
  • The promotion bucket must be linked to the campaign.
  • Campaigns will stop executing if you run out of promotion codes.
  • Promo codes can only be tested on a launched campaign. Test Sends will not pull from the promo code bucket.

1. Create a CSV

Create a .csv file with a single promotion code per row. Do not include a header row in the CSV file.


2. Create a Promotion Bucket

Create a new promotion bucket by navigating to the Promotions tab and clicking on the +New button. Upload the csv created in the previous step.

The Promotion Type field is mainly used for reporting and does not affect promo code values.


3. Use Promo Codes in Your Templates

You will need to reference the promo code in your email, push, or SMS templates. The promo code gets generated after you create the promotion bucket in step 2.


You can then insert the following syntax in your template: {{user.promotions.'promotion_id'}}

4. Use Promotion Codes in Your Campaigns

Finally, associate the promotion code with the campaign from the Send Settings on the Messaging tab of each applicable trigger.


5. Track Distribution

Once you have launched promotion code-based campaigns, you can monitor the distribution of promo codes on the main Promotions page.


6. Alerts

Blueshift will send you an alert based on the notification settings and email recipient(s) defined during setup.


7. Additional promotion codes

If you are running out of codes and/or need to add more codes to an existing bucket, simply edit the bucket and upload a new CSV file. Follow the same format as in step 1.

Was this article helpful?
0 out of 0 found this helpful



Please sign in to leave a comment.