React Native Tracking Transparency 使用教程

React Native Tracking Transparency 使用教程

react-native-tracking-transparency 🕵️ A React Native Library for interacting with the tracking API from iOS 14. 项目地址: https://gitcode.com/gh_mirrors/re/react-native-tracking-transparency

1. 项目介绍

react-native-tracking-transparency 是一个用于与 iOS 14 的跟踪 API 进行交互的 React Native 库。该库允许开发者在 iOS 14 及以上版本中请求用户的跟踪权限，并获取当前的跟踪状态。根据 Apple 的要求，应用程序只有在用户授予跟踪权限后才能启用跟踪功能（例如广告 ID 收集）。

2. 项目快速启动

安装

首先，通过 npm 安装 react-native-tracking-transparency 包：

npm install react-native-tracking-transparency

然后，进入 iOS 目录并安装 Pods：

cd ios
pod install

配置

在 Info.plist 文件中添加 NSUserTrackingUsageDescription 键，以描述应用程序为何需要跟踪用户数据：

<key>NSUserTrackingUsageDescription</key>
<string>我们需要您的许可来跟踪您的活动，以便为您提供更好的广告体验。</string>

使用

以下是一个简单的示例，展示如何请求跟踪权限并获取跟踪状态：

import { getTrackingStatus, requestTrackingPermission } from 'react-native-tracking-transparency';

async function checkTrackingStatus() {
  const trackingStatus = await getTrackingStatus();

  if (trackingStatus === 'authorized' || trackingStatus === 'unavailable') {
    // 启用跟踪功能
    console.log('Tracking is enabled');
  } else {
    // 请求跟踪权限
    const newStatus = await requestTrackingPermission();
    if (newStatus === 'authorized') {
      // 启用跟踪功能
      console.log('Tracking is now enabled');
    } else {
      console.log('Tracking permission denied');
    }
  }
}

checkTrackingStatus();

3. 应用案例和最佳实践

应用案例

假设你正在开发一个广告驱动的应用程序，并且需要根据用户的兴趣展示个性化广告。你可以使用 react-native-tracking-transparency 库来请求用户的跟踪权限，并在用户同意后启用广告跟踪功能。

最佳实践

1. 透明度：确保在 NSUserTrackingUsageDescription 中清楚地说明为什么需要跟踪用户数据，以便用户能够做出明智的决定。
2. 用户体验：在请求跟踪权限之前，先向用户解释跟踪的好处，并提供一个明确的“允许”或“拒绝”选项。
3. 兼容性：在 iOS 14 以下版本中，跟踪状态将始终返回 'unavailable'，因此在这些设备上应禁用跟踪功能。

4. 典型生态项目

相关项目

• react-native-permissions：一个用于管理 React Native 应用程序权限的库，可以与 react-native-tracking-transparency 结合使用，以请求和管理其他类型的权限。
• react-native-device-info：提供有关设备的各种信息，包括广告 ID，可以与 react-native-tracking-transparency 结合使用以获取更详细的设备信息。

通过这些项目的结合使用，你可以构建一个功能强大且符合隐私标准的 React Native 应用程序。

react-native-tracking-transparency 🕵️ A React Native Library for interacting with the tracking API from iOS 14. 项目地址: https://gitcode.com/gh_mirrors/re/react-native-tracking-transparency