文档

支持

Offerwall

开始使用 Monetization（变现）

开始使用 User Acquisition

Unity SDK 集成

Offerwall

变更日志

查看 Android SDK 变更日志以追踪更新，包括移除平台聚合以及建议改用行业标准聚合适配器等信息。
阅读时间15 分钟最后更新于 5 天前

14.6.0 (2025-11-20)

  • 内部改进。

14.5.0 (2025-10-10)

  • 向任务中添加了内联安装支持。
  • 已弃用 TJActionRequest。
  • 已将 Play 服务广告标识符更新为 18.2.0。
  • 更新到 Kotlin 2.2.0。现在最低版本为 2.0.0。
  • 已将目标 API 更新为 36。

14.4.0 (2025-06-03)

  • 已将 Gradle 升级到 8.9.1。

14.3.1 (2025-04-25)

  • 修复了请求中包含超过 2 字节的 Unicode 字符时出现的问题。这些字符包括中文、韩语、日语和其他语言中常见的字符。

14.3.0 (2025-04-07)

  • 日志记录改进：
    • 已弃用 
      Tapjoy.setDebugEnabled
      并将其替换为 
      Tapjoy.setLoggingLevel(TJLogLevel.Debug)
      。
    • 已弃用 
      TapjoyConnectFlag.ENABLE_LOGGING
      并将其替换为 
      TapjoyConnectFlag.TJC_OPTION_LOGGING_LEVEL
      。
    • 日志级别为：Error（错误）、Warning（警告）、Info（信息）和 Debug（调试）。
  • 向 
    OptOutAdvertisingId
    添加了 getter。
  • 将 UnityAds 添加到 EasyApp。
  • 向 EasyApp 添加了购买和货币值输入。
  • 向 EasyApp UI 添加了 OptOutAdvertisingId 切换开关。

14.2.1 (2024-12-09)

  • 版本号提升。

14.2.0 (2024-12-04)

  • 已将 Kotlin 更新到 v1.9.25。
  • 已弃用 TJPlacement onClick 监听器。
  • 目标 API 更新为 35。
  • 已弃用 getSupportUrl。
  • 修复了 Android 15 上的 EasyApp UI 问题。
  • 禁用了预测性返回手势。
  • 在 EasyApp 中禁用自动连接后，现在可以添加和连接新的 SDK 密钥，而无需重新启动。

14.1.1 (2024-10-15)

  • 修复了连接后不会调用“AppLaunch”广告位的错误。

14.1.0 (2024-10-01)

  • 修复了 Android 15 上屏幕刘海/相机/状态栏会遮挡 UI 的问题。
  • 修复了 TJEventOptimiser 导致的 ANR 问题。
  • 已将 Gradle 插件更新到 8.6.1。
  • 更新了 EasyApp 依赖关系。
  • 更新了 EasyApp 以使用 AAR。
  • 已弃用 PPE。
  • 已将 play-services-ads-identifier 更新为 18.1.0。
  • 已将 play-services-appset 更新为 16.1.0。
  • 修复了使用 Plugin（插件）复选框启用 Offerwall Discover 时偶尔崩溃的问题。
  • C++：添加了对 16k 页面文件的支持。

已知问题

  • 有一个错误会阻止在连接后自动调用“AppLaunch”广告位。
  • 更新到 14.1.1，其中包含对此问题的修复。

14.0.1 (2024-07-16)

  • 版本号提升以匹配 iOS。

已知问题

  • 有一个错误会阻止在连接后自动调用“AppLaunch”广告位。
  • 更新到 14.1.1，其中包含对此问题的修复。

14.0.0 (2024-07-01)

  • 修复了 Offerwall 有时在 Android 8.0 设备上无法打开的问题。
  • 添加了清除用户值的功能。
  • 添加了 User Level getter 
    Tapjoy.getUserLevel()
    。
  • 添加了 UserId getter 
    Tapjoy.getUserId()
    。
  • 移除了 DISABLE_ANDROID_ID_AS_ANALYTICS_ID 连接标志。
  • 移除了已弃用的推送通知接口。
  • 移除了已弃用的 limitedConnect 和广告位接口。
  • 移除了已弃用的 UserCohortVariables 接口。
  • 移除了已弃用的 InstallReferrer 接口。
  • 移除了已弃用的 CustomEvents 接口。
  • 移除了已弃用的 PrivacyPolicy 接口。
  • 移除了已弃用的 UserFriendCount 接口。
  • 移除了已弃用的聚合/广告竞价日期接口。
  • 移除了 store_name 连接标志。
  • 移除了已弃用的 setUserId 接口。
  • 移除了已弃用的 connectFailure 回调。
  • 移除了 TJConnectActivity。
  • 已弃用 setGLSurfaceView。此方法不再起任何作用。
  • 已弃用 setActivity。此方法不再起任何作用。

已知问题

  • 有一个错误会阻止在连接后自动调用“AppLaunch”广告位。
  • 更新到 14.1.1，其中包含对此问题的修复。

13.4.1 (2024-03-19)

  • 版本号提升以匹配 iOS。

13.4.0 (2024-03-04)

  • 添加了 
    connectWarning
    回调。
  • 添加了 Kotlin 示例应用
  • 向 SDK 添加了 
    kotlin-stdlib
    依赖项
  • 更新到 Java 11（仅限原生版本）。
  • 移除了推送通知。
  • 移除了安装来源参数。

13.3.0 (2023-11-30)

  • Tapjoy.connect 现在会在 API 23 或更低级别立即失败。MinSdk 保持为 API 21 以用于编译。
  • 已弃用“DISABLE_ANDROID_ID_AS_ANALYTICS_ID”连接标志。
  • 不再发送 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)

  • 版本号提升以匹配 iOS。

13.2.0 (2023-09-27)

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

13.1.2 (2023-07-14)

  • 修复了与 PrivacyPolicy 值相关的崩溃。
  • 错误修复。

13.1.1 (2023-06-30)

  • 修复了连接时可能发生的与设置 userId 相关的崩溃。

13.1.0 (2023-06-28)

  • Gradle 更新到 7.5。
  • 已将目标 API 更新为 33。
  • 添加了 Tapjoy 托管货币回调的错误消息。
  • 修复了抛出的 NullPointerException。
  • 修复了在 onContentDismiss 内调用 requestContent 时 onContentDismiss 触发两次的问题。
  • 更新了隐私政策界面。
  • 向 EasyApp UI 添加了隐私政策设置。
  • 修复了在 Android 6 和 7 上观看视频后发生崩溃的问题。
  • 修复了广告位崩溃 CalledFromWrongThreadException。

13.0.1 (2023-04-18)

  • 错误修复。

13.0.0 (2023-04-06)

  • 使用 logcat 获取新的“测试设备 ID”。
  • 改进了 EasyApp。
  • 移除了已弃用的隐私接口 - 改用 TJPrivacyPolicy。
  • 移除了已弃用的显示乘数接口。
  • 移除了已弃用的 AppDataVersion 接口。
  • 修复了透明状态栏错误。
  • 修复了 WebView 内存泄漏。
  • 其他错误修复和性能改进。

12.11.1 (2022-12-01)

  • 修复了 Android Studio Dolphin 中的 EasyApp 问题。
  • 更新了 EasyApp 的 Gradle 版本。
  • 性能改进。

12.11.0 (2022-10-07)

  • 修复了在 Connect 之前调用 optOutAdvertisingID 则无法获取 advertisingID 的错误。
  • 移除了 JCenter，并酌情将其替换为 MavenCentral。
  • 更新到目标 API 32。

12.10.0 (2022-05-03)

  • 已弃用 setUserID 方法，改用 setUserId(id, listener)。
  • 在 Android 12 上支持推送通知。
  • 从 SDK 中移除了对 Push to Earn 的支持。
  • 添加了对于在网络请求中启用/禁用 Android advertising_id 参数的支持。

12.9.1 (2022-03-01)

  • SDK 在 Android 12 及更高版本中使用 PendingIntent 
    FLAG_IMMUTABLE
    。这样就解决了 Android 12 设备上与推送通知相关的潜在崩溃以及 Play 应用商店警告。
  • 在 Android 12 设备上尚不支持推送通知。
  • 移除了 
    setGcmSender
    API。
  • 已将 
    play-services-ads
    依赖项更新为 18.0.0。
  • 移除了 
    play-services-ads
    的严格版本要求。

12.9.0 (2022-01-13)

  • 已将 
    play-services-ads
    依赖项更新为 17.1.0（支持的最低版本为 15.0.0）。版本 17.1.0 包含对于 Google Play 家庭计划中的应用来说应该移除的 
    AD_ID
    权限。
  • 在 SDK 请求中添加了更多参数。
  • SDK 不再收集 MAC 地址。
  • 为 EasyApp 中的启动活动添加了 
    android:exported
    属性以支持 API 31。
  • 使用 API 31 和 AndroidX 进行构建。

12.8.1 (2021-05-25)

  • 更新了 EasyApp 示例应用程序项目（面向 API 30 且 Play 服务依赖项已更新为 17.0.0）
  • play-services-ads-identifier:17.0.0 现已成为 SDK 的 maven 依赖项
  • 现已使用 Android API 30 构建 SDK
  • 在 SDK 请求中添加了更多参数
  • 错误修复和增强功能

12.8.0 (2021-03-16)

12.7.1 (2020-11-02)

  • 已迁移 InstallReferrer API
  • 修复了重复的 onContentDismiss 回调

12.7.0 (2020-09-16)

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

12.6.1 (2020-07-09)

  • Tapjoy 广告单元生命周期状态的一些代码进行了重构

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)

  • 移除与自定义安装归因协议相关的旧功能
  • 错误修复

12.4.1 (2020-01-07)

  • 移除与自定义安装归因协议相关的旧功能
  • 视频 UI 更改。
  • 错误修复

12.4.0 (2019-12-04)

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

12.3.4 (2019-10-09)

  • 更新了 IAB Open Measurement SDK

12.3.3 (2019-09-20)

  • 移除了 MOAT SDK

12.3.2 (2019-09-16)

  • DISABLE_ANDROID_ID_AS_ANALYTICS_ID
    连接标志现在默认开启
  • 错误修复

12.3.1 (2019-06-06)

  • 更多视频广告效果增强

12.3.0 (2019-05-28)

  • 视频广告效果增强。
  • 向 TJPlacementListener 添加了 onClick 回调。请注意，在后端服务器支持此回调之前，不会实际调用此回调。预计在 2019 年 6 月中旬左右开始提供这一支持。
public interface TJPlacementListener {    public void onClick(TJPlacement placement);}
  • 错误修复。
  • 从 .aar 中移除了不必要的 
    ACCESS_WIFI_STATE
    权限。

12.2.1 (2019-03-14)

  • Tapjoy 将改变其使用持久 ID（例如 Android ID）的方式。通常，Tapjoy 会减少使用这类持久 ID。这些更改对大多数发行商而言是透明的，不需要更改任何代码。具体而言：
    • 对于广告，Tapjoy SDK 将尝试使用广告 ID（如果可用）。如果广告 ID 和 MAC 地址（如果允许）不可用，Tapjoy SDK 的旧版本将传递 Android ID。从 SDK 12.2.1 开始，即使广告 ID 不可用，Tapjoy SDK 也不再为广告目的传递 Android ID 或 MAC 地址。
      • 如果发行商希望在广告 ID 不可用时发送 Android ID 以用于广告目的，他们可以使用 ALLOW_LEGACY_ID_FALLBACK 连接标志来覆盖默认的 SDK 行为。
      • 如果发行商希望在广告 ID 不可用时发送 MAC 地址以用于广告目的，他们同样可以使用这个连接标志，并且还必须在清单中包含 ACCESS_WIFI_STATE 权限。
    • 对于分析，除非发行商使用 DISABLE_ANDROID_ID_AS_ANALYTICS_ID 连接标志来明确退出，否则 Tapjoy SDK 仍会发送 Android ID。
    • 对于分析，Tapjoy SDK 不再使用 MAC 地址。
    • 如果发行商使用 Tapjoy 托管货币且未设置发行商用户 ID，那么对于没有广告 ID 的用户，如果不再发送 Android ID，这些用户可能面临货币余额丢失的风险。对于使用 Tapjoy 托管货币且未设置发行商用户 ID 的发行商，建议在更新到 12.2.1 后使用 ALLOW_LEGACY_ID_FALLBACK 连接标志来确保发送某个 ID，这样他们的用户才不会丢失货币余额。此外，还建议他们设置发行商用户 ID，这样就不再依赖 Android ID 来追踪用户货币余额。
    • 已弃用 DISABLE_PERSISTENT_IDS 连接标志，因为 SDK 的默认行为是不将持久 ID 用于广告目的。
  • 移除了未使用的代码，因此 SDK 比前一版本小了约 10%。
  • 不再需要以下 Android 活动：
<activity android:name="com.tapjoy.mraid.view.ActionHandler"android:configChanges="orientation|keyboardHidden|screenSize" /><activity android:name="com.tapjoy.mraid.view.Browser"android:configChanges="orientation|keyboardHidden|screenSize" />
错误修复：
  • 修复了偶发性的“Fatal Exception: java.lang.RuntimeException: Package manager has died（致命异常：java.lang.RuntimeException：包管理器已停止工作）”崩溃
  • 修复了 SDK 密钥为 null 时的崩溃问题
  • 修复了 
    AppMonitor.getVisibleActivity()
    方法中使用的线程安全机制不足引起的 java.util.ConcurrentModificationException 异常

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(boolean isBelowConsentAge);
 如果设置为 TRUE，意味着 Offerwall SDK 会将用户视为其设置中的“Opt Out of Ads Personalization（拒绝个性化广告）”开关已开启。这意味着用户仍然会看到 Tapjoy 广告，但不会根据用户行为定向投放广告，Tapjoy 也不会追踪用户的广告行为。 错误修复：
  • 修复了偶发性的 
    Fatal Exception: java.lang.NullPointerException
    崩溃。

12.1.0 (2018-10-11)

  • SDK 现支持 Firebase Cloud Messaging (FCM)。使用旧版 Google Cloud Messaging (GCM) 系统的应用应更新到 FCM，因为 FCM 最终将成为 Android 系统的强制要求。如需了解 FCM 与 Tapjoy 结合使用的说明，请参阅 Android 发行商入门指南。
  • 已将 SharedPreferences.commit 的几个实例替换为 SharedPreferences.apply 以解决一个罕见的崩溃问题。
  • 修复了以下与方向相关的问题：当广告内容仅支持单一方向（纵向或横向）时，在广告开始播放后，如果旋转设备，该广告可能会被强制切换到另一个方向。
  • 更新了错误弹窗的 UI。

12.0.0 (2018-06-26)

此版本与 Android 9“Pie”兼容。
  • 已将 IAB Open Measurement SDK 集成到 Offerwall SDK 中。发行商无需执行任何其他操作或更改任何代码。
  • 现在支持的最低 Android 版本是 API 级别 14/Android 4.0/Ice Cream Sandwich。
  • 此 SDK 内置了对程序化聚合的支持。稍后将发布服务器和后台对程序化聚合的支持。
  • 修复了目标设备为 Android O 设备时的推送通知。

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);示例：Tapjoy.setUserConsent("1"); // user does consentpublic static void subjectToGDPR(boolean gdprApplicable);示例：Tapjoy.subjectToGDPR(true); // This user is subject to GDP

11.12.1 (2018-04-30)

  • 仅内部更改和修复，无新增功能

11.12.0 (2018-03-29)

  • Tapjoy SDK 将不再触发以下权限：
ACCESS_FINE_LOCATIONACCESS_COARSE_LOCATIONWRITE_EXTERNAL_STORAGE
  • 移除了已弃用的“Tapjoy 平台聚合”功能。这是一种特殊形式的聚合，Tapjoy 已有将近一年不再提供支持。如果您仍在使用平台聚合，请不要更新到此 SDK 版本，建议切换到行业标准适配器聚合。常规适配器聚合功能（例如 Mopub、ironSource、Fyber、Appodeal 和其他聚合平台提供的视频和插页式广告聚合）不受此更改的影响。
  • 移除了从缓存播放 Tapjoy 视频内容且没有网络连接时显示的不当的错误消息。
  • 修复了从 Tapjoy 内容返回后 Offerwall 或应用程序会以不正确的方向显示的问题。