Tapjoy
cn CHN
Platform: 
view all platforms
Create Account
iOS
高级功能
用户隐私
Android
Unity
React Native
Testing
GraphQL Reporting API
Marketing API
广告主示例
Publisher API
开发者示例
Legal Resources
Platform Guide

FAQ

1. 常见问题

TapjoySDK证书在Xcode中过期或被撤销意味着什么？

自Tapjoy SDK 13.3.0以来，Tapjoy SDK框架使用 Tapjoy Inc. Apple 证书进行签名，以验证框架是否为正版。但是证书会过期，有时会被撤销，因此您应该尝试更新到最新的SDK。

证书详细信息如下:

  • Team Name: Tapjoy, Inc.
  • Team ID: VLCPHQMND2
  • Kind: Apple Developer Program

Tapjoy还可能对某些框架进行重新签名以延长其生命周期，如果是这种情况，您可能需要清除缓存并尝试再次集成它，为此请使用以下命令：

Cocoapods集成

pod cache clean TapjoySDK --all

Swift Package Manager集成

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

手动集成

  1. Delete the .xcframework
  2. Download it again.

从哪里下载SDK？

请点击这里。

Tapjoy SDK 会使我的应用大小增加多少？

对于Android，SDK 12.9.0 大小为692KB（library dex 包大小）；APK method count 大小大约为4688。

对于iOS，SDK12.9.0对于arm 64大小为 906,290 bytes。（这个大小包括所有Tapjoy要求的必要的framework和libraries。实际大小增幅对于多数应用来说通常更小，因为大多数应用都已经加载了Tapjoy所需的一部分组件。）

Tapjoy SDK 支持哪些移动设备操作系统？

目前支持iOS 9 及以上版本和Android 4.0及以上版本。

Tapjoy SDK 支持哪些开发环境？

Tapjoy支持原生(../ios-sdk/Quickstart/)和Android, 同时我们提供Unity3d](../unity-plugin/Quickstart/)开发插件。我们还为Cocos2d-x提供C++ library。

Tapjoy SDK 集成了哪些开源软件？

这里是所有我们集成的开源代码库列表。

我已经集成了Tapjoy但是仍没有看到任何广告。请问这是什么原因？

看不到广告有很多原因。请查看以下列表中所列举的一些情况:

  1. 最常见的原因是没有在展示位置中创建内容。如果创建了展示位置并且集成进了代码，只有当在展示位置中创建了广告内容，才能正常展示广告。
  2. 仅在代码中集成了展示位置，但是没有**在dashboard中设置**。
  3. 代码中的展示位置名称与dashbaord中设置的名称不一致。 例如，如果在代码中定义一个“app open”的placement，但在dashboard中设置 “app launch”, 调用名为 “app open”的placement将不会返回内容，同时您也看不到任何的广告。注意检查代码与dashboard中placement的命名是否一致，尤其注意空格(“ ”),下划线“_”,拼写输入以及常见的同义词（如 “exit_store” 与 “quit_store”均有退出的意思）
  4. **应用没有开通虚拟货币。**为使用Tapjoy展示广告，您必须在dashboard中至少设置一种虚拟货币。查看虚拟货币的状态，点击左侧菜单栏中“虚拟货币”。如果您一款应用或游戏在iOS与Android上均对应的版本，您需要分别开通对应的虚拟货币。
  5. **在Tapjoy Connect成功之前调用了展示位置。**您必须等到Tapjoy Connect 成功之后再调用展示位置，否则调用展示位置将会失败同时也不会有广告展示。Tapjoy所有调用都是基于Tapjoy connect成功。因为tapjoy connect 是异步的，只是将调用广告位置的代码放到tapjoy connnect之后并不能保证调用成功。您需要等到Tapjoy connect 的Delegate或者Listener（iOS, Android, Unity, Air)被成功调用之后再调用展示位置。
  6. **使用了错误的SDK key。**注意检查当前在代码中使用的SDK Key是否与dashboard中对应app的SDK Key一致。通常会出现将Tapjoy代码从一个工程复制和粘贴到另一个工程，也可能您当前代码中所使用的SDK key是其他app或者是另一个平台的。
  7. **在您所在的地区没有任何广告填充。**有时在某些特定的地区对于某些特定的广告形式没有广告填充，只有极少数地区有这种情况。对于这种情况，请设置测试手机之后再进行尝试。在测试手机上即使是在没有广告填充的地区也可以看到Tapjoy的测试广告。设置测试手机：设置->应用设置->测试设备。
  8. 您使用了VPN. 如果您使用的是VPN，则我们的系统可能会认为您的设备冒充在其他地区，因此不会提供任何广告以防欺诈。 如果您的VPN使您的设备使用的IP地址与设备的其他特征（例如，国家/地区代码）不匹配，则这种情况尤其容易发生。
  9. **广告内容设置成了仅限测试设备，但是使用了非测试设备测试。**在广告内容中去掉仅限测试设备选项或者设置相应的测试设备。
  10. **您正尝试查看货币设置为“non-rewarded”的广告内容单元的测试广告。**如果广告单元（视频）设置为“non-rewarded”，则不会看到任何广告，即使您的设备已设置为测试设备。
  11. 如果虚拟货币的兑换比率设置过低，可能会导致没有广告可以满足设置虚拟货币的的最小单位。比如，您设置您的虚拟货币为一个宝石=$1，这样的话只有一个广告出价在1美元以上才会被展示。因为很少有广告会出价这么高，所以导致没有广告可以填充。我们建议兑换比率至少是100=$1，这样可以保证不会因为您虚拟货币过贵而导致没有广告填充。
  12. 如果广告第一次可以展示，而接下来无法展示，可能是因为您没有在展示广告之前再次请求。一旦您的广告已经展示给用户，您一定要再次请求才能展示。
  13. 没有连接到网络上。 Tapjoy相关功能必须要连接到Tapjoy服务器上才能正常使用，如果没有连接到网络上，是无法展示广告的。
  14. **在Unity3d编辑器中运行。**如果您在Unity3d中集成Tapjoy SDK，一定要安装到设备上检查集成是否成功。如果在Unity3d 编辑器中运行您的应用，Tapjoy相关功能将无法使用。
  15. **手机的时钟和当前时钟不一致。**这可能会导致SSL握手失败，从而导致Tapjoy connect 失败，进而无法展示广告。
  16. 您在多个设备上使用相同的开发者用户ID。 有时，在测试时，工程师或测试人员会在许多设备上运行游戏。 如果我们的系统检测到在大量设备上使用了相同的开发者用户ID，则假定该用户是尝试建立欺诈性的“点击农场”以完成广告优惠，我们将停止向用户ID显示内容。 为了安全起见，我们不会设置触发此事件的确切阈值。 解决方法是，可以在不同的测试设备上使用不同的用户ID。
  17. 您的广告内容设置了eCPM下限或目标，而Tapjoy没有任何内容可以达到该下限或目标。 如果eCPM太高，或者Tapjoy的算法认为用户安装的可能性较小（这种情况通常发生在测试帐户和设备上），因此对该用户的出价较低，则可能会发生这种情况。

自定义组群设置需要多长时间可以生效？

自定义组群设置是每天更新，所以最长需要24小时生效。

我能通过上传广告主ID来自定义用户组吗？

可以。 请参考 定向广告ID.

Tapjoy服务器位于什么地方？

Tapjoy服务于全球客户，所以Tapjoy在亚太地区，西欧，美国东部，美国西部设有服务器，这样可以保证不同的地区都可以得到稳定可靠的服务。

我从积分墙上安装了应用，但是没有得到奖励。请问为什么？

您必须打开并运行广告应用，才可以跟踪到相应安装。一旦您打开相应的广告应用，相应的跟踪服务器就会跟踪到，并将相应的数据发给Tapjoy，Tapjoy就将奖励发送给用户。通常整个流程需要几分钟，但是有时跟踪服务器会花费较长时间将结果返回给Tapjoy。

如何打开Tapjoy调试模式？

请参考相应的文档来打开Tapjoy调试模式 iOS, Android, Unity.

我必须要等到广告缓存结束才可以播放广告吗？

一旦您得到isContentAvialable, 就可以开始播放广告。如果您在广告缓存结束之前调用showContent，Tapjoy SDK会边下载边播放。我们建议等到缓存结束再开始播放，这样可以保证播放流畅性。

视频播放时打开需要多少内存？

iOS video 需要最大7mb内存，Android video 通常需要10mb左右。

Tapjoy 支持 Android permissions ACCESS_FINE_LOCATION 或者 ACCESS_COARSE_LOCATION吗？

我们的Android SDK支持定位权限。 从Android 6开始，Google将这些权限标记为“危险”。所以我们不建议使用这些权限，这些权限是可选的。

为什么应用内购买的数据和应用商店数据不一致？

差异可能是由于， 1.不使用收据验证时。 2.我们的IAP跟踪不包括退款事件，因此，如果用户要求退款，我们将无法跟踪并调整收入数字。 3.如果特定国家/地区的数据存在差异：我们根据用户的IP或SIM卡来判断用户所在国家/地区，但商店知道用户的帐户与该国家/地区绑定并他们会使用此类信息。 在1的情况下，如果差异在Android中，则应设置IAP收据验证。您可以在控制面板的设置 > 应用设置中找到相关设置。

如果我需要帮助或协助，该去哪里？

请与support联系。

2. Unity

我能在Unity3d 编辑器中测试Tapjoy吗？

不可以。您必须在实际设备中来测试。如果您在Unity 编辑器中运行，将会得到如下错误：

E/TapjoyConnect(20815): ERROR -- call requestTapjoyConnect and make sure to receive the Tapjoy connectSuccess response from the TapjoyConnectNotifier before calling any other Tapjoy methods

我能否控制SDK第一次连接

SDK 11.2.1 及以上版本可以通过编程控制连接步骤。请参考文档.

Contents