Q42Stats

Collect stats for Q42 internal usage, shared accross multiple iOS projects.

Installation

Use the Swift package manager to add Q42Stats into your iOS project
Implement your configuration and a SHA256 implementation (see reference implementations below)
Include stats collection & submission in your AppDelegate/WindowSceneDelegate like so:

Q42Stats(options: .all)
  .collect(window: window, completion: Q42Stats.submit(configuration: .myApp))

Note: Make sure you have the correct consent from the user before you call .collect().

Swift Package Manager

Add this repo as a dependency through Xcode: https://github.com/Q42/Q42Stats.git

Reference implementations

Example configuration implementation

extension Q42Stats.Configuration {
  static let myApp = Q42Stats.Configuration(
    apiKey: "secret",
    firestoreCollection: "somecollection",
    minimumSubmitInterval: 60*60*24*7.5
  )
}

Performance

The library is approximately 72 kB. The data usage is very modest. About 5 kB of data is sent. The impact that the data collection has on the performance of an app is negligible.

Data collected

Q42Stats does not collect personal data, the data collected can not be related to an identified or identifiable individual. It is good practice to inform users of data collection, consent is not required within European law. This has been verified by legal counsel.

Accessibliity

Key	Value	Notes
`Accessibility_isSwitchControlRunning`	boolean	Control the device by a switch such as a foot pedal
`Accessibility_isBoldTextEnabled`	boolean	Improves the contrast of the letters against the background
`Accessibility_isReduceTransparencyEnabled`	boolean	Makes system windows, overlays and other transparent elements opaque or less transparent
`Accessibility_isMonoAudioEnabled`	boolean	Sends the left and right channels of stereo sound through both channels
`Accessibility_isClosedCaptioningEnabled`	boolean	Automatically activates closed captions for videos in the user’s preferred language when facilitated by the creator of the video
`Accessibility_isDarkerSystemColorsEnabled`	boolean	Increases the contrast between the various elements on the screen
`Accessibility_isGuidedAccessEnabled`	boolean	Limits a device to a single app and lets a user control which features are available. E.g. turned on when accidental gestures might distract a user
`Accessibility_isAssistiveTouchRunning_with_isGuidedAccessEnabled`	string	`Accessibility_isAssistiveTouchRunning` will only be the correct value if `Accessibility_isGuidedAccessEnabled` is `true`. See: Apple's developer documentation
`Accessibility_uses_any_accessibility_setting`	boolean	True if one or more accessibility settings are activated
`Accessibility_isVoiceOverRunning`	boolean	With VoiceOver—a gesture-based screen reader—you can use an iPhone even if you can’t see the screen. VoiceOver gives audible descriptions of what’s on your screen
`Accessibility_isInvertColorsEnabled`	boolean	Indicates whether the Classic Invert setting is in an enabled state
`Accessibility_isSpeakSelectionEnabled`	boolean	Allows text to be read aloud. When you select a piece of text, the option to have it read aloud appears
`Accessibility_isShakeToUndoEnabled`	boolean	Undoes the last text entry when the phone is shaken, making it easy to delete text. People turn off this option if there is a risk that they will activate it unintentionally
`Accessibility_isSpeakScreenEnabled`	boolean	Ensures that everything on the screen is read aloud when you swipe down with two fingers
`Accessibility_isGrayscaleEnabled`	boolean	Turn on black and white mode

Preferences

Key	Value	Notes
`Preference_daytime`	string	Coarse estimation of time of day “day”, “night”, “twilight”. Returns “unknown” when user is not in Amsterdam TimeZone
`Preference_UI_style`	string	Indicate the interface style for the app “unspecified”, “light”, or “dark”
`Preference_preferred_content_size`	string	The preferred size of your content, more commonly known as the font-size. For a full list of possible values see Apple’s developer documentation

Screen

Key	Value	Notes
`Screen_window_width`	integer	Width of app’s viewport. This can differ from screen width when in split screen mode, for example
`Screen_width`	integer	Device’s screen width
`Screen_display_gamut`	string	The colorspace that is used, representing the colors that can be represented on screen. Possible values: “Uspecified”, “SRGB”, “P3”
`Screen_device_idiom`	string	Kind of User Interface being used, e.g. iPhone, iPad, Mac, AppleTV
`Screen_zoomed`	boolean	True if the entire screen or a part of the screen is magnified
`Screen_in_split_screen`	boolean	Indicates if apps are displayed in split screen mode
`Screen_orientation`	string	Indicates if device is in landscape or in portrait mode
`Screen_scale`	string	The natural scale factor associated with the screen. For Retina displays, the scale factor may be 3.0 or 2.0. For standard-resolution displays, the scale factor is 1.0

System

Key	Value	Notes
`System_Dutch_region`	boolean	Indicates if preferred language is dutch or the current region code is “NL”
`System_Preferred_language`	string	Language setting of the device e.g. nl, en, …
`System_OS_major_version`	string	Current version of the operating system in use e.g. 13, 14 or 15
`System_model_name`	string	A more human-readable model name of the device e.g. “iPad Pro”, “iPhone XR” or “iPhone 13”
`System_model_id`	string	Device model as a string. The format is something like “iPhone12,1” which stands for iPhone 11. Or "iPhone13,3" which stands for iPhone 12 Pro

Apple Pay

Key	Value	Notes
`Apple_Pay_available`	boolean	True if a user can make payments with Apple Pay
`Apple_Pay_with_Maestro_available`	boolean	True if maestro is available to make payments with

Watch

Key	Value	Notes
`Watch_supported`	boolean	Boolean value indicating if the current device supports watch connectivity
`Watch_paired`	boolean	True if an Apple Watch is paired

App

Key	Value	Notes
`App_bundle_identifier`	string	Identifier for the app for which data is collected

Stats

Key	Value	Notes
`Stats_timestamp`	string
`Stats_version`	string

Swiftpack.co - Q42/Q42Stats as Swift Package