跨国移动广告—Tapjoy的接入技巧、注意事项和后台操作

我们开发的移动应用有时候难免会发布到国外的国家和地区，如在Appstore和GooglePlay上面。这样的话，国内的力美、多盟什么的大型广告平台就不能使用了。这时候，推荐大家使用一款跨国的广告平台——Tapjoy。

Tapjoy不仅仅是全球最大的移动广告平台，并且已经成为全球首屈一指的广告技术与应用技术解决方案提供商，通过收购5Rocks，Tapjoy将其业内领先的移动广告技术与5Rocks的预测分析与营销自动化服务成功融合，帮助应用开发企业进行创收并将产品终身价值最大化。目前，Tapjoy为客户提供最优良的移动分析、营销自动化与基于广告的流量变现解决方案，为移动免费增值应用开发公司量身定做移动开发工具包。

下面我们将在四个部分讲解接入相关的事宜：IOS接入（unity）、Android接入、Tapjoy后台操作、常见问题分析。

1.IOS接入流程：

1>.准备资源：打开地址http://tapjoy.cn/help/57.htm下载Unity 的 SDK；打开http://tapjoy.cn/help/96.htm下载一个工具文件：TapjoyXcodeUpdatePostBuild.pyc，如图：

把这个下载之后解压缩会得到一个TapjoyXcodeUpdatePostBuild.pyc

2>.把下载的SDK导入到Unity项目中，然后在项目根目录下的Editor文件夹下替换刚才下载的TapjoyXcodeUpdatePostBuild.pyc。

3>.把TapjoyPlugin.cs挂到一个GameObject上，一般来说挂在主相机MainCamera上面。把TapjoyPlugin类中Awake方法里面的gameObject.name = this.GetType().ToString()删除。

4>.按照示例编写广告代码。广告分为积分墙、视频广告和全屏广告三种。编写完代码，导出xcode工程文件并导入xcode。

5>最关键的一点：当导入工程时，工程会报错，原因是引用Tapjoy.h等文件时找不到。所以此时还需要在xcode中添加必要的库。回来看Unity工程目录，在WebPlayerTemplates文件下下面有一个名字叫“Tapjoy”的文件夹，把这个文件夹拷贝到mac上面，拖入到xcode工程中，选择“Copy“就行了。

2.Android接入流程：

1>.同样使用Unity的SDK，但是不能直接导出APK，需要导出Eclipse工程，在Eclipse工程中编辑导出才可以。导出Eclipse工程后，不用奇怪，会出现两个工程文件夹，即：google-play-services_lib和与你app同名的文件夹。

2>.打开Eclipse，Import工程时同时导入这两个工程。google-play-services_lib工程实质上是被引用的Library。在AndroidManifest.xml中的application里面加入这些代码才能引用到这个Library：

<uses-library android:name="com.google.android.maps" />   <meta-data android:name="com.google.android.gms.version"      android:value="@integer/google_play_services_version" />

所以，还需要在AndroidManifest.xml中加入：

<activity       android:name="com.tapjoy.TJCOffersWebView"       android:configChanges="keyboardHidden|orientation|screenSize" /><activity       android:name="com.tapjoy.TapjoyFullScreenAdWebView"       android:configChanges="keyboardHidden|orientation|screenSize" /><activity       android:name="com.tapjoy.TapjoyDailyRewardAdWebView"       android:configChanges="keyboardHidden|orientation|screenSize" /><activity      android:name="com.tapjoy.TapjoyVideoView"      android:configChanges="keyboardHidden|orientation|screenSize" /><activity      android:name="com.tapjoy.TJAdUnitView"      android:configChanges="keyboardHidden|orientation|screenSize"      android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen"      android:hardwareAccelerated="true" /><activity      android:name="com.tapjoy.mraid.view.ActionHandler"      android:configChanges="keyboardHidden|orientation|screenSize" /><activity      android:name="com.tapjoy.mraid.view.Browser"      android:configChanges="keyboardHidden|orientation|screenSize" />

3>.加入上述代码后签名导出即可。

3.Tapjoy后台操作：

1>.打开Tapjoy控制后台：https://dashboard.tapjoy.com/login，注册并登陆。

2>.进入后台之后全是英文，不易看懂后台的结构，按如下操作修改后台语言：1.点击右上角的Account，此时将进入账号信息设置界面；

2.修改Preferred Language为简体中文，保存一下（注：虽然设置成了中文，但只有一部分是中文，大部分还是英文）：

3>.添加应用：在左侧菜单栏点击“APP”，然后New 一个App，填写信息，如果是已经在GooglePlay或者AppStore上线的，填上信息后会自动显示详细信息。保存完毕后会得到一个组新的App ID和App Secret Key，把这两个串码拷贝到广告的工程代码中替换。此时“Integrated?”这个选项显示的是“NO”，也就是说没有被审核，需要等一个工作日左右才能变成“YES”。

4>.广告墙：Tapjoy广告墙的后台控制比起国内的多盟，力美来说比较麻烦，它不能自动申请通过审核，而是需要联系Tapjoy相关人员（如商务）在后台手动审核通过。建立积分墙后台流程：点击菜单栏的Monetize（货币化）；添加一个新应用；选择刚才申请的app，然后在虚拟货币和应用详情里面设置积分墙、应用信息。设置完成后，虚拟货币里面的集成状态为“未启用”，此时就需要联系Tapjoy的客服人员了。如果处于“未启用”状态，那么在显示积分墙时就不会成功，会显示一个黑色的画面。

5>.Tapjoy在货币化这一菜单下，有几个特殊的功能，即“新事件”、“新细分”、“新货币”，能更好的运营广告。菜单栏的第一栏“投放广告”，一般情况下用不到这个，这个应该是用来推广应用的吧。

4.常见问题及注意事项：

1>.Appstore近期严查含有积分墙的app，但是并拒绝视频广告和全屏广告。所以想要积分墙的办法就是：在提交时，先把积分墙隐藏：在打开的时候检测时间，把开启时间推迟到提交的10天后左右。如果是联网app可以服务器控制开启时间。做到这样之后，APP内还必须含有其他不禁止的广告，否则APP内引用了广告却找不到广告，审核也不会通过。

2>.调用 Tapjoy SDK 中的方法时遇到 nullPointerException：

此种情况是在未调用requestTapjoyConnect(Context context, String appID, String secretKey)方法时调用了广告的处理方法，Tapjoy服务器没有获取到AppID状态，所以会报错。所以这个方法必须在最开始调用。

3>.在安卓APK编译出来之后，在安装时有时会遇到以下错误：Installation error: INSTALL_FAILED_MISSING_SHARED_LIBRARY：

出现此种错误的原因是——手机自身问题。由于手机的android系统被厂商修改过，缺少了一系列的文件，对google-play-services_lib不支持所致。如果一定要改的话，那么需要root手机之后，在手机系统目录下添加缺少的文件即可。

4>.在使用 Android Unity 插件时遇到错误 DLLNotfoundexception: jni：

更新你的 Android SDK，以便拥有所有最新的平台和更新。可以通过适用于 Eclipse 的 ADT 插件或者 Android SDK 和 AVD Manager 来完成该操作。请看第4>条。

5>.Android在选择API版本时，最好是使用5.0以上的版本：鼠标点击工程右键-Properties-Android-选择Level21及以上。如果没有5.0的api，那么更新API就可以了。有时候在更新API的时候不显示更新，原因是直接连接到Google更新是无法成功的，这里说一个更新AndroidSDK的方法：打开Tools-Options-设置以下参数