> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# OneSignal SDK收集的数据

> OneSignal SDK自动、手动和/或通过用户许可收集的数据字段——以及如何控制数据收集以确保隐私合规。

OneSignal SDK会自动、手动以及通过用户权限收集数据。要自定义SDK收集的数据以及如何管理同意，请参阅[处理个人数据](./handling-personal-data)。大多数数据可以[从仪表板或API导出](./exporting-data)。

## 用于受众细分的数据

以下数据可通过[细分](./segmentation)定位受众：

| 数据     | 描述                                                                                |
| ------ | --------------------------------------------------------------------------------- |
| 首次会话时间 | 用户首次使用应用/访问网站的日期和时间（UTC）。                                                         |
| 最后会话时间 | 用户最近使用应用/访问网站的日期和时间（UTC）。                                                         |
| 会话计数   | 用户使用应用/访问网站的次数。                                                                   |
| 总使用时长  | 用户与应用交互的总秒数，记录应用在前台时的时间。                                                          |
| 设备操作系统 | 设备/浏览器的操作系统。                                                                      |
| 设备语言   | 设备/浏览器报告的语言。也可以通过SDK语言方法设置。                                                       |
| 时区     | 设备/浏览器所在的最近时区，采用[IANA TZ](https://en.wikipedia.org/wiki/Tz_database)格式。           |
| 国家     | 设备/浏览器所在的最近国家，采用[ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)格式。         |
| 推送权限状态 | 设备/浏览器是否启用或禁用推送通知。                                                                |
| 应用版本   | **仅移动端** — 最近会话报告的应用版本。                                                           |
| 位置     | **仅移动端** — 设备的GPS坐标。必须[开启位置跟踪并获得用户接受](./handling-personal-data#location-sharing)。 |

## 不可用于细分的数据

OneSignal SDK还收集以下数据，但这些数据不能用于细分：

| 数据                    | 描述                                                                                                       |
| --------------------- | -------------------------------------------------------------------------------------------------------- |
| 应用标识符                 | **仅移动端** — 移动应用的包名。                                                                                      |
| 移动运营商                 | **仅移动端** — 设备使用的移动运营商名称。                                                                                 |
| 设备型号                  | 设备/浏览器的型号名称。                                                                                             |
| IP地址                  | 设备/浏览器访问的IP地址。EU用户的IP地址不会存储在OneSignal服务器上。请参阅[处理IP地址跟踪](./handling-personal-data#ip-address-collection)。 |
| `web_auth`和`web_p256` | 可从[API CSV导出](/reference/csv-export)中导出的网络推送订阅令牌。                                                        |
| 推送令牌                  | FCM或APNs添加到设备的移动应用和网络推送令牌。                                                                               |

## 您手动发送给OneSignal的数据

您可以选择向OneSignal发送以下数据。详情请参阅[处理个人数据](./handling-personal-data)。

| 数据    | 描述                                  |
| ----- | ----------------------------------- |
| 邮箱    | 如果您希望使用OneSignal向用户发送邮件，可提供用户的邮箱地址。 |
| 手机号码  | 如果您希望使用OneSignal向用户发送短信，可提供用户的手机号码。 |
| 标签    | 关于用户的任何额外数据，以键值对的形式存储，用于细分和个性化。     |
| 自定义事件 | 关于用户的任何额外数据，以键值对的形式存储，用于细分和个性化。     |

## Web SDK浏览器存储

Web SDK使用的标识符、用途和浏览器存储类型：

| 标识符名称                                                    | 用途                | 类型                 |
| -------------------------------------------------------- | ----------------- | ------------------ |
| `ONE_SIGNAL_SDK_DB`                                      | 存储与通知权限状态相关的用户偏好。 | IndexedDB字典，在客户域上。 |
| `os_pageViews`,`isOptedOut`,`isPushNotificationsEnabled` | 提示和订阅跟踪           | 本地存储               |
| `onesignal-pageview-count`,`ONESIGNAL_HTTP_PROMPT_SHOWN` | 提示                | 会话存储               |

## 常见问题

### 我可以禁用所有自动数据收集吗？

部分数据可以禁用。您可以通过[处理个人数据](./handling-personal-data)指南自定义SDK收集的数据并管理用户同意，包括禁用位置共享、IP地址收集等。

### OneSignal是否为EU用户存储IP地址？

不会。对于位于EU的用户，OneSignal不会在其服务器上存储IP地址。有关配置详情，请参阅[处理IP地址跟踪](./handling-personal-data#ip-address-collection)。

### Web SDK使用哪种浏览器存储？

Web SDK使用IndexedDB、本地存储和会话存储来管理通知权限状态、提示和订阅跟踪。有关标识符的完整列表，请参阅上方[Web SDK浏览器存储](#web-sdk浏览器存储)部分。

<Columns cols={2}>
  <Card title="处理个人数据" icon="shield-halved" href="./handling-personal-data">
    管理用户同意并自定义OneSignal SDK收集的数据。
  </Card>

  <Card title="导出数据" icon="file-export" href="./exporting-data">
    从OneSignal仪表板或API导出用户和设备数据。
  </Card>
</Columns>
