Skip to main content


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

JSON file structure for historical data

Updated on May 17, 2024

To perform better offline analysis of adaptive model historical data, learn more about the parameters that Pega Platform uses to describe the data that you extract.

When you extract historical customer responses from adaptive models, Pega Platform saves the historical data in JSON format. Consult the following property descriptions and sample output for a better understanding of the JSON file structure.

Properties for model context and predictors

When you define an adaptive model, you specify the names of the model context and predictors. To save the historical data in JSON format upon extraction, Pega Platform transforms the names that you specify to make them compliant with the JSON format.

See the following table for examples of property names before and after data conversion to a JSON file.

Property name in Pega PlatformProperty name in the historical data fileDescription
pyNameContext_NameModel context
AgeAgeModel predictor
Devices(1).DeviceTypeDevices_1_DeviceTypeA model predictor that is embedded in a page list or group
Param.RankParam_RankModel parameter predictor
IH.Web.Outbound.Reject.pxLastGroupIDIH_Web_Outbound_Reject_pxLastGroupIDInteraction History (IH) predictor that is added to the model when you enable IH summaries for the model

For more information, see Adding adaptive model predictors.

Properties for decision strategy results

Consult the following table to learn more about how Pega Platform transforms the names of properties that describe decision strategy results, such as the strategy outcome. The names of these properties remain the same for all adaptive models in Pega Platform.

Property name in Pega PlatformProperty name in the historical data file
pyOutcomeDecision_Outcome
pySubjectIDDecision_SubjectID
pxInteractionIDDecision_InteractionID
pxRankDecision_Rank
pxDecisionTimeDecision_DecisionTime

For more information, see About Strategy rules.

Meta properties

Consult the following list to learn more about the properties that Pega Platform uses to describe the model itself.

id
The unique ID of a customer response.

You can use the response ID to identify potential duplicate records in the historical data file.

positiveSampling
Percentage of all positive responses to the model that Pega Platform uses to create the historical data file.

For more information, see Extracting historical responses from adaptive models.

negativeSampling
Percentage of all negative responses to the model that Pega Platform uses to create the historical data file.

For more information, see Extracting historical responses from adaptive models.

dataCenter
Name of the Cassandra data center from which Pega Platform captured the response upon historical data extraction.

You can use the data center name to identify the data center that wrote the record in an active-active multi-data center setup. For more information about Cassandra data centers, see Configuring multiple data centers.

rulesetName
Name of model ruleset.
rulesetVersion
Version of model ruleset.

Sample output

Pega Platform saves historical data in JSON format, as in the following sample output:

{ 
   "Param_International":"false",
   "Context_Direction":"Inbound",
   "Param_UnlimitedSMS":"false",
   "Context_Channel":"Call Center",
   "positiveSampling":"100.0",
   "Decision_SubjectID":"CE-967",
   "Decision_Rank":"3896.0",
   "rulesetVersion":"08-04-03",
   "Context_Name":"Apple iPhone 8 32GB",
   "IH_Web_Outbound_Reject_pxLastGroupID":"Phones",
   "Param_CLVSegment":"Lapsed",
   "Context_Group":"Phones",
   "id":"d747ba0d-e065-55a2-816d-1167632be149",
   "negativeSampling":"100.0",
   "Context_Issue":"Sales",
   "Decision_InteractionID":"-6604045570247117991",
   "dataCenter":"datacenter1",
   "Decision_OutcomeTime":"20160228T000000.000 GMT",
   "Param_FourG":"false",
   "Param_SubscriptionCount":"1.0",
   "Param_OverallUsage":"0.54",
   "Decision_Outcome":"Reject",
   "Param_ChurnSegment":"Low",
   "Decision_DecisionTime":"20191008T101224.796 GMT",
   "Param_Sentiment":"Negative",
   "rulesetName":"DMSample"
}
  • Previous topic Extracting historical responses from adaptive models
  • Next topic Importing adaptive models to another environment

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