Skip to main content

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

Value Finder requirements for data sets

Updated on September 15, 2022

If your organization is currently still on a Pega Customer Decision Hub version earlier than 8.7 that does not include Value Finder, you can import a data set with strategy results and customer attributes to an 8.7 environment and analyze the data by running a Value Finder simulation test from the Simulation testing landing page.

Pega Customer Decision Hub

Ensure that your data set meets the import requirements so that Value Finder can analyze the data. For example, the data set must contain all strategy results and appropriate customer attributes that Value Finder can use to describe customers who only receive irrelevant actions. The data set must also contain the data for at least the eligibility and arbitration stages, as well as the propensities from adaptive models.

Since the structure of a strategy framework can vary and propensity values are not always available at the eligibility stage, you might have to create a new strategy to obtain the necessary eligibility and arbitration stage results from your specific strategy framework, and to attach the necessary propensities.

Best practices

When creating a data set for Value Finder analysis, follow these guidelines:

  • Run a simulation and save the strategy results for all customers. Then, join these strategy results with customer data. Use a data flow to merge these sources and to ensure that there is at least one entry for every customer in the original audience.
  • Do not mix inbound and outbound results as propensity ranges can vary.
  • If applicable, include multiple records for the same customer ID. There may be multiple records for the same customer ID because:
    • The Next-Best-Action Designer strategy consists of different stages: eligibility, applicability, suitability, and arbitration. The data set must include a pyStage column that contains at least the Eligibility and Arbitration values. The other stages are optional. If a stage is empty, this indicates that all actions were filtered out because there are no strategy results for that customer after eligibility.
    • A customer can have one or more strategy results (actions or treatments) at each of these stages.
  • Include a pyPropensity column that indicates the propensity for each of the strategy results obtained from the adaptive model.

Required fields

Include the following fields in the data set:

A customer's unique identifier.
In this column, include at least two values: Eligibility and Arbitration. You can also leave it empty when there are no actions for a customer after eligibility.
In this column, include the propensities as obtained from the adaptive model.
Customer attributes
  • Include any fields that are useful in describing groups of customers who only receive irrelevant actions, for example, age, gender, or current product holdings.
  • You can exclude customer attributes such as names, addresses, or other uniquely identifiable data. A Value Finder analysis does not require this data.

Optional fields

If you use the following fields in the prioritization, you can include them in the data set. Value Finder does not use these fields for analysis, but they can be useful for further insights:

  • pyChannel
  • pyDirection
  • pyGroup
  • pyName
  • pyTreatment
  • pyValue

Tabular data example

The following table shows a sample data set which Value Finder can analyze to identify gaps in customer engagement. A data set must include all customers, so that Value Finder knows how large the original population is and can identify how many customers are left without actions after eligibility.

If the decision strategy returns a result for a customer at every stage of the decision strategy funnel, include all the results in the table. If a customer does not pass the eligibility stage, you can leave the result for the stage empty, so that Value Finder knows how many customers are left without actions after eligibility.

There are multiple records for some customer IDs. For example, there are three records for customer 1, which represent three strategy results. This customer is eligible for two actions (OfferX and OfferY), one of which was selected for the customer at the arbitration stage (OfferX).



When you run Value Finder on strategy results that were loaded from a data set, the option to drill down the no-action recommendations and to investigate the underlying policies, is not available. In such cases, the strategy results are isolated from the Next-Best-Action Designer framework in your system, which is why Value Finder cannot perform a complete analysis.

  • Previous topic Value Finder requirements for strategies created outside of Next-Best-Action Designer
  • Next topic Running Value Finder simulations

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