{"_id":"59e70b9fe027ae002e7d2f29","category":{"_id":"59e70b9ee027ae002e7d2ed4","version":"59e70b9ee027ae002e7d2ed2","project":"5496d393f52a630b00519cdd","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-12-01T11:28:38.565Z","from_sync":false,"order":1,"slug":"getting-started-ios","title":"iOS Reference"},"project":"5496d393f52a630b00519cdd","user":"5496d353f52a630b00519cdc","parentDoc":null,"version":{"_id":"59e70b9ee027ae002e7d2ed2","project":"5496d393f52a630b00519cdd","__v":2,"createdAt":"2017-10-18T08:06:54.462Z","releaseDate":"2017-10-18T08:06:54.462Z","categories":["59e70b9ee027ae002e7d2ed3","59e70b9ee027ae002e7d2ed4","59e70b9ee027ae002e7d2ed5","59e70b9ee027ae002e7d2ed6","59e70b9ee027ae002e7d2ed7","59e70b9ee027ae002e7d2ed8","59e70b9ee027ae002e7d2ed9","59e70b9ee027ae002e7d2eda","59e70b9ee027ae002e7d2edb","59e70b9ee027ae002e7d2edc","59e70b9ee027ae002e7d2edd","59e70b9ee027ae002e7d2ede","59e70b9ee027ae002e7d2edf","5b8661ccdd19310003a3fa0b"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"2.0.10","version":"2.0.10"},"githubsync":"","__v":0,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-08-09T10:52:39.048Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":7,"body":"In order to support Foreground only mode:\n  * Follow the [iOS - Quick Start](doc:ios)  integration steps \n  * In Step 3: Include *only* the \"**NSLocationWhenInUseUsageDescription**\" (with your location tracking use case description) in the app's plist file. Make sure you don't include the \"**NSLocationAlwaysAndWhenInUseUsageDescription**\" or \"**NSLocationAlwaysUsageDescription**\". \n\n**All Done!**\nPlacer will collect device signals and generate user insights when the app is in the foreground.","excerpt":"In this mode Placer will collect signals only when the app is active. Profiles in this mode are partial since signals collection is limited to when the user is using the app.","slug":"foreground-only-mode-1","type":"basic","title":"Foreground Only Mode"}

Foreground Only Mode

In this mode Placer will collect signals only when the app is active. Profiles in this mode are partial since signals collection is limited to when the user is using the app.

In order to support Foreground only mode: * Follow the [iOS - Quick Start](doc:ios) integration steps * In Step 3: Include *only* the "**NSLocationWhenInUseUsageDescription**" (with your location tracking use case description) in the app's plist file. Make sure you don't include the "**NSLocationAlwaysAndWhenInUseUsageDescription**" or "**NSLocationAlwaysUsageDescription**". **All Done!** Placer will collect device signals and generate user insights when the app is in the foreground.