Overview of promotions

Promotions are a key tool for e-commerce marketers to engage customers, drive sales, and incentivize actions through promo codes. The promotions feature simplifies creating and allocating promo codes, enabling seamless integration into your campaigns.

Blueshift manages promo code distribution and redemption. However, validation will remain the responsibility of your e-commerce system.

To effectively use promotions in your campaigns, follow these steps:

• Prepare CSV of promo codes
• Create promotion code bucket
• Use promo codes in your templates
• Assign promo codes for your campaigns
• Track promo code distribution
• Monitor alerts for promo bucket statuses
• Promo codes in customer profile
• Add more promo codes to existing buckets

Prepare CSV of promo codes

Create a CSV file with the required promo codes and structure it as shown in the example below. Ensure the header row matches the required format.

Make sure the codes are unique to prevent any overlap or reuse.

Click here to download a sample CSV file.

Create promotion code bucket

• Navigate to Promotions in the left-hand menu under Data.
• Click the +PROMOTION button on the top right corner of the screen.

Fill in the following fields:

• Promotion name: Provide a meaningful name for the promo bucket.
• End date:
  • Specify the end date for the promo bucket, or leave it as None.
  • Campaigns using codes from buckets with an End Date will pause automatically after 11:59:59 PM on the specified date.

  • If a promotion bucket is set to expire, a notification email will be sent within 72 hours before the expiration.

    • The email is sent to the campaign owners and the promotion creator.
    • Additional recipients specified in the notification field will also receive the email if notifications are enabled.
    • For buckets with expiry dates shorter than 72 hours, the reminder will still be sent before the bucket expires.
• Type:
  • Choose between multi-use and single-use promo codes:
    • Multi-use (selected by default): Multi-use promo codes assign a maximum of one sticky code per user from the promotion bucket. The allocated code will be the same even if the promotion bucket is used across multiple campaigns.
    • Single-use: Single-use promo codes ensure that each user receives a unique promo code every time a trigger in the campaign needs to allocate one. Each code is designed to only be used once.
  • Discount value: Enter the discount value (e.g., 20) for the promotion.
  • Discount format: Choose one of the following:
    • Percent off: Discount is a percentage (e.g., 20% off).
    • Amount off: Discount is a fixed amount (e.g., $20 off).

Allocation behavior

The promo code allocation behavior does not take into account the triggers and campaigns it is associated with. The only factors are whether the user has previously been allocated a promo code and whether it is a multi-use or single-use promotion.

Multi-use

Whenever a request is made to allocate a multi-use promo code for the user, it checks to see if the user has already been allocated one in the past. If the user has, it returns the same promo code the was previously allocated. Otherwise, it allocates a promo code for the user. This same promo code will be returned again if the you attempt to allocate another one for the same user in the future, which is what makes them sticky.

Single-use

For single-use promo codes, a new unique promo code is allocated for the same user each time. It doesn't matter if the allocation is happening from within the same trigger, different triggers, or different campaigns. Every request to allocate one for the user will return a new promo code each time.

You are allowed to associate multiple promotion buckets with a single trigger but campaign execution will only allocate at most one promo code for the user at each trigger. The purpose of having multiple promotion buckets for a trigger is so that campaign execution can use other buckets in case one of the buckets is out of promo codes. Campaign execution does not allocate a promo code from each associated promotion bucket!

 

To better understand how multi-use and single-use promo codes behave, let’s consider the following examples:

• Enable notification: By default, this checkbox is unselected. Select this option to enable notifications related to promotion activity and expiration reminders.

  • When enabled:

    • Enter the threshold for notifications in the Notify when field. You can choose between:
      • Percent of total coupons: Receive notifications when the percentage of remaining coupons falls below the specified value (e.g., 10%).
      • Number of coupons: Receive notifications when the total number of remaining coupons falls below the specified value (e.g., 50 codes).
    • Add additional recipients in the Notify emails field, separated by commas. These recipients will receive notifications along with the campaign owner and promotion creator.

• Upload CSV: Upload the CSV file created earlier.
• Preview uploaded codes: Once you upload the CSV file, the system will automatically show a preview of the first 10 rows under a Sample Data section. This helps you confirm the structure and values of the uploaded file before submitting the promotion.
  • The preview may render incorrectly if the file contains structural issues (e.g., extra columns).
  • You can click Fetch Again to refresh the preview if you reupload a different file.
• Click Submit to save the promotion bucket.

Use promo codes in your templates

Promo codes can be dynamically added to your email, push, or SMS templates to personalize content for each customer. Follow these steps to use promo codes effectively:

• Basic syntax:
  Use the generic syntax {{ user.promo_code }} to dynamically populate the promo code in your template. When the message is sent, this placeholder is replaced with the promo code assigned to the customer from the associated promotion bucket.

• Advanced syntax (optional):
  Alternatively, you can use the following syntax to reference a specific promotion bucket:
  {{ user.promotions.'promotion_id' }}
  Replace 'promotion_id' with the UUID of the promotion bucket.

• Important consideration:

  • The advanced syntax works only if the promotion_id in the campaign matches the promotion_id in the template.
  • The message will be sent without any promo code if there's a mismatch.

Assign promo codes for your campaigns

You must assign a promotion bucket to the trigger during setup to ensure your messages include the correct promo codes. This is done in the Send Settings on the Messaging tab for each applicable trigger.

• Multi-use promo codes: Customers receive the same sticky code for all triggers across campaigns using the same promotion bucket.
• Single-use promo codes: Customers will receive a new code at each trigger within a campaign, even if they do not requalify.

Track promo code distribution

View the details of each promo bucket under Promotions. The table includes:

• Total codes: The total number of codes uploaded.
• Available codes: The number of codes remaining.

You can view the campaigns where the promotion bucket is used from within the promotion editor.

Monitor alerts for promo bucket statuses

Alerts will be sent if the Enable notification checkbox is selected for the promotion bucket. These notifications include:

• A 72-hour reminder before the promo bucket expires.
• Campaigns that will pause due to expired promo buckets.

Here is an example:

Promo codes in the customer profile

The Promotions section on the customer profile provides visibility into the promo codes assigned to a specific customer. This section displays:

• The name of the promotion bucket from which the coupons were dispensed.
• The promo codes sent to the customer to date are displayed, showing up to 10 codes per promotion, with the most recent codes listed.

Add more promo codes to existing buckets

If you're running low on promo codes or need to add additional codes to an existing bucket:

• Edit the bucket in the Promotions section.
• Upload a new CSV file containing the additional codes.
  • Ensure the format matches the original file used during bucket creation.
  • New codes will be appended to the existing bucket.

Frequently asked questions