CPPs
A Customer Passed Parameter (CPP) is a data point created by (or currently available in) your app, which 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.
Warning
CPPs cannot contain white space.
Using CPPs
The client can define CPPs in two ways:
- In
foresee_configuration.json
- The JSON configuration supports acppParameters
key containing a collection of key-value pairs. For example:
"cppParameters": {
"AppVersion": "<YOUR APP VERSION>"
}
- In code via the SDK - The client can use
[ForeSee setCPPValue:forKey:]
(and related methods) to dynamically add CPPs. This is useful when adding CPPs based on specific conditions. Full Documentation of these methods is available in the API documents.
Since version 3.4.3 of the SDK, CPPs are persisted between sessions. Although CPPs are removed when the repeatDays
threshold is met, there may be other situations in which you 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.os
The device's 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 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 ofCFBundleShortVersionString
in the client app'splist
.client_build_num
The value ofCFBundleVersion
in the client app'splist
.platform
Device model information (e.g. x86_64).pointing_method
Always 'touchscreen' on iOS devices.notification_type
Type of survey invitationproduct_type
Always 'in-app' on iOS devices.
Updated over 2 years ago