customerPerspective
The customerPerspective variable specifies whether a mobile app hit occurred while the app was in the foreground or the background. It is sent to Adobe data collection as the cp query parameter and populates the Hit type dimension.
Valid values
customerPerspective accepts the following string values:
foreground: The hit occurred while the app was in active use.background: The hit occurred while the app was running in the background, such as a location update or a hit triggered by a push notification.
How this variable is set
The Adobe Mobile SDK (version 4.13.6 and higher) sets customerPerspective automatically; you do not typically set it manually. Hits sent from a browser through AppMeasurement always report as foreground. If the variable is absent from a hit, that hit is treated as a foreground hit.
Impact on reporting
The foreground/background distinction affects how visits are processed:
- Visits are counted only when they contain at least one foreground hit.
- Background hits can still be attributed to conversion events and can be analyzed through context-aware sessions in virtual report suites. This behavior is useful when measuring the effectiveness of push notifications.
recommendation-more-help
analytics-help-implement