Skip to main content


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

Exploring arbitration results with the Arbitration matrix

Updated on September 15, 2022

Use the Arbitration matrix provided by the Customer Profile Viewer to understand what types of actions would be presented to a customer right now. The Arbitration matrix enables you to explore the Next-Best-Action Strategy without needing to access the underlying strategy rules. Use the Arbitration matrix for debugging, or to understand which next best actions a customer will receive next.

Pega Customer Decision Hub

Important: Do not use the Arbitration matrix in Production-level environments, as the decision results can affect model learning. Use the matrix only in the Business Operations Environment (BOE) or other non-production environments for debugging purposes.

Getting started with the Arbitration matrix

The Customer Profile Viewer can be accessed by clicking Explore arbitration results on the Arbitration tab of Next-Best-Action Designer, or from the Reports menu in the top right corner of the Customer Decision Hub portal. You can find the customer whose next-best-action result you want to analyze by using several parameters. For more information, see Compliance inquiries and the Customer Profile Viewer.

Viewing next-best-action results

To view the results, set the decision context, and then specify how you want to view the output. For more information about the available parameters, refer to the following table:

Selecting the decision context
A screenshot of the Direction dropdown
OptionDescription
DirectionSpecify whether you want to view the results for inbound or outbound channels.
Issue/GroupFilter the results by selecting an specific issue and group, or all issues and all groups.
Channel Select the channel for which you want to make a decision.
Note: This option is available if you pick Inbound as the direction.
Real-time containerSelect a real-time container associated with a next-best-action hierarchy level.
Note: This option is available if you pick Inbound as the direction.
ContextOptional: Define the key and value for any contextual inputs.
Note: This option is available if you pick Inbound as the direction.
Show all decision resultsChoose one of the following options:
  • Show all decision results - This option displays all results, including those actions that would be filtered out by the framework.
  • Show only decision results that will be delivered - This option displays only the results that would actually be delivered to that channel.

Exploring the decision results

Explore the detailed decision results by switching between different views to help explain why you are getting these results. The following views are available:

Explain prioritization

This is a detailed view of decision results, which allows you to apply different lenses or views on these results to answer specific questions.

Exploring the action prioritization for the Web channel
A screenshot of the Explain prioritization view
PropertyDescription
IssueThe issue of the action.
GroupThe group of the action.
NameThe name of the action.
TreatmentThe treatment name associated with the action.
ChannelThe channel assigned to the treatment.
Final propensityThe model propensity after applying Thompson sampling, or random propensity for actions in the model control group.
Total context weightThe value of all inbound context upweighting, calculated by using the following formula:
((C+C)/100) +1
ValueThe business value (either monetary or importance), as defined for the action
Total lever weightThe sum of all weighting defined for the action, and any issue, group, and journey upweighting.
PriorityThe final priority score that is used to rank actions by priority, calculated by using the following formula:
(P*C*V*L)
RankThe final ranking order of the action based on priority.
ResultsPassed or Filtered indicates whether the action would be presented to the customer, or filtered out by the strategy framework.

Explain propensity

This view provides more details on the different factors that went into calculating the propensity score.

Exploring the action propensity for the Mobile channel
A screenshot of the Explain propensity view
PropertyDescription
IssueThe issue of the action.
GroupThe group of the action.
NameThe name of the action.
TreatmentThe treatment name associated with the action.
ChannelThe channel assigned to the treatment.
Model control groupIndicates if the customer has been assigned to the random propensity control group.
Model evidenceThe number of customer responses that feed into the model. The higher the evidence, the more mature the model.
Model positivesThe number of positive responses received by this model.
Original model propensityThe model propensity as output by the model.
RankThe final ranking order of the action based on priority.
ResultsPassed or Filtered indicates whether the action would be presented to the customer, or filtered out by the strategy framework.

Explain weighting

This view provides a breakdown of the individual weights that make up the total lever weighting.

Exploring the weighting for Outbound channels
A screenshot of the Explain weighting view
PropertyDescription
IssueThe issue of the action.
GroupThe group of the action.
NameThe name of the action.
TreatmentThe treatment name associated with the action.
ChannelThe channel assigned to the treatment.
Total context weightThe value of all Inbound context upweighting, calculated by using the following formula:
((C+C)/100) +1
Context weight detailsDisplays the Key and Value pairs and upweighting for each context.
Business purpose weight (Issue)Displays the issue-level upweighting.
Business purpose weight (Group)Displays the group-level upweighting.
Action weightDisplays the action-level upweighting.
Q&A weightDisplays any upweighting applied as a result of question-and-answer context information.
Journey weightDisplay any upweighting applied based on the journey stage.
Outcome weightDisplays any updating applied due to a previous customer response.
Total lever weightThe sum of weights and the value displayed in the Explain prioritization view.
Note: The total context weight is not included in this calculation.
RankThe final ranking order of the action based on priority.
ResultsPassed or Filtered indicates whether the action would be presented to the customer, or filtered out by the strategy framework.

Explain filtering by feature

This view identifies which part of the strategy framework would filter out this action. Use the Show all decision results option to see which actions would be filtered out by the strategy framework, and where.

Note: The final filtering results may be slightly different depending on engagement policies, which are currently not included in this view.
Exploring the filter results for the Call center channel
A screenshot of the Explain filtering by feature view
PropertyDescription
IssueThe issue of the action.
GroupThe group of the action.
NameThe name of the action.
TreatmentThe treatment name associated with the action.
ChannelThe channel assigned to the treatment.
Excluded by Journey stageIndicates if the action is filtered out because the customer is not in the corresponding journey stage.
Suppressed by contact policyIndicates if the action is filtered out because the customer has exceeded a contact policy and the action is being suppressed.
No active channelThe treatment channel is not currently active on the Channels tab in Next-Best-Action Designer.
No active treatmentThe treatment channel is disabled on the Treatment tab of the action.
Excluded by model maturityIndicates if the action is filtered out because the AI model associated with this action is not yet considered mature, so it is limited to only 2% of the population.
Excluded by propensity thresholdIndicates if the action is filtered out because the customer propensity does not meet the minimum defined threshold.
Excluded by priority thresholdIndicates if the action is filtered out because the customer priority does not meet the minimum defined threshold.
Invalid bundleThe action is part of an invalid bundle, whether the parent action does not have any child bundle members, or the child bundle member does not have a parent action.
Redirected to primary contactThe action will be redirected to the authorized contact on the account, so it is not relevant for this individual.
Not top primary contactThere are multiple authorized contacts on the account, and this individual will not receive the action.
Action limit exceededThis action was filtered out by a FinalActionLimits entry for this channel.
No available treatment placementThis setting is applicable to inbound channels only. Indicates if the action is filtered out because there was no requested placement slot to fill.
Outbound limit exceededIndicates if the action is filtered out because the customer has already exceeded the number of allowed outbound communications.

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.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us