Campaigns and Action-Based Emails

In order to send messages through Fielo, you need to have already created Salesforce E-mail Templates as they feed through to Messaging. Essentially, you're just feeding the Templates through from Salesforce and Messaging - configuring some important parts as you do it.

There are two types of Messages you can send:

• Transactional E-mails are the ones sent to individual recipients - i.e. direct one-on-one communication - based on that recipient’s action. In other words, recipients trigger an email to be automatically sent in their direction after completing an action or a specific event. Keep in mind, then, that those emails are only relevant to a particular recipient.
• Campaign E-mails are what is classically referred to as E-mail marketing. Using this feature, you can create a standard email campaign and send it to multiple recipients (a list of eligible members) all at once. Different from the Transactional, the Campaign E-mails are triggered to be sent by the recurrency you define them to be sent.

Both types of messages can be highly personalized, in their own ways. You'll understand how in this page.

Create Messaging Email Templates

🚧

Enable Page Settings - Email Template and Email Campaign

Be sure the Email Template and Email Campaign related lists are active in your Program page.

From IAS, go to the Programs tab and scroll down to Email Templates.

To create a new Template, click New in the top right corner. Fill out the following information:

• Email Template Name: Give your Template a name - this can be the same as the name you gave it in Salesforce.
• Program: This will automatically be filled out by the system based on the Program you are working from.
• Active: this if you want the Template to be usable from now on.
• Data Class: Fill out this field only when creating a Campaign Email. You will use this when an Apex Class is needed to configure the fields to be merged in the Salesforce Email Template. Here, you select the Apex Class that needs to be used.

As you may already know, Merge Fields is an extremely important feature that allows you to send bulk personalized emails, but, by using an Apex Class, you can essentially create fields to add in your Messages - what makes you capable of entering even more data than what is available by default on Salesforce.

With this freedom to add anything to your template, it is possible to easily define custom values such as how many points that member has received in the last 7 days. Take a look in this example:

global class Fielo_WeeklyEmail implements FieloPLT.EmailDataInterface{
    
    public Map<Id,Map<String,String>> getTransactionalData(Set<Id> emailAlertIds){
        return null;
    }

    public Map<Id,Map<String,String>> getCampaignData(Id campaignId, Set<Id> memberIds){
        
        Map<Id,FieloPLT__Member__c> membersMap = new Map<Id,FieloPLT__Member__c>([SELECT Id, Name, FieloPLT__OrganizationAccount__r.Name, FieloPLT__OrganizationAccount__r.FieloPLT__Points__c FROM FieloPLT__Member__c WHERE Id IN: memberIds]);
        Map<Id,Map<String,String>> valuesByMember = new Map<Id,Map<String,String>>();
        for(FieloPLT__Member__c member : membersMap.values()){
            Map<String,String> values = new Map<String,String>();
            values.put('name', member.Name);
            values.put('orgMember', member.FieloPLT__OrganizationAccount__r.Name);
            values.put('points', String.valueOf(member.FieloPLT__OrganizationAccount__r.FieloPLT__Points__c));
            values.put('pointsEarned', '0');
            valuesByMember.put(member.Id, values);
        }
        
        //points generated in the last 7 days
        for(AggregateResult ar : [SELECT SUM(FieloPLT__Points__c) points, FieloPLT__Member__c member FROM FieloPLT__Transaction__c WHERE FieloPLT__Member__c in : memberIds AND FieloPLT__Date__c = LAST_N_DAYS:7 AND (FieloPLT__Type__c = 'Adjustment' OR FieloPLT__Type__c = 'Loyalty Asset' OR FieloPLT__Type__c = 'Challenge Reward') AND FieloPLT__IsReverted__c = false GROUP BY FieloPLT__Member__c]){
            String sumPoints = String.valueOf(ar.get('points'));
            valuesByMember.get((Id)ar.get('member')).put('pointsEarned', sumPoints.subString(0, sumPoints.indexOf('.')));
        }

        return valuesByMember;
    }
}

Now select which type of Email Message you would like to send out: Transactional Email or Campaign Email.

Transactional E-mail

If you want to send a Transactional Email, you need to connect it to a given Action, i.e. whenever a Member completes steps of a given Action, they receive a Message.
To better understand how this works, go to Actions.

Actions are made up of:

• An Object, which represents the behavior that you want to incentivize via e-mail.
• A Member, who is the recipient of the e-mail.

Actions can be accessed from the Tools tab, in the Libraries section. Some pre-configured Actions come with each package and if you want to connect Messaging to one of these actions, simply select the Action in the Lookup from Email Alert field when configuring that Action.

In the above example, the Action is Event, and this has been selected in the Lookup from Email Alert field. This means an Email Alert will automatically be triggered when an Event is completed.

You can also Create a New Action, and configure it in the same way so that an E-mail is immediately sent on completion of that Action.

Back to Messaging! Once you've selected Transactional E-mail, you have to fill out the following fields:

• Action: Here you choose which Action this Message is connected to. If you start typing in the box, your pre-configured Actions will come up, and you simply have to select the one you want.
• Segment: If you want this Message to go out to a specific segment of your Member base, select the one you want. Once selected, click to move it to the right-hand side.
• Template Unique Name: This is where you choose the Salesforce E-mail Template you want to use for this Message. Simply select the one you want from the drop-down list.

Campaign E-mail

If you select this option, at this stage you only have to select the Salesforce E-mail Template you want to use for this Message. Simply select the one you want from the drop-down list.

Email Campaigns

Once you've created your Campaign Email Template, you need to actually set an Email Campaign in motion, since this type of Email Template will only be sent by the campaign - which is different from the Transaction email type. To do that, go back to Programs and scroll down to Email Campaigns, just below Email Templates. Select New.

You then have to fill out the following fields:

• Program: This will automatically be filled out according to which Program you are currently working on.
• Email Campaign Name: Give your Email Campaign a name which refers clearly to what or who it is for. In the example below, we give the name Platinum Members because this is an Email Campaign aimed exclusively at Platinum Members.
• Date: Provide a date from which you'd like the Campaign to start. Note that if you choose a frequency for the Email Campaign, the date you set here will be taken into consideration for that. For example, if you enter 01/20 in the Date field and set the frequency to monthly, then the Message will be sent on the 20th day of every month.

🚧

If you leave the Date field blank, the Email will be sent the next time that the emailCampaigns scheduled job runs, which depends on how you have it configured. Check it out through Salesforce Setup in order to know more.

• Email Template: Now choose the Template you made earlier in Messaging Email Templates.

Segments (Filter Type)

This is the part where you select who you want your Email Campaign to go to.

• Segment: if you select this option, you have the option to choose from your existing Member Segments. Once selected, click to move it to the right-hand side.

• Custom: If you select this option, you can make a custom selection of which Members you want this Campaign to go out to. Criteria will automatically be filled as Member. Under Filter Criteria, select the characteristic of the Member you want to base your Campaign around e.g. city of origin, age, etc.. The Operator should be Equals, and the Value should be which specific type of the Criteria you want to select.
  Refer to the above example, where the Member base being targeted is Platinum Members:

To give another example, in the below Campaign, the Member base being targeted is people in Paris.

Recurrency

This is where you will select your campaign's recurrency:

• Type: if it is a one-time campaign, select Standard. If it is a campaign that will send several emails, select Recurrent.
• Frequency: choose how often you want to send emails through this campaign - daily, weekly, monthly, every three months, every six months or yearly.

📘

Other Frequencies

In case your objective is to send the Email Campaign two times a week, for example, you can create two campaigns with different dates defined in the Date field.

Creating Email Campaigns around Incentives

Another way to create an Email Campaign, is to do it directly from Promotions and Challenges in the Incentives tab.

🚧

When you create an Email Campaign from a Promotion or Challenge, all the Segments applied to that the incentive will automatically be included in the Campaign, that is, only the Members from those Segments will receive the Campaign Email. If no Segment was defined, all Program Members will be eligible.

To create an Email Campaign from an Incentive, go to the Incentives tab and select a Promotion or a Challenge.

From any of these screens, go to Email Campaign tab and click on New.

Now, define the following fields:

• Promotion or Challenge: This will come already filled out. You can remove it by clicking and selecting a new one.
• Email Campaign Name: Choose a name for your Campaign.
• Date: Select the date you want your Email Campaign to begin. When no date is chosen, it starts immediately once it's saved. If a future date is chosen, the Campaign will have its status set to Scheduled until the set date arrives.
• Email Template: Select the Email Template that is related to the Email Campaign being created. Only Email Templates that are configured as Campaigns will be available for selection.
• Recurrency: This is where you will select your campaign's recurrency.

Finally, click Save.