Coupon codes are organized using containers known as coupon blocks. You manage coupon blocks on a clientThe working environment of Episerver Campaign. A client is a stand-alone and closed system that serves to organize your mailings. Campaign users can use one or more clients for your scenario. level, so you can use the same coupon block in multiple mailings in your client.
A mailing may only contain one coupon code from the same coupon block. If you insert two coupon codes from the same block, the mailing displays the same code twice but uses only one coupon code.
In contrast, if you want recipients to receive several different coupons in a mailing, include coupon codes from different coupon blocks. Also, a recipient can receive several coupon codes from the same coupon block if they are sent in separate mailings.
To manage and edit coupon blocks, open the start menuMain screen in Episerver Campaign, where the available options are grouped together. and select Special > Manage coupon blocks.
In the list, click a coupon code to display its details.
- Name. Used internally by the coupon code system.
- Field function. Use this placeholder to insert the coupon block in a mailing.
- Type. One of the following:
- EAN-13 bar code
- Code 128 bar code
- Interleaved 2 of 5 bar code
- Created. The creation date of the coupon block.
- Last modified. The modification date of the coupon block.
- Total coupon codes. Number of codes a coupon block contains (for static and bar code blocks) or how many codes were already generated (for generated blocks).
- Free coupon codes. Number of free codes in a coupon block. For generated coupon blocks, the value is infinite.
- Use valid coupon codes in test emails. Check this box to use valid coupon codes in your test emails.
Use these buttons to perform the following actions.
- Delete block
- Delete unused codes
- Import codes
- Download assignments
- Download codes
- Edit thresholds
- Edit bar code coupon block
Prerequisite: If you want use static coupon blocks, you must first import them. See Importing codes.
- Click Create.
- In the Name box, enter a descriptive name for the coupon block, so you can identify it later.
- In the Type area, select a coupon block type.
- Static. Use if you want to release a limited number of coupon codes or generate coupon codes from your CMS. Static coupon blocks are imported into Episerver Campaign in a CSVStands for "comma-separated values"; tabular data in a plain text file separated by the comma character. file format. See Importing codes.
- Generated. Coupon blocks are dynamically generated by Episerver Campaign during dispatch and are typically unlimited. These coupons are generated with one coupon block.
- EAN-13 bar code. Bar code blocks convert a 13-digit code into a machine-readable bar code and insert it as a graphic into a mailing. The encoding of the bar code conforms to the EAN-13 specification. The coupon system ensures that bar codes are unique and only used once. No items are encoded, but a unique code is assigned to each recipient. To manually import coupon codes into a bar code block, see Importing codes.
- Code 128 bar code. Bar code blocks convert an alphanumeric code of any length into a machine-readable bar code and insert it as a graphic into a mailing. The Code 128 bar code contains the full ASCII character set and automatically switches between the Code 128 bar code character sets A, B, and C to best encode your data.
You can also select the Code 128 bar code character set manually:
- Character set A. Supports the ASCII character set without lower case letters.
- Character set B. Supports the ASCII character set without control codes.
- Character set C. Supports pairs of digits from 00 to 99.
To manually import coupon codes into a bar code block, see Importing codes.
- Interleaved 2 of 5 bar code. Bar code blocks convert a numeric code of any length into a machine-readable bar code and insert it as a graphic into a mailing. The Interleaved 2 of 5 bar code is a numeric bar code that only supports pairs of digits from 00 to 99. To manually import coupon codes into a bar code block, see Importing codes.
- To use valid coupon codes in your test emails, check the Use valid coupon codes in test emails box.
- Click Save.
For more individual coupons you can also create bar codes that refer to a specific recipient list field. To do this, contact customer support.
In the overview, click the coupon block you want to delete > Delete block > Delete. Coupons in the block that have been sent but not redeemed remain valid.
When deleting a coupon block, its histories and any assignments are lost.
In the overview, click the coupon block you want to empty > Delete unused codes. Unused codes are deleted, but the block remains intact. Later, you can add new coupon codes to the block.
You can only delete unused codes in static and bar code coupon blocks.
Prerequisite: Your computer contains coupon codes in a CSV file. The file should only contain one column with the codes. You should know the CSV file's encoding, column delimiter, escape character, and if the CSV file contains a header row.
To learn how to define the minimum number of codes for that block, see Editing thresholds.
Codes for EAN-13 bar code coupon blocks must consist of a 13-digit number, digits only. Codes for Interleaved 2 of 5 bar code coupon blocks can consist of any number of digits, but the number must be even.
- In the overview, click the coupon block to which you want to import codes.
- Click Import codes. The Upload coupon codes window opens.
- Click Browse... and select the CSV file that contains coupon codes to be imported.
- Click Preview.
- In the File charset drop-down list, select the encoding used in the CSV file. If you are not sure about this, select Auto.
- In the Column delimiter drop-down list, select the character (semicolon, comma, tabulator, and so on) that separates the data fields in the uploaded file.
- In the Escape character drop-down list, select the character with which each individual data field is enclosed. Some database programs use a single quote (') or double quote (") around each data field when exporting.
- If the CSV file contains a header, in the Skip first row drop-down list, select Yes.
- Optionally, in the Maximum number of rows to preview drop-down list, select the number of records to display in the preview.
- Click Refresh preview to reload the records.
- Click Import coupon codes. The last tab shows how many codes were imported.
After the import, the coupon block is ready for use.
To download a CSV file containing the already used coupon codes and their corresponding mailing and recipient assignments:
- In the overview, click the desired coupon block.
- Click Download assignments.
To download codes of a coupon block:
- In the overview, click the desired coupon block.
- Click Download codes.
Due to their inherent unlimited nature, you can only download the list of used coupons as a CSV file for dynamic and bar code coupon blocks.
If you are using static or bar code coupon blocks, you must ensure that sufficient coupon codes are available. Depending on the type of mailing, Episerver Campaign uses several security questions.
To define the threshold values, perform the following steps :
- In the overview of the Manage coupon blocks window, click the coupon block whose thresholds you want to edit.
- Click Edit thresholds.
- Define the threshold values in the Configuration area.
- Warning threshold value 1. Enter an integer warning threshold value for transactional mailingsAn email triggered by a recipient action (such as an order or purchase) or event (such as an anniversary). It is sent out subsequent to the event.. If this threshold is reached, a notification email is sent, but the sending continues. You should then upload new coupon codes.
- Termination threshold value 1. Enter an integer threshold value for transactional mailings. If this threshold is reached, a notification email is sent and dummy coupon codes with no function are used in the mailing. You must upload new coupon codes.
- Warning threshold value 2. Enter the percentage of recipients of regular and Smart Campaign mailings for which the coupon block must still contain coupon codes after sending. If this threshold is reached, a notification email is sent, but the sending continues. You should upload new coupon codes.
- Termination threshold value 2. Enter the percentage of recipients of regular and Smart Campaign mailings for which the coupon block must still contain coupon codes after sending. If this threshold is reached, the sending is canceled. You must upload new coupon codes before restarting the mailing.
- Email addresses. Enter one or more email addresses to which a notification is sent if a threshold value is reached.
- Click Save.
For triggered mailings (for example, birthday mailings), the coupon system uses the thresholds for regular mailings. For transactional mailings sent using the REST API, HTTP API or Marketing Automation, the coupon system uses the thresholds for special mailings.
- In the overview, click the coupon block you want to edit.
- Click Edit bar code block.
- You can specify the size options of the bar code coupon block either through height and width or line thickness :
- Select Height and width and enter the desired values in pixels.
- Select Line thickness and then in the Line thickness drop-down list, select a value from 1 to 10 pixels.