OG Data Collection

The Observation Graph SDK collects a variety of data points to enable enterprises, marketers and developers to better understand customer behavior, target potential buyers and create compelling user experiences. Please review carefully our Privacy Policy.

Factual proactively created policies and practices to use data responsibly and to protect personal information and location data. Please find below a breakdown of the information collected by Factual OG’s iOS and Android SDKs.

OG Android SDK

Data exchange between the OG SDK and the Factual backend
Configuration
Data sent to the Factual backend. Required calls to enable the OG SDK. Call is made once per 24 hour or on SDK restart.

Name Description
API Key Factual API Key
OG SDK Version OG SDK Version #


Generic Information

Name Description
OG SDK Status Stopped, started
Factual User ID Factual user unique identifier
App Name App bundle
Organization ID An organization might have many app ids
Device ID Device unique identifier (either GAID or generated GUID)
Advertiser ID Google advertiser id
Make Device manufacturer
Model Device Model
OS Device operating system
OS Version Device operating system version
Preferred Language Device current language using ISO-639-1
Carrier Carrier name
Carrier Country Carrier Country (2 letters ISO code)
App State Foreground, Background, Unknown
Connection Type Network connection type


Location Data Information

Name Description
Entry Timestamp Timestamp in milliseconds of when the entry was added
Entry Type Location or on demand location
Sensor Timestamp When the event occured
Request Timestamp When the location request was made
Received Timestamp When the OS reported the event to the OG SDK
Dwell Time Dwell time spent by a device at the associated location
Location Data Type Source of location data. Refer to List 5.20 of the OpenRTB 2.5 spec
Latitude Latitude of device as reported by OS
Longitude Longitude of device as reported by OS
Horizontal Accuracy Horizontal accuracy in meters as reported by the OS
Speed Speed in meters per second as reported by the OS
Activity Activity as reported by the OS (Stationary, Walking)
Bearing Direction as reported by the OS (North, South…)
Altitude Altitude in meters as reported by the OS
Altitude Accuracy Altitude accuracy in meters as reported by the OS
Floor Level Floor of the building on which the device is located, as reported by the OS


Permission Required

Permission Name Description
uses-permission android:name=”android.permission.ACCESS_FINE_LOCATION” Enables most accurate location
uses-permission android:name=”android.permission.INTERNET” Enables Factual to send data to the cloud
uses-feature android:name=”android.hardware.location.gps” Enables GPS access
uses-feature android:name=”android.hardware.location.network” Enables location updates via WiFi and Cellular Networks


Compatibility
Android API level support: 20
Google Play Version: 11.0.4

OG iOS SDK

Data exchange between OG and the Factual backend
Configuration
Data sent to the Factual backend. Required calls to enable the OG SDK. Call is made once per 24 hour or on SDK restart.

Name Description
API Key Factual API Key
OG SDK Version OG SDK Version #


Generic Information

Name Description
OG SDK Status Stopped, started
Factual User ID Factual user unique identifier
App Name App bundle
Organization ID An organization might have many app ids
Device ID Device unique identifier (either IDFA or generated GUID)
Advertiser ID Apple advertiser id
Make Device manufacturer
Model Device Model
OS Device operating system
OS Version Device operating system version
Preferred Language Device current language using ISO-639-1
Carrier Carrier name
Carrier Country Carrier Country (2 letters ISO code)
App State Foreground, Background, Unknown
Connection Type Network connection type


Location Data Information

Name Description
Entry Timestamp Timestamp in milliseconds of when the entry was added
Entry Type Location or on demand location
Sensor Timestamp When the event occured
Request Timestamp When the location request was made
Received Timestamp When the OS reported the event to the OG SDK
Dwell Time Dwell time spent by a device at the associated location
Location Data Type Source of location data. Refer to List 5.20 of the OpenRTB 2.5 spec
Latitude Latitude of device as reported by OS
Longitude Longitude of device as reported by OS
Horizontal Accuracy Horizontal accuracy in meters as reported by the OS
Speed Speed in meters per second as reported by the OS
Activity Activity as reported by the OS (Stationary, Walking)
Bearing Direction as reported by the OS (North, South…)
Altitude Altitude in meters as reported by the OS
Altitude Accuracy Altitude accuracy in meters as reported by the OS
Floor Level Floor of the building on which the device is located, as reported by the OS


Permission Required

Permission Name Description
Location “When in Use” or “Always” The user permits location for the app

App Plist Declaration

Key Description
NSLocationWhenInUseUsageDescription Message displayed to users on location permission request
NSLocationAlwaysAndWhenInUseUsageDescription Message displayed to users on location permission request
UIBackgroundModes location Location updates background mode


Compatibility
iOS supported version: iOS 8 to 11.1.3