FAQ

1. 常见问题

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