Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Upgrading Next-Best-Action Designer from version 1 to version 2

Updated on August 4, 2022

To upgrade the Next-Best-Action Designer:

Pega Customer Decision Hub
  1. Suspend any outbound schedules defined for the existing Next-Best-Action configuration defined in Next-Best-Action Designer version 1.
  2. Ensure that all Pega Customer Decision Hub assets are checked in.
  3. Ensure that the ruleset and version used by your access group are unlocked, or create an unlocked version of the ruleset. By default, the ruleset used to store the configuration is Artifacts.
  4. Ensure that the ruleset and version used by your Context Dictionary is unlocked. You can check the ruleset and version on the SettingsContext Dictionary landing page in App Studio.
  5. In Dev Studio, click RecordsSysAdminDynamic System Settings.
  6. Click Create.
  7. Fill out the following information:
    • Short description: optionally, enter the description of this Dynamic System Setting, for example, Enables the upgrade of Next-Best-Action Designer to version 2.
    • Owning Ruleset: enter PegaMKT-Engine.
    • Setting Purpose: enter MKTEnableNBADversion2Upgrade.
  8. Click Create and open.
  9. Set the value of the setting to true.
  10. Click Save.
  11. Log off from Pega Customer Decision Hub and then log back in.
  12. In App Studio or in the Pega Customer Decision Hub portal, click Next-Best-ActionDesigner. The Next-Best-Action Designer now shows the option to upgrade to version 2.
  13. Click Upgrade. The configuration of Next-Best-Action and its strategy framework is upgraded.
  14. If you do not plan to implement action treatments, introduced in Pega Marketing 8.2, deactivate Next-Best-Action treatment processing. This ensures that offers created before the upgrade function correctly. After you associate your offers with treatments, you can enable treatment processing again. For more information, see Treatments and channels.
    1. Click the gear icon in the upper right corner of the Next-Best-Action Designer.
    2. Set the Channel treatment processing toggle to OFF.
    3. Click Submit.
What to do next: After upgrading Next-Best-Action Designer, review and test the upgraded strategies to ensure that they work with the new configuration.
  • Previous topic Upgrading the Next-Best-Action Designer from legacy versions
  • Next topic Enabling Next-Best-Action Designer version 2 to support multilevel configurations

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us