CPPs

A Customer Passed Parameter (CPP) is a data point created by (or currently available in) your app, which is captured by Verint XM code and sent with a survey submission. CPPs provide additional data for analysis without increasing the number of questions asked on the survey.

📘

Note

Many Verint XM clients opt to provide their app version as a CPP, which helps greatly when it comes to analyzing changes in customer satisfaction between app upgrades.

(No longer required as of SDK version 4.3.0)

Using CPPs

Clients can define CPPs in two ways:

1. In foresee_configuration.json: There is a cppParameters key in the JSON file that is a collection of key-value pairs.
2. In code via the SDK: You can use the ForeSee.addCppValue("key", "value"), ForeSee.setCPPValueFromArray("key", "valuesArray") or ForeSee.appendCPPValue("key", "value") methods to dynamically add CPPs. This is useful when you want to add CPPs based on specific conditions.

Default CPPs

By default, the SDK automatically captures and sends the following device-related CPPs with the survey:

• model_name
  The model name of the device (e.g. GT-S7560M)
• brand_name
  The brand name of the device (e.g. Samsung).
• browser
  The browser, e.g., Android WebKit.
• os
  The device's operating system (e.g. Android).
• os_version
  The operating system version (e.g. 11).
• is_tablet
  ‘True’, if the device is a tablet.
• resolution_width
  Screen width in pixels.
• resolution_height
  Screen height in pixels.
• screen_width
  Screen width in millimeters.
• screen_height
  Screen height in millimeters.
• locale
  The device's locale (e.g. en_US).
• dual_orientation
  ‘True’, if the device supports dual orientation (always 'true' on iOS devices).
• language
  The device's language (e.g. en).
• client_version
  The value of versionName in your app's package.
• client_build_num
  The value of versionCode in your app's package.
• trigger_version
  The version of the Verint XM SDK that is installed in your app
• pointing_method
  Always 'touchscreen' on Android devices.
• notification_type
  Type of survey invitation
• product_type
  Always 'in-app' on Android devices.