CAP 跟踪透明插件

电容插件 App 跟踪透明度 框架.

特征

Capacitor App跟踪透明插件是Capacitor App最完整的跟踪授权解决方案之一. 以下是一些关键特征:

• 🔒 授权状态: 读取当前跟踪授权状态.
• 🙋 许可请求: 呈现系统跟踪授权的快取.
• 🆔 广告标识符: 授权时读取广告标识符(IDFA).
• 🤝 兼容性: 与 权限 插件 .
• 📦 可可花和SPM:支持CocoaPods和Swift软件包管理器用于iOS.
• 🔁 最新数据:总是支持最新的Capacitor版本.

缺少一个功能? 刚刚 打开一个问题 我们看看!

使用大小写

App跟踪透明插件通常在iOS应用程序为跟踪目的收集数据时使用,例如:

• 个性化广告:在向用户提供个性化广告前请求跟踪许可.
• 指定归属: 读取广告标识符(IDFA),在用户授权跟踪后,将应用安装归为广告活动.
• 有条件跟踪:检查当前跟踪授权状态,仅在状态时启用跟踪相关功能 authorized。 。 。 .
• App 审查遵守情况:按照苹果公司对任何跟踪用户的应用程序的要求,呈现系统跟踪授权的提示.

兼容性

安装

你可以用我们的 AI 辅助设置 以安装插件. 添加数据 超级技能 至您的 AI 工具,使用以下命令:

npx skills add capawesome-team/skills --skill capacitor-plugins

然后使用下列提示:

 Use the `capacitor-plugins` skill from `capawesome-team/skills` to install the `@capawesome/capacitor-app-tracking-transparency` plugin in my project.

如果你喜欢 手动设置,通过运行以下命令来安装插件,并遵循下面的平台特定指令:

npm install @capawesome/capacitor-app-tracking-transparency
npx cap sync

此插件仅可用于 iOS系统。在Android和Web上,所有方法都否认未执行.

iOS系统

隐私描述

这个 NSUserTrackingUsageDescription 键必须添加到 Info.plist 您的应用程序文件 。 否则 requestPermission(...) 方法会以错误拒绝.

<key>NSUserTrackingUsageDescription</key>
<string>Your data will be used to deliver personalized ads to you.</string>

目的字符串必须明确解释您的应用程序为什么请求权限来跟踪用户 。 见 苹果文档 更多信息.

配置

此插件不需要配置 .

使用量

以下例子显示如何检查跟踪授权状态,请求跟踪许可,并读取广告标识符.

检查跟踪授权状态

读取当前跟踪授权状态,例如决定是否应该启用跟踪相关功能. 仅在iOS上可用 :

import { AppTrackingTransparency } from '@capawesome/capacitor-app-tracking-transparency';

const getStatus = async () => {
  const { status } = await AppTrackingTransparency.getStatus();
  return status;
};

请求跟踪权限

立即提出系统跟踪授权 提示仅在每次安装时显示, 而状态是 notDetermined;之后,该方法与现有状态相适应。 仅在iOS上可用 :

import { AppTrackingTransparency } from '@capawesome/capacitor-app-tracking-transparency';

const requestPermission = async () => {
  const { status } = await AppTrackingTransparency.requestPermission();
  return status;
};

读取广告标识符

读取设备的广告标识符(IDFA). 只有当跟踪授权状态是 authorized否则, null 已返回。 仅在iOS上可用 :

import { AppTrackingTransparency } from '@capawesome/capacitor-app-tracking-transparency';

const getAdvertisingIdentifier = async () => {
  const { advertisingIdentifier } =
    await AppTrackingTransparency.getAdvertisingIdentifier();
  return advertisingIdentifier;
};

API 密码

• getAdvertisingIdentifier()
• getStatus()
• requestPermission()
• 接口
• 类型异名

获取广告标识符( )

getAdvertisingIdentifier() => Promise<GetAdvertisingIdentifierResult>

获取设备的广告标识符(IDFA).

广告标识符只有在跟踪授权时才可用 状态为 authorized否则, null 已返回.

说明: iOS 模拟器总是返回 null,即使跟踪 授权状态是 authorized。使用真正的设备测试这种方法.

仅在iOS上可用.

回返情况: Promise<GetAdvertisingIdentifierResult>

自: 0.1.0 (中文(简体) )

获取状态( C)

getStatus() => Promise<GetStatusResult>

获取当前跟踪授权状态 .

仅在iOS上可用.

回返情况: Promise<GetStatusResult>

自: 0.1.0 (中文(简体) )

请求( )

requestPermission() => Promise<RequestPermissionResult>

请求权限以跟踪用户 .

这将显示系统跟踪授权如果状态 尚未确定。 提示只显示每个安装一次 .

这个 NSUserTrackingUsageDescription 键必须添加到 Info.plist 您的应用程序文件 .

仅在iOS上可用.

回返情况: Promise<RequestPermissionResult>

自: 0.1.0 (中文(简体) )

接口

获取广告 标识符

获取状态

请求豁免

类型异名

跟踪现状

追踪授权状态.

• authorized:用户授权访问应用相关数据进行跟踪.
• denied:用户拒绝访问应用相关数据进行跟踪.
• notDetermined:用户尚未收到跟踪授权请求.
• restricted:跟踪授权受到限制,用户不能更改.

'authorized' | 'denied' | 'notDetermined' | 'restricted'

应用审查指南

苹果公司要求任何跟踪用户通过App跟踪透明框架请求许可的应用程序. 注意以下准则以避免App审查拒绝:

• 及时: 调用 requestPermission(...) 只有在用户处于跟踪有道理的背景中。 系统提示仅在每次安装时显示一次, 而状态是 notDetermined。然后再次调用该方法解决了现有状况,但没有显示及时性.
• 目的字符串编号: NSUserTrackingUsageDescription 目的字符串必须准确描述所收集的数据是如何使用的。 含糊或误导性的说法是拒绝的常见理由.
• 广告标识符: 广告标识符(IDFA)仅在状态时可用 authorized在所有其他情况下, getAdvertisingIdentifier(...) 返回时 null。 。 。 .
• 模拟器:iOS模拟器从未提供广告标识符,所以 getAdvertisingIdentifier(...) 总是返回 null 那里,即使状态是 authorized。使用真实的设备测试广告标识符.

财务问题

此插件与其他类似插件有何不同?

它将Apple的App跟踪透明框架包成一个小而完全打入的API:读取当前授权状态,呈现系统即时,并在用户授权跟踪后读取广告标识符(IDFA). 它还将App Review指南的焦点放在了即时计时,目的字符串,和模拟行为上——这些细节最常决定一个可追踪的应用是否被批准. 它支持CocoaPods和Swift软件包管理器,并被积极维持在最新的Capacitor版本上.

这个插件在Android或Web上工作吗?

不,App跟踪透明框架是一个只使用iOS的概念. 该插件只在iOS上可用;在Android和Web上,所有方法都拒绝作为未执行.

为什么请求允许方法会错误地拒绝?

最常见的原因是失踪了 NSUserTrackingUsageDescription 应用程序中的密钥 Info.plist 文档。 这个密钥是系统跟踪授权即时需要的,其目的字符串必须明确解释为什么您的应用程序请求权限来跟踪用户. 见 安装 详细情况.

为什么没有显示追踪授权?

系统提示只在每次安装时显示, 而跟踪授权状态为 notDetermined。如果用户已经回复了提示,请拨打 requestPermission() 重新解决当前状况,而不显示提示。 为了再次测试提示,重新安装应用程序.

为什么让“广告识别器”返回无效?

广告标识符(IDFA)只有在跟踪授权状态下才能使用 authorized在所有其他情况下, null 已返回。 此外,iOS模拟器从未提供广告标识符,即使状态是 authorized,因此使用一个真正的设备来测试这种方法.

我能用这个插件吗? 有Ionic、React、Vue或Angular?

是的,插件是框架不可知的。 它在任意网络框架的Capacitor app中工作,包括有Angular,React,或Vue的Ionic,以及平版JavaScript等项目.

相关插件

• 权限:以统一的API检查并请求设备权限.
• 隐私屏幕:在应用切换器中隐藏敏感的应用内容并屏蔽截图.

通讯

随时更新有关卡帕韦索姆、Capacitor和Ionic生态系统的最新消息和最新消息,因为我们 《卡帕索克通讯》。 。 。 .

更改日志

见 变动情况。 。 。 .

许可证

见 自由主义。 。 。 .