Trigger - CPP’s

A Customer Passed Parameter (CPP) is a data point created by (or currently available in) the client’s app that is captured by ForeSee code and sent with a survey submission. CPPs provide additional data for analysis without increasing the number of questions asked on the survey.

Many 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.

Using CPPs

The client can define CPPs in two ways:

  1. In foresee_configuration.json – The JSON configuration supports a cppParameters key containing a collection of key-value pairs. For example:
    "cppParameters": {
        "AppVersion": "<YOUR APP VERSION>"
  2. In code via the SDK – The client can use the method [ForeSee addCPPValue:forKey:] to dynamically add CPPs. This is useful when adding CPPs based on specific conditions.

Since version 3.4.3 of the SDK, CPPs are persisted between sessions. Although CPPs will be removed when the repeatDays threshold is met, there may be other situations in which you’d want to erase a CPP. Use [ForeSee removeCPPValueForKey:] to dynamically remove the CPP for a specific key.

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., iPhone, iPad
  • brand_name
    The brand name of the device, e.g., Apple
  • browser
    The version of Safari.
  • osThe device operating system, e.g., iOS
  • os_version
    The operating system version, e.g., 7.1.2
  • is_tablet
    ‘True’ if the device is an iPad
  • resolution_width
    Screen width in pixels
  • resolution_height
    Screen height in pixels
  • screen_width
    Screen width in mm
  • screen_height
    Screen height in mm
  • locale
    The device’s locale, e.g., en_US

Other articles in this section:

  1. Trigger Overview
  2. Invite Modes
  3. Repeat Days
  4. Sampling
  5. Multiple Measures
  6. CPP's (current article)
  7. Localization
  8. SDK Events
  9. Page views
  10. Custom Invites