Skip to main content

 –

JSON file structure for historical data

Suggest edit Updated on March 11, 2021

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"
}
Did you find this content helpful? YesNo

Have a question? Get answers now.

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

Ready to crush complexity?

Experience the benefits of Pega Community when you log in.

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