FAQ

1. 常见问题

从哪里下载SDK?

请点击这里

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

对于Android,SDK 12.7.0 大小为577KB(library dex 包大小);APK method count 大小大约为4661。

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

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

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

Tapjoy SDK 支持哪些开发环境?

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

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

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

Tapjoy SDK会发送哪些信息给Tapjoy?

点击 Tapjoy收集的信息 查阅SDK发送到Tapjoy服务器的详细信息。

我已经集成了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收据验证。您可以在控制面板的设置 > 应用设置中找到相关设置。

如果我需要Tapjoy的Playables集成服务,该去哪里?

请参阅Tapjoy的Playables集成指南

如果我需要帮助或协助,该去哪里?

请与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 及以上版本可以通过编程控制连接步骤。请参考文档.