Create transactional email templates in IBM Marketing Cloud Transact XML

Create an email template in IBM Marketing Cloud Transact XML so that we can assign content to transactional emails. Complete this task for each specific transaction that we want an email sent for. That is, ensure that a corresponding email template exists in IBM Marketing Cloud Transact XML for each specific transaction type.

Procedure

1. Log on to IBM Marketing Cloud Transact XML. For example, from the following URL: https://engage2.silverpop.com.

2. Select Automation > Transactional Messages > Create Group.

3. Create a group of automated messages by completing the following fields:

   Parameter	Value
   Name	The name of the group to send automated messages to. For example, Order Submitted Group, to contain users who recently registered with the store.
   Notes	If necessary, notes for internal use.
   Contact Source	Select the shared database createdd when you configured IBM Marketing Cloud Transact XML to work with WebSphere Commerce. For example, demo_database_1.
   Event Trigger	Select Transact and XML.

4. Click Save & Activate. The groups of automated messages are displayed under the Active tab.

5. Click the group name createdd. The group details are displayed.Important: Make note of the group ID that is displayed. This value is used in proceeding tasks to configure the campaign for each message type transport method in the WebSphere Commerce Administration Console.

6. In IBM Marketing Cloud Transact XML, select Content > Create Mailings > Mailing Template.

7. Enter a template name. For example, Order Submitted Template. Then, click Apply.

8. Click Mailing Settings and complete the following fields:

   1. In the Subject Line tab, enter the subject for the email, including any personalized tags. For example, the subject might resemble the following samples:

      • Your order has been placed, for subjects typed in plain-text.

      • Your %%STORENAME%% order %%ORDER_ID%% has been placed, for subjects that use personalized tags.

      • %%SUBJECT%%, for subjects that are passed from WebSphere Commerce.

   2. In the Address Settings tab, enter the name that the email is from, the address, and the reply-to address.

   3. In the Contacts tab, ignore the contact source, as it is already set at the mailing group level.

   4. In the Contacts tab, select Shared as the template location and UTF-8 as the message encoding.

9. Click Mailing Settings to close the settings and to proceed to the email template body.

10. Enter the email template body.

    If we are composing the email by using Option 1 , where the WebSphere Commerce JSP composes the entire HTML, enter only %%BODY%% in the IBM Marketing Cloud Transact XML email template.

    If we are composing the email by using Option 2 , where the WebSphere Commerce JSP creates personalization name-value pairs, include any links, personalized tags, and e-Marketing spots in the IBM Marketing Cloud Transact XML email template.

    1. Create links in the IBM Marketing Cloud Transact XML template body.

       1. Click the Hyperlinks icon (

          ) in the email template body editor.

       2. In the Hyperlinks pane, enter the link text and URL. We can use personalization name-value pairs in the URL field, such as %%ACTIVATION_LINK%%.

       3. Select the protocol that your URL uses. For secure links, such as the account activation link, select https://.

       The email template body is updated to contain the hyperlink.

    2. Include personalized tags in the IBM Marketing Cloud Transact XML template body.

       1. Use the variable that corresponds with the personalized tag to use:

          %%tagname%%

       Where tagname is the name of the personalized tag to use. For example, Your order %%ORDER_ID%% has been shipped.

    3. Include e-Marketing spots in the IBM Marketing Cloud Transact XML template body.

       1. Use the variable that corresponds with the e-Marketing Spot to use:

          %%spotname%%

       Where spotname is the name of the e-Marketing Spot to use. For example, EmailWishlistNotification_Content.

11. Click Automate to automate a mailing send. Some fields are pre-populated by default. Ensure that you complete the remaining values.

    1. Select a Contact Source. Select the shared database createdd when you configured IBM Marketing Cloud Transact XML to work with WebSphere. For example, demo_database_1.

    2. Select Assign Mailing to Existing Group of Automated Messages. Select the group to automate sending messages to. For example, Order Submitted Group.

    3. Upon assignment, save mailing as: Active.

12. Click Submit. Review any warnings or errors on the confirmation page.

13. Click Automate. The new email template typically becomes active a few minutes later.

    Note: If you change an existing automated email template, we must redo the automation steps to ensure that it works correctly.

Previous topic: Deciding how to compose the email content
Next topic: Assigning the IBM Marketing Cloud Transact XML message type to its transport method