Email Templates Customization
Overview
This tutorial focuses on customization of transactional emails that are sent to your customers when certain user actions occur (e.g. registering to your service or requesting a password reset) which is possible with the Advanced Customization option (Cleeng-Mailchimp integration).
If you select the Advanced Customization option for your transactional emails, you can build an email template from scratch using the visual editor in Mailchimp and adding Cleeng data variables (parameters) in the template content.
Cleeng parameters work like Mailchimp merge tags. For more information on how Mailchimp merge tags work, see Mailchimp documentation.
In Cleeng, we have two kinds of parameters that you can use to insert personalized or dynamic content in your emails:
- Global Parameters
- Specific Template Parameters
For example, you can use the CUSTOMER_FIRST_NAME
parameter to display a customerâs first name where the parameter is placed. You can paste it anywhere you want in the html file, it can be either a value for parameter or value in the text tag like in the example below.
Note: Please pay attention to the formatting of parameters as specified in the Mailchimp documentation for merge tags.
<b>Hi *|CUSTOMER_FIRST_NAME|*,</b>
Global parameters
They are used in every template to reflect a broadcasterâs branding and data of a specific customer that an email is sent to.
Parameter | Type | Description |
---|---|---|
CUSTOMER_FIRST_NAME | string | Customerâs first name |
CUSTOMER_EMAIL | string | Customerâs email address |
PUBLISHER_NAME | string | Broadcasterâs name |
ACCOUNT_URL | string | Account link |
TERMS_URL | string | Terms & Conditions link |
PRIVACY_URL | string | Privacy Policy link |
CURRENT_YEAR | number | Current year |
PUBLISHER_LOGO | string | Broadcasterâs logo set by the broadcaster in the dashboardâs brand settings |
PUBLISHER_MAIN_COLOR | string | Main color set by the broadcaster in the dashboardâs brand settings |
PUBLISHER_BACKGROUND_COLOR | string | Background color. The value is fixed: #F2F7FA |
FAQ_URL | string | FAQ link. Either a link to a broadcaster's FAQ page or (if custom link not provided) to Cleengâs FAQ page. A custom link needs to be provided to Cleeng Broadcaster Success Specialists Team. |
IS_RTL | boolean | Text direction: left to right locale (0), right to left locale (1) |
Specific template parameters
This section is divided into email templates.
It contains specific template parameters that are applicable to particular email templates and are used besides global ones.
Important
It's crucial to note that the Specific Template Parameters are unique to each designated template. These parameters cannot be interchanged or utilized across different templates. Each event and its associated payload are designed for a single email template. Attempting to incorporate a payload element, such as a renewal date, into a template not intended for it won't be feasible.
Welcome email
No specific parameters for "Welcome email" template.
Access purchased
Specific Template Parameter | Type | Description |
---|---|---|
OFFER_AMOUNT | number | Offer amount |
OFFER_CURRENCY | string | Offer currency |
OFFER_TYPE | string | Offer type |
OFFER_NAME | string | Offer name |
RENEWAL_DATE | string | Renewal date |
TRIAL_STATUS | boolean | Trial status (whether a subscription is or is not in a trial period) |
DISPLAY_SUBSCRIPTION_NOTE | boolean | Whether to display a subscription note (e.g. information about automatic renewal). Itâs displayed ( 1 ) only if:a) the type of offer is subscription b) subscription is not in trial And itâs not displayed ( 0 ) in any other case. |
Invoice
Specific Template Parameter | Type | Description |
---|---|---|
TRANSACTION_NAME | string | Offer name |
TRANSACTION_PRICE_TAX | number | Transaction amount - with tax included |
TRANSACTION_PRICE_NO_TAX | number | Transaction amount - with tax excluded |
TRANSACTION_CURRENCY | string | Transaction currency |
TRANSACTION_TAX_RATE | number | Tax rate (%) used in the transaction |
TRANSACTION_DATE | string | Date of payment |
TRANSACTION_ID | string | Transaction ID |
TRANSACTION_TAX_VALUE | number | Transaction tax value |
FEE_NAME | string | Name of the fee charged for the transaction, e.g handling fee |
FEE_VALUE | number | Fee amount |
CUSTOMER_COUNTRY | string | 2-letter customer country code (ISO 3166 country code) |
TRIAL_STATUS | boolean | Trial status (whether a subscription is or is not in a trial period) |
PAYMENT_METHOD | string | Payment method (e.g. card) |
PAYMENT_GATEWAY | string | Payment gateway (e.g. Adyen) |
IS_PURCHASED_AS_GIFT | boolean | Whether an offer has been purchased as a gift: - if purchased as a gift ( 1 ), then GIFT_RECIPIENT_EMAIL is available and contains the recipientâs email- if not purchased as a gift ( 0 ), then GIFT_RECIPIENT_EMAIL is an empty value |
GIFT_RECIPIENT_EMAIL | string | Email of a person receiving a gift or an empty string if subscription was not a gift. |
IS_RENEWAL_DATE_AVAILABLE | boolean | Whether a renewal date is available (1 ) or not (0 ) |
RENEWAL_DATE | string | Renewal date or empty string if not available |
TRANSACTION_DISCOUNT_RATE | string | Discount rate (%) applied in transaction |
TRANSACTION_DISCOUNT_VALUE | string | Value of applied discount (in TRANSACTION_CURRENCY currency) |
TRANSACTION_DISCOUNT_TYPE | string | Type of discount (e.g. âcouponâ ) |
OFFER_TYPE | string | Offer type |
Renewal announcement
Specific Template Parameter | Type | Description |
---|---|---|
OFFER_AMOUNT | number | Offer amount |
OFFER_CURRENCY | string | Offer currency |
OFFER_NAME | string | Offer name |
RENEWAL_DATE | string | Renewal date |
Subscription renewed
Specific Template Parameter | Type | Description |
---|---|---|
IS_SUB_REACTIVATED | boolean | Whether a subscription is reactivated |
OFFER_AMOUNT | number | Offer amount |
OFFER_CURRENCY | string | Offer currency |
OFFER_NAME | string | Offer name |
OFFER_TYPE | string | Offer type |
RENEWAL_DATE | string | Renewal date |
TRIAL_STATUS | boolean | Trial status (whether a subscription is or is not in a trial period) |
DISPLAY_SUBSCRIPTION_NOTE | boolean | Whether to display a subscription note (e.g. information about automatic renewal). Itâs displayed ( 1 ) only if:a) the type of offer is subscription b) subscription is not in trial And itâs not displayed ( 0 ) in any other case. |
Access expired
Specific Template Parameter | Type | Description |
---|---|---|
TRIAL_STATUS | boolean | Trial status (whether a subscription is or is not in a trial period) |
OFFER_NAME | string | Offer name |
Failed payment
Specific Template Parameter | Type | Description |
---|---|---|
REJECTED_COUNT | number | Count of the rejected payment attempts |
PAYMENT_METHOD | string | Payment method |
OFFER_AMOUNT | number | Offer amount |
OFFER_CURRENCY | string | Offer currency |
FAILURE_REASON | string | Failure reason |
Forgot password
Specific Template Parameter | Type | Description |
---|---|---|
RESET_PASSWORD_URL | string | Password reset link |
Credit card issues
Specific Template Parameter | Type | Description |
---|---|---|
CARD_EXPIRED | boolean | Status of a customerâs card |
Refund confirmation
Specific Template Parameter | Type | Description |
---|---|---|
OFFER_NAME | string | Offer name |
REFUND_AMOUNT | number | Refund amount |
Gift subscription
Specific Template Parameter | Type | Description |
---|---|---|
PERSONAL_NOTE | string | Personal note from a gifter (the person buying a gift) to a gift recipient, attached to a gift |
IS_PERSONAL_NOTE_ATTACHED | boolean | Whether a personal note is attached or not |
GIFT_CODE_URL | string | Link to gift code verification and redemption |
OFFER_NAME | string | Offer name |
Gift successfully delivered
Specific Template Parameter | Type | Description |
---|---|---|
OFFER_NAME | string | Offer name |
RECIPIENT_EMAIL | string | Gift recipientâs email address |
Subscription switched
âSubscription switchedâ template can differ depending on the algorithm variable. (For more information on algorithms, see Supported subscription switch algorithms).
Specific Template Parameter | Type | Description |
---|---|---|
OFFER_NAME | string | Offer name |
OFFER_AMOUNT | number | Offer amount |
RENEWAL_DATE | string | Renewal date |
IS_DEFERRED | boolean | Whether DEFFERED algorithm was used |
IS_IMMEDIATE_AND_CHARGE_WITHOUT_PRORATION | boolean | Whether IMMEDIATE_AND_CHARGE_WITHOUT_PRORATION algorithm was used |
IS_IMMEDIATE_AND_CHARGE_WITH_FULL_REFUND | boolean | Whether IMMEDIATE_AND_CHARGE_WITH_FULL_REFUND algorithm was used |
IS_IMMEDIATE_AND_CHARGE_WITH_REFUND | boolean | Whether IMMEDIATE_AND_CHARGE_WITH_REFUND algorithm was used |
IS_IMMEDIATE_AND_CHARGE_WITH_TIME_PRORATION | boolean | Whether IMMEDIATE_AND_CHARGE_WITH_TIME_PRORATION algorithm was used |
IS_IMMEDIATE_WITHOUT_PRORATION | boolean | Whether IMMEDIATE_WITHOUT_PRORATION algorithm was used |
IS_IMMEDIATE_WITH_TIME_PRORATION | boolean | Whether IMMEDIATE_WITH_TIME_PRORATION algorithm was used |
Subscription stopped
No specific parameters for "Subscription stopped" template.
Updated 3 months ago