Skip to main content

Sharing action details with a third-party email service provider

6 Tasks

15 mins

Visible to: All users
Beginner
Pega Customer Decision Hub 8.8
English
Verify the version tags to ensure you are consuming the intended content or, complete the latest version.

Scenario

U+ Bank, a retail bank, is currently promoting multiple credit card offers by sending emails to qualified customers.

However, to comply with the security and spamming regulations, the bank decides to use a third-party email delivery service instead of using the in-house email server. As a result, the offer details must be written to the database, and an external email treatment is associated with the file or database template. The action details are then to be shared with a third-party email distributor.

Use the following credentials to log in to the exercise system:

Role User name Password
Decisioning Architect DecisioningArchitect rules

Your assignment consists of the following tasks:

Task 1: Create and configure an external email template for Rewards card

Create the Rewards card external email treatment and configure the Rewards card action with the new Rewards card external email treatment:

Field

Value

Name

Rewards card external email

Description

Rewards card external email

Keycode

EXTREWARDSEMAIL

Template type

DB

DB template

GenericDBTemplate

Task 2: Configure additional actions for the outbound run

Associate the remaining actions for the outbound run with email treatments by using the information in the following table:

Action

Email treatment

Standard card

Standard card external email

Rewards Plus card

Rewards Plus card external email

Premier Rewards card

Premier Rewards card external email

Task 3: Configure the Email flow template action

On the Actions landing page, configure the Email flow template action to write action details to a database table by using the Generic DB Template.

Note: As the Email flow template action flow is used in all the credit card actions, the actions will automatically be updated to use the DB template.

Task 4: Examine the referred database template

In the Standard card external email, open and examine the referred database template to understand and explain the configurations.

Task 5: Configure schedule run

On the Channels tab of Next-Best-Action Designer, configure and run a schedule run to write action details to the database template.

Note: In the Recurrence section, ensure that the Refresh the audience checkbox is selected. Also, ensure that the All outbound customers segment is selected as starting population.
You clear the added volume constraints before running the outbound schedule.

Task 6: Confirm that the action details are written to the database table

On the Templates landing page, preview the Generic DB Template to confirm that the action details are written to the database table.

Note: The Preview option will download a .CSV file with action details in it.

 

You must initiate your own Pega instance to complete this Challenge.

Initialization may take up to 5 minutes so please be patient.

Challenge Walkthrough

Detailed Tasks

1 Create and configure an external email treatment for Rewards card

  1. On the exercise system landing page, click Pega CRM suite.
  2. Log in to Customer Decision Hub as a Decisioning Architect:
    1. In the User name field, enter DecisioningArchitect.
    2. In the Password field, enter rules.
  3. In the navigation pane of Customer Decision Hub, click Content > Actions.
  4. On the Actions landing page, click Rewards card to open the action.
  5. Click Check out to make changes to the action.
  6. Click the Treatments tab, and then click Add channel > Email to add a new email treatment.
  7. In the Configure Email Treatment window, click Create > External to configure a new external email treatment:
    1. In the Name field, enter Rewards card external email.
    2. In the Description field, enter Rewards card external email.
    3. In the Key code field, enter EXTREWARDSEMAIL.
    4. In the Content section, in the Template type list, select DB.
    5. Next to DB template, click the Gear icon.
    6. In the Configure DB Template window, in the GenericDBTemplate row, click Add, and then click Apply to select the template.
    7. In the Subject field, enter Here is your credit card offer!.
      Create an external email
    8. In the upper-right corner, click Create.
  8. Close the treatment.
  9. Refresh the Configure Email Treatment window.
  10. In the Rewards card external email row, click Add to add the external treatment to the action.
  11. Click Apply to confirm the treatment selection and close the window.
    The treatment is now associated with the action.
  12. In the Email section, ensure that the switch for the external email treatment is on.
    E
  13. To remove an existing email treatment that you created in an earlier challenge, click the Delete icon.
    If you have an existing email treatment that you created in an earlier challenge, ensure you delete it.
    Delete an email treatment
  14. Click Check in to save the changes to the action.
  15. In the Check-in comments text box, enter External email treatment added, and then click Check in.

2 Configure additional actions for outbound run

  1. In the navigation pane of Customer Decision Hub, click Content > Actions
  2. On the Actions landing page, click Standard card to open the action details.
  3. Click Check out.
  4. Click the Treatments tab, and then click Add channel > Email to add a new email treatment.
  5. In the Configure Email Treatment window, in the Standard card external email row, click Add to add the treatment to the action.
    A
  6. Click Apply to confirm the treatment selection and close the window.
    The treatment is now added to the action.
  7. In the Email section, ensure that the switch for the email treatment is on. 
  8. Click Delete icon against the existing email treatment to remove it.
  9. Click Check in to save the changes and add a check-in comment.
  10. Close the Standard card action.
  11. Repeat steps 1-10 to associate the Rewards Plus card external email to the Rewards Plus card action.
  12. Repeat steps 1-10 to associate the Premier Rewards card external email to the Premier Rewards action.

3 Confirm the Email flow template action

  1. In the navigation pane of Customer Decision Hub, click Content > Actions.
  2. On the Actions landing page, click Email flow template to open the action details.
  3. Click the Flow tab.
    Email Flow Template
  4. Right-click the Send Email shape, and then select Properties to open the properties of the flow.
  5. In the Treatment section, confirm that Use associated Treatment option is the default selection.
    Note: Because all the credit card actions use the Email flow template action flow, the actions automatically update to use the DB template.
  1. Close the action.

4 Examine the referred database template

  1. In the navigation pane of Customer Decision Hub, click Content > Treatments.
  2. Click the Email tab.
  3. Click Standard card external email to open the email treatment.
  4. In the Content section of the email treatment, click GenericDBTemplate to open the database template.
    Access the DB template
  5. Examine the database details that are in the database template.
    DB Template Definition tab
  6. Click the Fields tab to view the added customer and action details.
    DB Template Fields tab

5 Configure a schedule run

  1. In the navigation pane of Customer Decision Hub, click Next-Best-Action > Designer, and then click Channels.
  2. In the Primary Schedule section, click the More icon, and then select Suspend to suspend the current scheduled run.
    S
    Note: If the status of the primary schedule is Draft, skip step 3.
  1. In the header of the Channels section, click Edit to make changes to the run.
  2. In the Primary Schedule section, in the Recurrence column, click the Gear icon to configure a schedule run frequency in the Configure outbound schedule window.
    S
  3. In the Start field, enter today's date and use the current time and the US EST time zone.
  4. In the End section, confirm that the following items are the default selections:
    1. No end date
    2. Refresh the audience
  5. Click Submit to save outbound schedule and close the Configure outbound schedule window.
    C
  6. Ensure that the value in the Starting population column is All outbound customers.
  7. To remove the added volume constraints, in the Volume constraints column, click the Gear icon, remove the Limit credit card offers restraint, and then click Apply.
    Volume Constraints
    R
  8. Click Save to save the changes on the Channels tab.
  9. On the Channels tab, in the Primary Schedule section, click More > Run to run the outbound schedule.
  10. Refresh the tab to view the latest status of the run.
  11. Once the run is complete, click COMPLETED to view the results.
    R
    Note: Your run results number might not match the numbers shown in the exercise steps because the segment in the exercise system selects a random sample of customers.

6 Confirm that the action details are written to the database table

  1. After test completion, navigate to Contents > Treatments.
  2. Click the Database tab.
  3. Optional: Click Refresh to view the database template.
  4. On the Database landing page, expand the Generic DB Template row to view the number of staging records. The records match the number of actions shown in the run statistics.
    Database Template staged records
  5. In the Generic DB Template row, click More > Preview to download the CSV file.
    Preview Details Written to an DB Template
  6. When prompted, open the output file; you might have to enable pop-ups on your browser.
    Note: Notice that the number of records in the downloaded file matches the number of actions that is displayed in the run statistics and the staging records. Also, you can verify that the Run_ID in the downloaded file matches the one that is displayed in the run details.
    DB Template output

This Challenge is to practice what you learned in the following Modules:


Available in the following mission:

If you are having problems with your training, please review the Pega Academy Support FAQs.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega Academy has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice