Issue: Journey actions not available in the Next-Best-Action strategy framework output
Use the following troubleshooting tips to help solve issues with actions that are not available in the Next-Best-Action strategy framework output.
You might encounter the following issues:- Cause: DDR entries are not correctly stored
- Cause: Inactive actions are being filtered out
- Cause: Engagement policies conflict with user data
- Cause: Constraints are restricting output
- Cause: Entry criteria for a customer journey stage are too restrictive
- Check that the entry criteria for subsequent journey stages are not too permissive
- Check that the action has treatments associated with it
- Check whether outbound model maturity is enabled
- Confirm whether the journey actions are being correctly output by Next-Best-Action Designer
Cause: DDR entries are not correctly stored
Ensure that the necessary DDR entries have been correctly stored.
Solution: Check the JourneyActions and JourneyStages Decision Data Rules
- Open the JourneyStages Decision Data Rule in the default destination ruleset.
- Find an entry for the journey stage with the format [JourneyName]/[StageName].
- Locate the entry for the stage that you want to check on the clipboard,
by navigating to the corresponding entry in the
RH_1.pxPage.pxResults() list.Make a note of the values of ModelName, pyJourney, and pyStage – you will use these to compare with the entries in JourneyActions.
- Check the action which has been associated in the JourneyActions DDR, by searching for the correct entry in the RH_1.pxPage.pxResults() list, and find the values of ModelName, pyJourney, pyStage, pyName, pyIssue, and pyGroup.
- The first three values must exactly match the entry in JourneyStages for the association to be considered valid.
Cause: Inactive actions are being filtered out
Inactive actions will always be filtered out by the strategy framework.
Solution: Check that the action is active in the system
- Open the action for which the journey processing is intended.
- Click the Details tab of the rule.
- Click Check out .
- Check the value of Availability to confirm whether the action is active.
- Click Save, and then click Check in.
Cause: Engagement policies conflict with user data
Remember that engagement policies are applied from the most broad to most specific context. Confirm that the defined engagement policies are not in conflict with your defined user data.
Solution: Check that engagement policies and contact policies are not filtering the action out
- The All groups engagement policies in Next-Best-Action Designer.
- The Group-level engagement policies in Next-Best-Action Designer.
- The Action-level engagement policies on the action rule form.
Policies are applied in this order:
Cause: Constraints are restricting output
Solution: Check that constraints are not restricting output on the given channel for the user
- In the navigation pane of Pega Customer Decision Hub, click .
- Click Constraints.
- Analyze the Customer contact limits section to confirm that the customer has not already reached their communication limit on the expected channel.
Cause: Entry criteria for a customer journey stage are too restrictive
Solution: Check whether the entry criteria for the customer journey stage are not too restrictive
- In the navigation pane of Pega Customer Decision Hub, click .
- Click Engagement Policy.
- Select the customer journey that you want to check from the Business structure section.
- On the specific stage, click the More icon.
- Choose View entry criteria.
- Analyze the criteria and make sure that they are not too restrictive.
Check that the entry criteria for subsequent journey stages are not too permissive
Similarly to the previous scenario, review whether the entry criteria for later stages will allow the user data to be considered for that stage. The strategy framework, within a specific journey, will try to place users in the latest stage for which they are eligible. That means, they may begin the journey midway through your defined stages if the entry criteria are too permissive for later stages. A common misconfiguration is to have very permissive entry criteria on the final stage of the journey, which will mean that users automatically end up at the end of the journey first.
Check that the action has treatments associated with it
If outbound treatment processing is enabled, the action needs to have treatments associated with it to be considered for output. The value for outbound treatment processing can be checked by clicking the Properties icon in the header of Next-Best-Action Designer. See the following figure for reference:
Check whether outbound model maturity is enabled
If the action or environment is relatively new, check whether outbound model maturity has been enabled. This can prevent new actions from being output by the strategy framework for the majority of customers, until the model has matured. For more information about model maturity, see Model learning for new actions.
The value of outbound model maturity can be checked by clicking the Properties icon in the header of Next-Best-Action Designer. As in the following figure:
Confirm whether the journey actions are being correctly output by Next-Best-Action Designer
For container service invocations, in order to proceed with the interactions that are being recorded, the journey action that you expect must be returned as the first ranked result (that is, the top result) for the subject ID for which the action results are being requested. Other actions may be weighted or ranked higher than your journey actions. Review your journey action weighting and propensities to see if they need to be manually adjusted.
For outbound scheduled runs, the journey actions should be included in the batch output results.
In both cases, the results should include the appropriate data for pyChannel, pyJourney and pyStage. If there is a mismatch between these values and what is stored in the JourneyStages, JourneyActions, or ChannelSettings DDRs, the journey's interaction data will not be correctly captured.
Previous topic Issue: Actions are missing journey data Next topic Issue: Customer journey results may not be appearing as expected in the Journey Visualizer