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.