文档

支持

Offerwall

开始使用 Monetization（变现）

开始使用 User Acquisition

Unity SDK 集成

Offerwall

变更日志

查看 Unity 插件变更日志以了解最新更新，例如日志记录改进和依赖关系管理更改
阅读时间12 分钟最后更新于 5 天前

14.6.0 (2025-11-20)

  • 添加 JSONSerializeModule 作为参考。
  • 内部改进。
  • 从 iOS 和 Android 版本继承了错误修复/改进。

14.5.0 (2025-10-10)

  • 已弃用 TJActionRequest。
  • External Dependency Manager 现使用 UPM。它将作为一个包而不是资源进行安装。

14.4.0 (2025-06-03)

  • 日志记录改进：
    • 添加了 
      SetLoggingLevel
      和 
      GetLoggingLevel
      方法。
    • 添加了在 Tapjoy 窗口中选择日志记录级别的选项。
    • 已弃用 
      SetDebugEnabled
      方法。
  • 从包中移除了 External Dependency Manager。现在，如果未包含，则依赖脚本进行导入。
  • 从包内的示例“manifest.json”中移除了冗余依赖项。

14.3.1 (2025-04-25)

  • 从 iOS 和 Android 版本继承了错误修复。

14.3.0 (2025-04-07)

  • 如果项目中尚未存在 External Dependency Manager，则会自动添加。
  • 将 UnityAds 添加到 EasyApp。
  • 向 EasyApp 添加了购买和货币值输入。
  • 向 EasyApp UI 添加了 OptOutAdvertisingId 切换开关。
  • 从 iOS 和 Android 版本继承了错误修复。

14.2.1 (2024-12-09)

  • 版本号提升。

14.2.0 (2024-12-04)

  • 已弃用 TJPlacement didClick 回调。
  • 已弃用 getSupportUrl。
  • 已将 External Dependency Manager 更新为 v1.2.183。
  • 从 iOS 和 Android 版本继承了错误修复。

14.1.1 (2024-10-15)

  • 从 Android 版本继承了错误修复。

14.1.0 (2024-10-02)

  • 已将 External Dependency Manager 更新为 1.2.180。
  • 已弃用 PPE。
  • 向 EasyApp plist 添加了 NSUserTrackingUsageDescription。
  • 已弃用 OnSetUserIdFailureHandler。
  • 修复了过多日志记录问题。
  • 移除了不必要的 BuildPostProcess 脚本。
  • 从 iOS 和 Android 版本继承了错误修复。

14.0.1 (2024-07-16)

  • 从 iOS 版本继承了错误修复。

14.0.0 (2024-07-01)

  • 修复了 Offerwall 顶部显示的导航菜单。
  • 移除了已弃用的推送通知接口。
  • 移除了已弃用的 UserCohortVariables 接口。
  • 移除了已弃用的 CustomEvents 接口。
  • 移除了已弃用的 PrivacyPolicy 接口。
  • 移除了已弃用的 UserFriendCount 接口。
  • 移除了已弃用的 connectFailure 处理程序。
  • 已弃用现有的 
    trackPurchase
    方法，并新增了具有更少参数的 
    trackPurchase
    方法。
  • 添加了 UserId getter 
    Tapjoy.GetUserID()
    。
  • 添加了 User Level getter 
    Tapjoy.GetUserLevel()
    。
  • 插件现在共享为源代码而不是 DLL。
  • 修复了 EasyApp 用户属性 UI 被导航菜单遮挡的问题。
  • 修复了 EasyApp UI 在某些 Android 设备上被屏幕刘海遮挡的问题。
  • 在 EasyApp 中启用了对多行日志消息的支持。
  • 从 iOS 和 Android 版本继承了错误修复。

已知问题

13.4.1 (2024-03-19)

  • 从 iOS 版本继承了错误修复。

13.4.0 (2024-03-04)

  • 添加了 
    connectWarning
    回调。
  • 改进了 EasyApp。
  • 移除了推送通知。

13.3.0 (2023-11-30)

  • 从 iOS 和 Android 版本继承了错误修复。

13.2.1 (2023-10-05)

  • 从 iOS 版本继承了错误修复。

13.2.0 (2023-09-27)

  • 新增用于设置最大用户等级的 API。
  • 新增用于设置用户细分段的 API。
  • 新增用于设置货币余额的 API（仅限自管货币）。
  • 新增用于设置货币需求的 API。
  • 新增用于设置广告位入口点的 API。
  • 现在将在连接失败回调中返回错误消息。
  • 已将 External Dependency Manager 更新为 v1.2.176。
  • 已弃用视频方法/回调。
  • 已弃用推送通知。
  • 现在需要使用平台条件将 iOS PostBuildScript 代码包裹起来。
  • 从 iOS 和 Android 版本继承了错误修复。

13.1.2 (2023-07-14)

  • 从 Android 版本继承了错误修复。

13.1.1 (2023-06-30)

  • 从 Android 版本继承了错误修复。

13.1.0 (2023-06-28)

  • 更新了隐私政策界面。
  • 向 EasyAPP UI 添加了隐私政策设置。
  • 从 iOS 和 Android 版本继承了错误修复和功能。

13.0.1 (2023-04-18)

  • 从 iOS 和 Android 版本继承了错误修复和功能。

13.0.0 (2023-04-06)

  • 现在添加 Tapjoy 场景时会自动包含游戏对象。
  • 插件文件现在存储在一个集中位置。
  • EasyApp 修复。
  • 移除了已弃用的隐私接口 - 改用 TJPrivacyPolicy。
  • 移除了已弃用的显示乘数接口。
  • 移除了已弃用的 AppDataVersion 接口。
  • 从 iOS 和 Android 版本继承了错误修复和功能。

12.11.1 (2022-12-01)

  • 从 iOS 和 Android 版本继承了错误修复和功能。

12.11.0 (2022-10-07)

  • 默认情况下会禁用 Bitcode。您可以在 Tapjoy 窗口中启用 Bitcode。
  • 更新了 External Dependency Manager。
  • 从 iOS 和 Android 版本继承了错误修复和功能。

12.10.0 (2022-05-03)

  • 添加了对 Android 广告 ID 退出选项的支持。
  • 从 iOS 和 Android 版本继承了错误修复和功能。

12.9.1 (2022-03-16)

  • 从 Tapjoy Unity 窗口中移除了 GCM 发送方 ID。
  • 移除了 setGCMSender API。
  • 尚不完全支持 Android 12 设备上的推送通知（已知问题 - targetSDK 31 应用：单击推送不会启动该应用）。
  • 解决了 Play 应用商店 PendingIntent 相关警告。
  • 从 iOS 和 Android 版本继承了错误修复和功能。

12.9.0 (2022-01-13)

  • 现在可以对 
    TapjoySettings
    使用自定义目录。
  • 现在可以对 
    TapjoyUnityInit.cs
    使用自定义目录。
  • 移除了修改 Xcode 项目的后处理构建文件。
  • 从 iOS 和 Android 版本继承了错误修复和功能。

已知问题

  • 由于 External Dependency Manager 的问题，某些 Unity 版本无法正确安装 pod。为了解决此问题，可以将 External Dependency Manager 更新到较新的版本。

12.8.1 (2021-05-25)

12.8.0 (2021-03-16)

12.7.1 (2020-11-02)

  • 从 iOS 和 Android 版本继承了错误修复和功能

12.7.0 (2020-09-16)

  • 从 iOS 和 Android 版本继承了错误修复和功能

12.6.1 (2020-07-09)

  • 修复了 Unity 2019.3 中关于 main.mm 导出的 Unity 项目无法识别 UnityFramework.h 的问题

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
  • 已弃用旧的 GDPR、User Consent 和 Under Consent Age API

12.4.2 (2020-02-07)

  • 从 iOS 和 Android 版本继承了错误修复和功能

12.4.1 (2020-01-07)

  • 从 iOS 和 Android 版本继承了错误修复和功能

12.4.0 (2019-12-04)

  • 从 iOS 和 Android 版本继承了错误修复和功能

12.3.4 (2019-10-09)

  • 从 iOS 和 Android 版本继承了错误修复和功能

12.3.3 (2019-09-20)

  • 从 iOS 和 Android 版本继承了错误修复和功能

12.3.2 (2019-09-16)

  • 从 iOS 和 Android 版本继承了错误修复和功能
  • TapjoyAndroidManifest.xml 中的 UnityPlayerActivity 已更新

12.3.1 (2019-06-06)

  • 从 iOS 和 Android 版本继承了错误修复和功能（包括 iOS 和 Android 部分中提到的更多视频广告效果增强）。

12.3.0 (2019-05-28)

  • 从 iOS 和 Android 版本继承了错误修复和功能（包括 iOS 和 Android 部分中提到的视频广告效果增强）。
  • 添加了 onClickHandler。请注意，在后端服务器支持此回调之前，不会实际调用此回调。预计在 2019 年 6 月中旬左右开始提供这一支持。
public delegate void OnClickHandler(TJPlacement placement);

12.2.1 (2019-03-14)

  • 从 iOS 和 Android 版本继承了错误修复和功能

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，因此仅向用户展示内容相关广告。对于此用户，不会执行广告追踪。 
public static void BelowConsentAge(bool isBelowConsentAge);
  • 如果设置为 TRUE，意味着 Offerwall SDK 会将用户视为 Opt Out of Ads Personalization（拒绝个性化广告） switch (Android) 或 Limit Ad Tracking（限制广告追踪） switch (iOS) in their settings is on. This means they will still see Tapjoy ads, but the ads will not be targeted based on user behavior, and the user's ad behavior will not be tracked by Tapjoy.
  • 从 iOS 和 Android 版本继承了错误修复。

12.1.0 (2018-10-11)

  • SDK 现支持 Firebase Cloud Messaging (FCM)。使用旧版 Google Cloud Messaging (GCM) 系统的应用应更新到 FCM，因为 FCM 最终将成为 Android 系统的强制要求。如需了解 FCM 与 Tapjoy 结合使用的说明，请参阅 Unity 发行商入门指南。
  • Tapjoy 的 Unity 插件现遵循 iOS 上的 Unity 项目旋转设置。
  • 从 iOS 和 Android 版本继承了错误修复。

12.0.0 (2018-06-26)

此版本与 iOS 12 和 Android 9 Pie 兼容。
  • 从 iOS 和 Android SDK 更新获得所有修复和功能。
  • 请注意，由于最近更新了 Bitcode，此版本需要在 iOS 构建中使用 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 适用性。

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 约束。
新增：public static void SetUserConsent(string value);Example: //User consent string generated according to consent string guidelines Tapjoy.SetUserConsent("BOEFEAyOEFEAyAHABDENAI4AAAB9vABAASA");public static void SubjectToGDPR(bool gdprApplicable);Example:Tapjoy.SubjectToGDPR(true); // This user is subject to GDP
  • 请注意，在 Unity 中，如果希望让 GDPR 设置影响初始 Tapjoy Connect 调用，请在 Tapjoy UI 中关闭自动连接，并在您自己的代码中手动进行 Tapjoy Connect 调用。否则，会在 GDPR 设置生效之前进行 Tapjoy Connect 调用。
  • 请注意，由于最近更新了 Bitcode，此版本需要在 iOS 构建中使用 Xcode 9.3 或更高版本。

11.12.1 (2018-04-30)

  • 从 iOS 和 Android SDK 更新获得所有修复和功能。
  • 请注意，由于最近更新了 Bitcode，此版本需要在 iOS 构建中使用 Xcode 9.3 或更高版本。

11.12.0 (2018-03-29)

  • 移除了以 Unity Android 为目标平台进行构建时不正确的 
    Error while downloading Asset Bundle
    错误消息。
  • 从 iOS 和 Android SDK 更新获得所有修复和功能。