发行说明

查看 Tapjoy Offerwall iOS SDK 变更日志以了解版本更新、错误修复和功能弃用情况。

阅读时间14 分钟

最后更新于 3 个月前

14.6.0 (2025-11-20)

使用 Xcode 26.0 进行构建。
内部改进。

14.5.0 (2025-10-10)

添加了对 iPadOS 窗口化模式的支持。
已弃用 TJActionRequest。
使用 Xcode 16.4 进行构建。

14.4.0 (2025-06-03)

最低 iOS 版本增加到 iOS 13.0。
修复了与会话数据相关的崩溃。

14.3.1 (2025-04-25)

修复了连接时可能崩溃的错误。

14.3.0 (2025-04-07)

日志记录改进：
- 已弃用
```
[Tapjoy setDebugEnabled:YES]
```
  并将其替换为
```
[Tapjoy setLoggingLevel:TJLoggerLevelDebug]
```
  。
- 已弃用
```
TJC_OPTION_ENABLE_LOGGING
```
  并将其替换为
```
TJC_OPTION_LOGGING_LEVEL
```
  。
- 日志级别为：Error（错误）、Warning（警告）、Info（信息）和 Debug（调试）。
向 EasyApp 添加了购买和货币值输入。

14.2.1 (2024-12-09)

版本号提升。

14.2.0 (2024-12-04)

向隐私清单添加了追踪域。
使用 Xcode 16.0 构建 SDK。
已弃用 TJPlacement didClick 回调。
已弃用 getSupportURL。
修复了 EasyApp (Objc) ATT 提示。
移除了对 iOS 10 + 11 的支持。

14.1.1 (2024-10-15)

版本号提升以匹配 Android。

14.1.0 (2024-10-02)

已弃用 PPE。
对 EasyApp 进行了小修复。
使用 Xcode 15.4 进行构建。

14.0.1 (2024-07-16)

修复了动态框架签名问题。

14.0.0 (2024-07-01)

向隐私清单添加了 NSPrivacyCollectedDataTypeEmailAddress。
添加了静态框架支持。Cocoapods 安装默认为静态。
添加了 getUserID getter
```
[Tapjoy getUserID]
```
。
修复了 iOS 17.4+ 上的 SKStoreProductViewController 展示问题。
清理了 C++ 头文件。

已弃用 userID 属性

[[Tapjoy sharedTapjoyConnect] userID]

。改用

[Tapjoy getUserID]

。

移除了已弃用的推送通知接口。
移除了已弃用的 limitedConnect/广告位接口。
移除了已弃用的 UserCohortVariables 接口。
移除了已弃用的 InstallReferrer 接口。
移除了已弃用的 CustomEvents 接口。
移除了已弃用的 PrivacyPolicy 接口。
移除了已弃用的 UserFriendCount 接口。
移除了已弃用的聚合/广告竞价日期接口。
移除了已弃用的 setUserId 接口。
移除了已弃用的 store 属性。
移除了已弃用的 analyticsApiKey 属性。
修复了 Swift EasyApp 不显示 ATT 提示的问题。
修复了在 Objective-C EasyApp 中连接之前按下“show offerwall（显示 Offerwall）”按钮时不会启用该按钮的问题。
修复了刘海屏设备在 EasyApp 中显示 Offerwall Discover 部分时存在的视觉问题。
修复了 Swift EasyApp 在恢复运行时调用 connect 的问题。

已知问题

证书到期

如果收到 Offerwall SDK 证书已到期的消息，可能需要清除缓存或更新到最新的 SDK 版本。如需了解更多信息，请参阅 Monetization（变现）常见问题解答。

Cocoapods


pod cache clean TapjoySDK --all

Swift Package Manager


rm -rf ~/Library/Caches/org.swift.swiftpm ~/Library/org.swift.swiftpm

手动集成

删除 .xcframework。
从后台下载新副本。

捆绑包无效

Cocoapods Dynamic/Swift Package Manager 签名问题。由于捆绑包无效，构建将无法上传到应用商店。更新到 14.0.1 来解决问题。

13.4.1 (2024-03-19)

修复了设置 AppLaunch 广告位用户 ID 时出现的错误。

13.4.0 (2024-03-04)

添加了对 Swift Package Manager 的支持。
添加了
```
onConnectWarning
```
回调。
移除了推送通知。

13.3.0 (2023-11-30)

添加了 PrivacyManifest，包括 Nutrition 标签和 Required Reason API。
使用
```
Tapjoy, Inc.
```
证书对 XCFramework 进行签名。
从静态框架更改为动态框架。
不再发送 Friend Count（好友数量）数据。API 在 13.2.0 中已弃用，并将在 14.0.0 中移除。
不再发送 User Cohort Variable（用户群组变量）数据。API 在 13.2.0 中已弃用，并将在 14.0.0 中移除。
错误修复和改进。

13.2.1 (2023-10-05)

修复了 modulemap 警告。

13.2.0 (2023-09-27)

新增用于设置最大用户等级的 API。
新增用于设置用户细分段的 API。
新增用于设置货币余额的 API（仅限自管货币）。
新增用于设置货币需求的 API。
新增用于设置广告位入口点的 API。
已弃用聚合和视频方法/回调。
已弃用推送通知。
已弃用 limitedConnect。
向 C++ 接口添加了连接标志。
向 C++ 接口添加了 TJStatus。
改进了支出/获得货币的方法。
现在将在连接失败回调中返回错误消息。已弃用不带参数的处理程序。
错误修复。

13.1.2 (2023-07-14)

版本号提升以匹配 Android。

13.1.1 (2023-06-30)

版本号提升以匹配 Android。

13.1.0 (2023-06-28)

添加了 Tapjoy 托管货币回调的错误消息。
向 C++ 接口添加了
```
setUserID withCompletion
```
方法。
更新了隐私政策界面。
向 Swift EasyApp 添加了 Offerwall Discover UI。
向 EasyApp UI 添加了隐私政策设置。
修复了使用 C++ 接口传递 nil 广告位名称时出现的崩溃。
修复了在应用恢复运行时再次调用 connect 的问题。
修复了 iOS 12 及更低版本上新会话的
```
EXC_BAD_ACCESS
```
。
修复了首次初始化货币时不会触发货币收入事件的问题。
内存使用情况改进和修复。

TJPrivacyPolicy usPrivacy

现在成为公共属性，因此 Swift 中不再提供

setUSPrivacy

。使用

Tapjoy.getPrivacyPolicy().usPrivacy = privacyValue

进行设置。

13.0.1 (2023-04-18)

版本号提升以匹配 Android。

13.0.0 (2023-04-06)

Xcode 控制台中记录设备广告 ID。
Xcode 控制台中记录新的“测试设备 ID”。
改进了 EasyApp。
新增 Swift EasyApp。
不再支持 iOS 9。
使用 Xcode 14.1 进行构建，不再支持 32 位设备。
移除了已弃用的隐私接口 - 改用 TJPrivacyPolicy。
移除了已弃用的显示乘数接口。
移除了已弃用的 AppDataVersion 接口。
修复了 didClick 回调。
修复了 WebView 内存泄漏。
错误修复。

12.11.1 (2022-12-01)

修复了 EasyApp UI 的小问题。

12.11.0 (2022-10-07)

从 podspec 和 EasyApp 中移除了 PassKit 依赖关系。
更新了 EasyApp UI 以支持刘海屏。
修复了 iOS 15.7 上的 sceneDisconnected appstore 崩溃。

12.10.0 (2022-05-03)

已弃用 setUserId 方法，改用 setUserIdWithCompletion()。
错误修复。

12.9.1 (2022-03-16)

未更改代码级别，仅更新了版本号以便与 Android 和 Unity SDK 保持一致。

12.9.0 (2022-01-13)

执行了各种更改以改进 Swift 支持（包括空值标志和返回类型修复）。
- 由于返回类型的明确说明，在 Swift 中实例化 TJPlacement 现在使用标准初始化方法 (
```
TJPlacement(...)
```
  )，而不再使用工厂方法 (
```
TJPlacement.placement(...)
```
  )。
在 SDK 请求中添加了更多参数
错误修复。
修复了在 EasyApp 中调用 ATT 提示时的问题。
使用 Xcode 13 进行构建。

12.8.1 (2021-05-25)

支持 SKAdNetwork 2.2 和查看归因（适用于使用 Xcode 12.5 构建的应用）
支持 MRAID SKAdNetwork
在 SDK 请求中添加了更多参数
错误修复和增强功能

12.8.0 (2021-03-16)

采用 XCFramework 分发 Offerwall SDK（至少需要 Xcode 版本 11）
移除了必须包含 TapjoyResources.bundle 的要求
现在支持的最低 iOS 版本是 iOS 9
支持在搭载 Apple Silicon 的 arm64 Mac 计算机上运行模拟器
向 EasyApp（下载 SDK 时捆绑的 Tapjoy 示例应用）添加了 AppTrackingTransparency 提示，供发行商参考实现方法
错误修复和增强功能

12.7.1 (2020-11-02)

修复了与 SKAdNetwork 2.0 版相关的问题。
支持 iOS14 中的默认浏览器更改
错误修复和增强功能

12.7.0 (2020-09-16)

支持 iOS 14
在 SDK 请求中添加了更多参数
错误修复和增强功能

12.6.1 (2020-07-09)

Offerwall SDK 资源捆绑包现在与 Unity 2019.3x 兼容

12.6.0 (2020-06-29)

此版本提供了相关功能来帮助发行商遵守《加州消费者隐私法案》(CCPA)。每个平台（iOS、Android、Unity、C++）都有一个新的类“TJPrivacyPolicy”，此类可用于管理所有隐私标志（GDPR、用户同意、低于同意年龄和美国隐私）。

如果从旧版 Offerwall SDK 进行更新并使用旧方法设置了隐私值，新版 SDK 仍会读取先前设置的值，无需您再次手动设置这些值。但是，建议您彻底迁移代码，以便使用新的方法。

添加了新的 TJPrivacyPolicy 类以集中处理 GDPR、US Privacy（美国隐私）、Consent（同意）和 Under Consent Age（低于同意年龄）。
已弃用旧的 GDPR、User Consent 和 Under Consent Age API

12.4.2 (2020-02-07)

版本号提升以匹配 Android

12.4.1 (2020-01-07)

在 setUserIDWithCompletion 参数周围添加了防护机制
应用商店的错误修复

12.4.0 (2019-12-04)

在货币回调中支持客户参数（未来产品版本）
错误修复

12.3.4 (2019-10-09)

支持 SceneDelegate
支持 UIAlertController 而非 UIAlertView

12.3.3 (2019-09-20)

更新了 IAB Open Measurement SDK 以移除 UIWebView 用例

12.3.2 (2019-09-16)

移除了 UIWebView 的用例
iOS 13 支持
从 SDK 中移除了未使用的框架
错误修复

12.3.1 (2019-06-06)

更多视频广告效果增强

12.3.0 (2019-05-28)

视频广告效果增强。
移除了基于 Web 的 Offerwall（也称为 tapjoy.com Offerwall 或 TJC Offerwall），确保符合 Apple 的激励安装政策。还移除了直接链接到基于 Web 的 Offerwall 的 SDK 调用。
向 TJPlacementDelegate 添加了 didClick 委托方法。请注意，在后端服务器支持此委托之前，不会实际调用此委托。预计在 2019 年 6 月中旬左右开始提供这一支持。


@protocol TJPlacementDelegate <NSObject>@optional- (void)didClick:(TJPlacement*)placement;

12.2.1 (2019-03-14)

修复了使用 iOS SDK 构建应用时出现的一系列“unable to open object file（无法打开对象文件）”虚假警告。
修复了某些 AdMob 聚合集成中出现的方向问题。
移除了未使用的代码，因此 SDK 比前一版本小了约 10%。

12.2.0 (2018-11-13)

此版本添加了“user is below consent age（用户低于同意年龄）”标志，可帮助发行商进行用户群变现，同时确保符合 COPPA 法规。请注意，发行商需要负责实现此功能；当 Offerwall SDK 集成到应用程序中时，不会自动实现此功能。发行商还需负责在整体上遵守 COPPA 和其他适用的法律法规。美国儿童网络隐私保护法 (COPPA) 对 (a) 明知连接的用户是 13 周岁以下儿童或 (b) 运营服务（包括应用）面向 13 岁以下儿童的在线服务运营商提出了特定要求。同样，GDPR 对低于当地规定最低在线同意年龄（每个成员州规定为 13 至 16 周岁不等）的数据主体提出了特定要求。对于不面向 13 周岁以下儿童但已知用户中仍有少数低于规定最低年龄的应用程序，请使用以下方法访问 Tapjoy 的变现功能。此方法会将 Tapjoy 的 ad_tracking_enabled 设置为 false，因此仅向用户展示内容相关广告。对于此用户，不会执行广告追踪。

+(void)belowConsentAge:(BOOL)isBelowConsentAge;

如果设置为 TRUE，意味着 Offerwall SDK 会将用户视为其设置中的“Limit Ad Tracking（限制广告追踪）”开关已开启。这意味着用户仍然会看到 Tapjoy 广告，但不会根据用户行为定向投放广告，Tapjoy 也不会追踪用户的广告行为。

12.1.0 (2018-10-11)

请注意，从 2019 年 4 月开始，基于 Web 的 Offerwall 不再可用。现在，您可以直接链接到基于 Web 的 Tapjoy Offerwall，而不是让用户在基于应用的 Offerwall 中点击特别任务。请注意，要启用基于 Web 的 Offerwall，必须确保在虚拟货币屏幕上选中 Show "More Rewards" banner（显示“更多奖励”横幅广告）复选框，且必须有足够多的每日用户数量 (>100)。如果在未启用基于 Web 的 Offerwall 时尝试获取其 URL，调用将返回错误。示例如下：


[Tapjoy getOfferwallURL:placementName completion:^(NSURL *url, NSDate *expires, NSError *error) {  if (error) {     // handle the error    }   else {     [self openURL:url]; //actually open the web-based offerwall in Safari browser     } }];

还可在 SDK 下载文件夹中的 TapjoyEasyApp 中看到一个实现方式。按“Show Offerwall in Safari（在 Safari 中显示 Offerwall）”按钮将获取 URL，然后会在 Safari 浏览器中启动。

移除了所有需要特殊 info.plist 条目才能通过应用审批的代码。从此版本开始，不再需要 NSMotionUsageDescription、NSAppleMusicUsageDescription 和 NSPhotoLibraryUsageDescription 的说明。其他用途说明的要求已经在更早的 SDK 版本中移除，因此在应用程序中集成 Offerwall SDK 不再需要任何说明性的 info.plist 条目。

错误修复：

修复了若干与 Tapjoy 广告展示时旋转设备相关的错误。
修复了在播放一个 Tapjoy 广告后立即播放另一个广告（使用 contentDidDisappear）有时会失败的错误。
移除了 NSUserDefaults 同步调用（此调用会导致罕见的崩溃）。

12.0.0 (2018-06-26)

此版本与 iOS 12 和 Android 9“Pie”兼容。

已将 IAB Open Measurement SDK 集成到 Offerwall SDK 中。发行商无需执行任何其他操作或更改任何代码。
现在支持的最低 iOS 版本是 iOS 8。
此 SDK 内置了对程序化聚合的支持。稍后将发布服务器和后台对程序化聚合的支持。
修复了示例 EasyApp 中的“Get Direct Play Video Ad（获取直接播放的视频广告）”按钮。
请注意，由于最近更新了 Bitcode，此 Tapjoy iOS SDK 版本需要与 Xcode 9.3 或更高版本结合使用。

11.12.2 (2018-05-18)

此版本提供了相关功能来帮助发行商遵守《一般数据保护条例》(GDPR)。每个平台（iOS、Android、Unity、AIR）都新增了两个函数。Tapjoy 基于“合法权益”原则遵循 GDPR 的规定，因此以下函数并不是必需的函数。但是，我们仍为那些希望将同意信息传递给 Tapjoy 的发行商提供这些函数。如果发行商实现了这些函数且用户选择不同意，则 Tapjoy 将向该用户提供非兴趣导向内容。这些函数可在应用程序调用 Tapjoy Connect 函数之前调用，且应该在应用程序向 Tapjoy 请求任何内容之前调用：一个是 setUserConsent 函数，接受“0”（用户不同意）、“1”（用户同意）或更详细的同意字符串。这条更详细的字符串是指 IAB 制定的“透明度和同意框架”中所述的同意字符串。有一个可选的“受 GDPR 约束”标志，可设置为 YES/TRUE（如果用户受 GDPR 规则约束）或 NO/FALSE（如果用户不受 GDPR 规则约束）。仅当应用程序本身已判定 GDPR 是否适用于用户后，才应调用此函数。如果未调用此函数，Tapjoy 会认为应用程序尚未进行此类判断，因此 Tapjoy 会自行判定 GDPR 适用性。

是的。上面列出的函数专为基于兴趣的广告而设计，这些函数会将基于兴趣的广告的用户同意状态发送给 Tapjoy。因此，同意状态不会禁止 Offerwall SDK 在 SDK 初始化时或广告请求期间发送广告标识符。Tapjoy 的合规法律依据是“合法权益”。但是，发行商的合规法律依据以及他们对广告主标识符收集的要求可能与 Tapjoy 的不同。是否应初始化 Offerwall SDK，由应用程序根据自身的合规性需求决定。例如，如果应用程序收集广告标识符的合法依据是用户同意，那么在用户尚未同意的情况下，不应为这类用户初始化 Offerwall SDK。

Offerwall SDK 可灵活处理不同类型的应用程序，包括无法使用应用内方法来判定用户是否受 GDPR 约束的应用程序。因此，如果应用程序不进行此类判断，例如，未调用 subjectToGDPR 函数，则会由 Tapjoy 服务器判定用户是否受 GDPR 约束。然后，Tapjoy 仅在广告请求被其判定来自受 GDPR 约束的用户时，才会遵循用户的同意偏好设置。如果希望让所有国家/地区的用户都能够像受 GDPR 约束一样撤回同意，可以通过为所有未同意的用户调用 subjectToGDPR 方法并传入 TRUE 值来实现。在这种情况下，Tapjoy 的服务器将依据 subjectToGDPR 方法调用中指定的内容执行，而不会自行判定用户是否受 GDPR 约束。发行商也可联系 support@tapjoy.com，请求 Tapjoy 遵循其应用程序内所有用户的同意偏好设置，无论这些用户是否受 GDPR 约束。


新增：+(void)setUserConsent:(NSString*) value;示例：[Tapjoy setUserConsent:@"0″]; // user does not consent+(void)subjectToGDPR:(BOOL) gdprApplicability;示例：[Tapjoy subjectToGDPR:NO];   // This user is not subject to GDPR

请注意，由于最近更新了 Bitcode，此 Tapjoy iOS SDK 版本需要与 Xcode 9.3 或更高版本结合使用。

11.12.1 (2018-04-30)

对应用商店结束页体验进行了设计上的更新。
对某些 Offerwall 任务类型的操作说明显示方式进行了设计上的更新。
请注意，由于最近更新了 Bitcode，此 Tapjoy iOS SDK 版本需要与 Xcode 9.3 或更高版本结合使用。

11.12.0 (2018-03-29)

移除了对 CoreLocation 框架的要求。
移除了已弃用的“Tapjoy 平台聚合”功能。这是一种特殊形式的聚合，Tapjoy 已有将近一年不再提供支持。如果您仍在使用平台聚合，请不要更新到此 SDK 版本，建议切换到行业标准适配器聚合。常规适配器聚合功能（例如 Mopub、ironSource、Fyber、Appodeal 和其他聚合平台提供的视频和插页式广告聚合）不受此更改的影响。