Setting up a Triggered Messages campaign

Each Triggered MessagesA product that lets you send automated personalized emails via an Email Service Provider (ESP), which are initiated by the the email recipient's on-site actions. campaignPersonalization: Describes rules for sending automated personalized emails via an Email Service Provider (ESP) that are triggered by the on-site actions of the email recipient. must have an associated Email Service Provider (ESP) connection and ESP action (send mail, add to group, remove from group). Set up the ESPStands for "email service provider" connection and the ESP action once, and these can act on all of your Triggered Messages campaigns. Furthermore, each Triggered Messages campaign must have an associated Email Product RecommendationsA personalization feature that incorporates personalized product recommendations into dynamically-generated email. campaign that uses an appropriate trigger strategy. See Setting up a triggered Email Product Recommendations campaign.

Creating a new Triggered Messages campaign

Go to Triggers in your Personalization Portal account. To create a new Triggered Messages campaign, click on the New campaign tab and fill out the form as follows:

1. Enter a name for your Triggered Messages campaign, such as Abandoned basket.
2. Select an ESP action so that the trigger performs the desired action when it fires.
3. Optionally, specify start and end dates for the campaign.
4. If you have a site in Episerver with more than one language, such as a Swiss site that has French and German languages, you can set the Locale to fire triggered messages based on the locale, which sends emails in the correct language.
5. Contact frequency appears only if you select the SendMessage ESP action. Set it to On if you want the campaign to limit the number of times a trigger can fire for each customerA site visitor who has made a purchase on your website. from this Triggered Messages campaignPersonalization: Describes rules for sending automated personalized emails via an Email Service Provider (ESP) that are triggered by the on-site actions of the email recipient.. There are no limits for the AddToGroup and RemoveFromGroup ESP actions.

   If you turn on the Contact frequency, specify the maximum number of times that the trigger can be fired for each user by this campaign per day, per week, or per month.

   In the previous screen image, the new trigger campaign specifies the following:

   • For any visitorSomeone who visits a website using a web browser. In most cases, a visitor can use public functions and services but cannot create content and has limited access to community content. In an SEO context, visitor means the number of visits to a URL through channels (external referrers), direct arrivals, and internal links. (See also visitor groups.), the trigger fires no more than 5 times per day, and no more than 20 times per week, and no more than 50 times per month (whichever limit is reached first).
   • The visitor must have made a purchase within the last 15 days.

   If both of these criteria are satisfied, the trigger fires.

6. Select the type of trigger this campaign should use. See Daily triggers for information.
   • For In-session triggers, specify how long (in minutes) the visitorSomeone who visits a website using a web browser. In most cases, a visitor can use public functions and services but cannot create content and has limited access to community content. In an SEO context, visitor means the number of visits to a URL through channels (external referrers), direct arrivals, and internal links. (See also visitor groups.) needs to be inactive for on your site before the trigger can fire.
   • Unless stated otherwise, Daily triggers monitor the last 30 days of data. As soon as the trigger criteria are satisfied, the trigger fires.
   • You can use Additional trigger actions alone or in combination with an In-session trigger.
   • You can specify whether the customer must have visited a certain page type a specified number of times.
   • You can specify a URLStands for "Uniform Resource Locator". Also known as a web address such as http://world.episerver.com. (or a keyword from a URL) from your site that the customer must have visited.

     The order of additional trigger actions does not matter.

     To add a criterion, where the user must have NOT visited a certain page type or URL, you can enter the number of viewings as 0 (zero).

7. Click Save campaign when you have completed your specifications.
8. The initial state of a newly created trigger is OFF. To activate it, go to the Campaigns overview page and click the play button next to the campaign name.

Setting up an ESP connection

Episerver must connect to the ESPStands for "email service provider"’s APIStands for "application programming interface". The API specifies how some software components should interact with each other, such as accessing a database or computer hardware, or easing the work of programming graphical user interface components. APIs often are in the form of a library that includes specifications for routines, data structures, object classes, and variables. See also: https://world.episerver.com/documentation/class-libraries/ so that when Triggered MessagesA product that lets you send automated personalized emails via an Email Service Provider (ESP), which are initiated by the the email recipient's on-site actions. is fired, Episerver can alert the ESP to perform an action.

1. To set up the connection, go to Triggers in your Personalization Portal account.
2. Select the New campaign tab and then click ESP connections in the top right.

   

3. Edit an existing connection or create a new one. To create a new connection, click Add an ESP connection. The Manage your ESP connections screen appears.

   

4. To create a connection:
   1. Enter your API credentials for your ESP account (such as username, password, database, realm, API token).
   2. Click Test ESP connection to test the connection.
   3. Click Save ESP connection.

Setting up an ESP action

1. To set up the action, go to Triggers in your Personalization Portal account and open a new or existing campaign.
2. Click ESP actions. You can either edit an existing ESPStands for "email service provider" action or create a new one. Make sure it uses the connection that you require, for example, the one you created or edited in Setting up an ESP connection.

   

3. To create a new action, click Add an ESP action.
4. Choose your preferred ESP action type from the available options and enter the required details (such as Group ID, List ID, Message ID, Database); the values of which are available from your ESP portal.

   These fields are dynamic and differ depending on the chosen ESP connection and the chosen ESP action type.

   

   Available action types are as follows:

   Depending on the features supported by your ESP platform, some of these actions may not be available for your chosen connection.

   • Add user to group. A fired triggerA product that lets you send automated personalized emails via an Email Service Provider (ESP), which are initiated by the the email recipient's on-site actions. tells the ESP to add a user’s email address to the email group or list with the specified Group ID or List ID. If there are ESP-level triggers on the list, are be activated by this step. This action just adds a user's email addresses to a list; it does not send those users any emails.
   • Remove user from group. Removes a user's email address from the group or list.
   • Send message. A fired trigger tells the ESP to send the message with the specified Message ID to the user.

     Depending on your ESP, Send message may not check whether the user has opted in to the emailing scheme, so use it with caution.

5. After you created your ESP action, test it and save it.

Linking to a specific basket

Episerver can integrate links from an email recommendation to a particular basket of the recipient. To enable this feature, contact customer service.

For developer information, see Link to a specific basket on Episerver World.