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 single sticky code per user from the promotion bucket. The same code is reused across all campaigns using the particular promotion bucket.
    • Single-use: Single-use promo codes ensure that each user receives a unique promo code every time they qualify for the campaign. Each code can only be used once per campaign from the same promotion bucket.
  • 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).

• 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 campaign 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