Skip to main content
Skip table of contents

Coupon Code Setup

The Coupon Codes feature does not generate coupon codes, but rather allows ingestion of them into the platform.  You can include merge tags into your content using a merge tag.  Also, thresholds can be set per category of coupon codes to avoid the complete depletion of a coupon code for a category.

Setup

Coupon Codes are available for all accounts; however, a backend setting enables alerting for coupon counts/thresholds.  By setting minimum thresholds on coupon codes, you can help ensure that your external coupon code store is not depleted. Minimum Thresholds should be set for any Category of coupons so that notifications can be sent. Please submit a request to have thresholds added for your Coupon Codes.

Coupon Code Import

Coupon Code Imports must be in CSV format and should be dropped onto the account FTP in the designated coupon codes folder (/coupon_codes). Below are the available fields for import:

Field

Description

category

String that classifies the coupon as a certain type for the customer. Thresholds can be set per category on the backend.  Example: WelcomeSeries could be the category and then these coupons will only be used when a user calls the WelcomeSeries coupon. Trimmed spaces and case-insensitive.

coupon_code

String of the coupon code itself.  Trimmed spaces and case-insensitive.

start_date

(optional) An ISO-8601 formatted timestamp, start_date can be used for personalization.  Coupons will only be assigned if after the start_date.

end_date

(optional) An ISO-8601 formatted timestamp, end_date can be used for personalization.  Coupons will only be assigned before the end_date, otherwise they will be pruned.

expiration_date

(optional) An ISO-8601 formatted timestamp, expiration_date can be used for personalization.  Coupons will only be assigned before the expiration_date, otherwise they will be pruned.  Some coupons have a separate end date to expiration date and so this field is needed.

description

(optional) additional detail that can be used for personalization.

The supported date format is "yyyymmdd".

Tracking Coupon Code Imports

You can confirm your import status by checking for your file within the Data > Files tab in ZMP.

Coupon Code Insertion

The merge tags for Coupon Code Insertion require a user to determine the category from which to pull. See the example:

{% coupon my_coupon | category: 'test' %}

You can use {{my_coupon.coupon_code}} to get a discount of {{my_coupon.description}}. The coupon expires on {{my_coupon.expiration_date}}.

REMINDER: Make sure to use the coupon liquid tag only once and assigning it to a variable, then use the same variable that was assigned first at other places instead of using the liquid tag and calling/assigning it again. This will ensure only one coupon is allocated per user for emails sent with this content in the future.

Codes Running Out

If coupon codes run out for a particular category, we will fail those sends with a campaign_skipped event with a reason of coupon_allocation.

Bar Codes

Barcode Types supported by ZMP

CODE 128 A

CODE 128 B

CODE 128 C

CODE 128

CODE 39 EXTENDED + CHECKSUM

CODE 39 EXTENDED

CODE 39 + ANSI MH10.8M-1983 – USD – 3 3 of 9

CODE 93 – USS-93

CODABAR

CODE 11

EAN 13

EAN 2-DIGITS UPC-BASED EXTENSION

EAN 5-DIGITS UPC-BASED EXTENSION

EAN 8

INTERLEAVED 2 OF 5 + CHECKSUM

INTERLEAVED 2 OF 5

IMB – INTELLIGENT MAIL BARCODE – USPS-B-3200

IMB PRE-PROCESSED
KIX (KLANT INDEX – CUSTOMER INDEX)

MSI + CHECKSUM (MODULO 11)

MSI (VARIATION OF PLESSEY CODE)

PHARMACODE TWO-TRACKS

PHARMACODE

PLANET

POSTNET

RMS4CC (ROYAL MAIL 4-STATE CUSTOMER BAR CODE)

STANDARD 2 OF 5 + CHECKSUM

STANDARD 2 OF 5

UPC-A

UPC-E

1D RAW MODE (COMMA-SEPARATED ROWS OF 01 STRINGS)

2D RAW MODE (COMMA-SEPARATED ROWS OF 01 STRINGS)

PDF417 (ISO/IEC 15438-2006)

QR-CODE

QR-CODE WITH PARAMETERS

DATAMATRIX (ISO/IEC 16022) SQUARE

DATAMATRIX RECTANGULAR (ISO/IEC 16022) RECTANGULAR

You can input a sample code and define the parameters for the desired barcode image. Input parameters include Barcode Type (see list above), Width, Height, Padding, and Color (Black, Red, Orange, Yellow, Green, Blue, Pink, Purple, Brown).

Based on the specifications you define on the barcode generator page, a sample barcode image URL will be generated.

Post-Sending

After sending, an event named coupon_allocated will be posted to the corresponding profile and will contain campaign details and the coupon code allocated to the person. This event can also be added to ZMP event exports.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.