<!--
{
  "documentType" : "article",
  "framework" : "Analytics Reports",
  "identifier" : "/documentation/Analytics-Reports/nearby-interaction-sessions",
  "metadataVersion" : "0.1.0",
  "role" : "article",
  "title" : "Nearby Interaction Sessions"
}
-->

# Nearby Interaction Sessions

Analyze how often your app starts an Ultra Wideband (UWB) ranging session through Nearby Interaction.

## Overview

The data in this report details the aggregated number of Ultra Wideband ranging sessions your app starts by using the Nearby Interaction framework.

- Territories: Worldwide
- Platforms: iOS, iPadOS.  For more information about iOS and iPadOS, see the Platforms section in [Data Completeness and Corrections](/documentation/Analytics-Reports/data-completeness-corrections).
- Availability:
  - Daily: Every day.
- History: On request, data is available beginning with iOS 17.4 and iPadOS 17.4.
- Completeness: Data from devices that contribute to this report can arrive as late as 8 days after the date it generates on device. You can download recent data daily, but it might be incomplete, and data updates incrementally daily, until all late-arriving events are available.
- Privacy:
  - Includes data from users who have opted to share their data with Apple and developers.
  - Individual rows will only appear if they have a value of 5 or more.
- Data Context: You can analyze your data with additional context by comparing it with the data in the [App Sessions Context](/documentation/Analytics-Reports/app-sessions-context) report, which provides a count of unique devices that use your app on a specific day. For example, if your app performed an action detailed in this report on 10 unique devices on a specific day, and the App Sessions Context report shows there were 100 unique devices running your app that day, then you can approximate that 10% of the devices running your app performed that action.

## Report Fields

|Report Field                            |Description                                                                                                                                                                                                             |Data Type|
|----------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------|
|Count                                   |Number of times the event occurred                                                                                                                                                                                      |`integer`|
|Territory                               |Country or region in which the event occurred                                                                                                                                                                           |`string` |
|Date                                    |Date when the event occurred                                                                                                                                                                                            |`string` |
|Platform                                |OS version on the device on which the event occurred                                                                                                                                                                    |`string` |
|Device                                  |Type of device on which the event occurred                                                                                                                                                                              |`string` |
|Build                                   |Build of device on which event occurred                                                                                                                                                                                 |`string` |
|Unique Devices                          |The count of unique devices                                                                                                                                                                                             |`integer`|
|Release Type                            |Type of software release                                                                                                                                                                                                |`string` |
|Config Type                             |The session’s configuration type, as provided by the app. The configuration type determines how the session operates, for example, “Peer” for Apple to Apple ranging, or “Accessory” for ranging to third-party devices.|`string` |
|Configured Background Mode              |A configured background mode that is an enumeration.                                                                                                                                                                    |`integer`|
|Is Camera Assistance Enabled            |Camera assistance enabled for the session.                                                                                                                                                                              |`boolean`|
|Is Extended Distance Measurement Enabled|True if the app requested the “extended distance measurement” mode, which is available on second-generation Ultra Wideband chips. This mode enables longer operating range.                                             |`boolean`|
|Is Live Activity Active                 |True if the app has an active live activity during the session. If the app has an active live activity, it can continue the session if the app is in the background.                                                    |`boolean`|

## Glossary

|Dimension  |Value    |Definition                                                                |
|-----------|---------|--------------------------------------------------------------------------|
|Config Type|Peer     |The app started a session between two Apple devices                       |
|Config Type|Accessory|The app started a session between an Apple device and a third-party device|

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)