App Channel List Permission Fields

Oracle Responsys tracks individual opt-in statuses for various mobile features so that marketers can target only relevant devices with their campaigns. Marketers can use these permission fields as attributes in a filter, and then target the filter with a campaign. See the list of App channel list system fields.

Permission-related fields

Field name Support for which operating system(s) Description Field values

CHANNEL_PERMISSION_STATUS_

 iOS and Android This column tells marketers whether or not a user has opted in to receive push notification from their device.
  • I: Opted-in
  • O: Opted-out

PUSH_PERM_AUTH_STATUS_

Note: The release 19D SDK onwards is required for this column to be populated.

iOS

When an iOS app implements iOS Provisional Authorization, this column indicates whether the iOS user is still in the Provisional Authorization state (P) or not. When an iOS app is installed with Provisional Authorization:

  • The application is automatically opted-in to Push Notifications and is provisionally authorized to "Deliver Quietly," that is to only share non-interruptive notifications with the user.
  • Push Notifications do not interrupt the user by appearing on the device's lock screen or as banners.

For such iOS apps, this column is set to P (Provisionally Authorized) when the user is still Provisionally Authorized and has not updated Push Notification permissions on the device after app installation. The purpose of this column is to let marketers take decisions based on whether or not a certain user is Provisionally Authorized.

To identify a user that is Provisionally Authorized using a filter:

  1. Open or create an App Channel List filter that's using Profile Data.
  2. Drag and drop the PUSH_PERM_AUTH_STATUS_ attribute under the Profile attributes section.
  3. Select matches for the condition.

    Tip: To identify a user that is not Provisionally Authorized, select does not matchinstead of matches for the value P. Additionally, you will need to drag and drop another PUSH_PERM_AUTH_STATUS_ attribute and select does not match for the value NULL.

  4. Type P into the textboxt.
  • P: The iOS user is Provisionally Authorized and has not updated Push Notification permissions on the device since installation. The user will receive non-interruptive notifications. See definition in Apple Developer Documentation.
  • U: The iOS user has not indicated whether they want to receive notifications from the app. This value does not apply to apps that implement Provisional Authorization. See definition in Apple Developer Documentation.
  • A: The iOS user has indicated that they want to receive notifications from the app. See definition in Apple Developer Documentation.
  • D: The iOS user has indicated that they do not want to receive notifications from the app. See definition in Apple Developer Documentation.
  • NULL / Empty: Indicates that the status of PUSH_PERM_AUTH_STATUS_ is unknown for the user. 

PUSH_PERM_BADGES_

Note: The release 19D SDK onwards is required for this column to be populated.

 iOS This column indicates whether the iOS user has opted in to App Icon Badging on this iOS device. This could be set to either I (Opted-In) or O (Opted-Out), to reflect the user preferences on the iOS device.
  • I: Opted-in
  • O: Opted-out
  • NULL / Empty: Indicates that the status for PUSH_PERM_BADGES_ is unknown for the user. 

APP_LOCATION_PERMISSION_

Note: The release 19D SDK onwards is required for this column to be populated.

 iOS and Android

This column indicates whether or not the app user has granted the app access to location services on the device.

Important: Both Android and iOS make frequent updates to the Location Access Permission Model. Any future updates to the Location Access Permission Model for iOS / Android will require an SDK update.

For iOS:

  • U: The user has not indicated whether they want the app to use location services. See definition in Apple Developer Documentation.
  • W: The user has indicated that the app can use location services only when-in-use (that is, when the app runs in the foreground). See definition in Apple Developer Documentation.
  • A: The user has indicated they want the app to always use location services. See definition in Apple Developer Documentation.
  • N: The user has indicated that the app cannot use location services. See definition in Apple Developer Documentation.
  • R: Due to restrictions on the device, the app cannot use location services. See definition in Apple Developer Documentation.
  • NULL/Empty: Indicates that the status for APP_LOCATION_PERMISSION_ is unknown for the user. 

For Android:

  • W: The user has indicated that the app can use location services only when-in-use (that is, when the app runs in the foreground).

    Note: This value is only relevant for Android Q onwards.

  • A: The user has indicated they want the app to always use location services.
  • N: The user has indicated that the app cannot use location services.
  • NULL/Empty: Indicates that the status for APP_LOCATION_PERMISSION_ is unknown for the user. 

Learn more