本页面将介绍如何将Tapjoy 11 SDK将Pay-Per-Install(也称为PPI或者CPI)广告集成到您的Unity应用中。
关于PPE (Pay Per Engagement) 广告集成
如果您正在使用Tapjoy集成PPE广告(也称为PPA或者CPE),您需要在完成这个集成指南之后继续完成一些附加步骤。
如果您同时也是Tapjoy平台开发者,您只需完成开发者相应的集成指南即可。一旦您完成开发者集成指南,您的广告集成将会自动涵盖。请参考开发者集成指南。
如需另外帮助,请参考我们的常见问题或联系 客户支持.
创建应用
您需要做的第一件是在Tapjoy dashboard 上添加您的应用。使用您的注册邮箱登录到Tapjoy Dashboard,点击主菜单栏中设置->应用设置,进入应用设置页面,点击右上角“创建游戏/应用”,填入您应用的相应信息完成创建。
一旦您在Tapjoy Dashboard 完成应用创建,您就可以开始在您代码中集成Tapjoy SDK。本页面将详细介绍如果将Tapjoy SDK 11 集成到您的Unity 应用中。
集成的第一步是下载SDK,猛击这里下载.
SDK 安装
Tapjoy Unity Plugin zip包含了用于简便导入的Unity包文件,以及为那些想要通过自己拖放文件来更新集成的用户所准备的源文件。如果想要导入TapjoyUnityPlugin_vVERSION.unitypackage
您需要:
- 打开您的Unity项目
- Assets -> Import Package -> Custom Package..
- 指向 TapjoyUnityPlugin_vVERSION.unitypackage文件
- 检阅一下文件导入列表确认没有冲突
- 点击”Import”按钮来加入文件
重要提示,如果您正在使用 Unity 3.5, 不要勾选TapjoyPlugin/TapjoyPluginPrefab.prefab
添加应用的Permission以及Activities (安卓用户)
您需要以下的权限:
INTERNET
ACCESS_NETWORK_STATE
ACCESS_WIFI_STATE
<manifest ...> ... <uses-permission android:name="android.permission.INTERNET"/> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/> ... </manifest>
如想要使用Tapjoy的所有功能,将这些activites添加到Application模块的AndroidManifest.xml文件中去
<activity android:name="com.tapjoy.TJCOffersWebView" android:configChanges="orientation|keyboardHidden|screenSize" /> <activity android:name="com.tapjoy.TapjoyFullScreenAdWebView" android:configChanges="orientation|keyboardHidden|screenSize" /> <activity android:name="com.tapjoy.TapjoyVideoView" android:configChanges="orientation|keyboardHidden|screenSize" /> <activity android:name="com.tapjoy.TJAdUnitView" android:configChanges="orientation|keyboardHidden|screenSize" android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen" android:hardwareAccelerated="true" /> <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" /> <meta-data android:name="com.google.android.gms.version" android:value="@integer/google_play_services_version" />
-keepattributes JavascriptInterface -keep class * extends java.util.ListResourceBundle { protected Object[][] getContents(); } -keep public class com.google.android.gms.common.internal.safeparcel.SafeParcelable { public static final *** NULL; } -keepnames @com.google.android.gms.common.annotation.KeepName class * -keepclassmembernames class * { @com.google.android.gms.common.annotation.KeepName *; } -keepnames class * implements android.os.Parcelable { public static final ** CREATOR; }
集成
当你将Tapjoy集成到您的应用中时,您需要使用到Tapjoy SDK Key。如需找到这个Key,请在Tapjoy控制面板中打开您的应用,在左下方点击“Setting”按钮
页面底部一串包含字母和数字的字符串就是SDK Key了(如果您的开发平台涉及iOS以及安卓,您需要针对不同平台的两个不同的SDK Key)
初始化 SDK
您可以使用Tapjoy窗口来设置基本配置。前往Window -> Tapjoy打开Tapjoy窗口
在Tapjoy窗口中,您可以配置下列信息:
- 用于安卓和iOS的SDK Key
- 在Android上 push notification的GCM发送者ID
- 安卓市场的商店名称 (Google, Amazon等等)
- 授权或者禁用Advertising ID, Persistent ID,以及IDFA
- 授权或者禁用debug模式(包括控制台日志). 请确保当您发布新版本的时候这项功能被禁用
您同时也可以查看集成的状态,包括 GCMReceiver设置以及Install Referrer Receiver设置
请将Tapjoy GameObject插入到您游戏中的第一个场景。
在Tapjoy控制面板中,如果您点击左边导航栏的”Real-time”标签,在您启动您的应用后应该立马就能看到一些活动日志:
恭喜!您已经成功集成Tapjoy SDK!
调试模式 & 开发者控制台
调试模式可以让您看到Tapjoy的行动日志(session,placements,purchases, custom events等等)这些会在Tapjoy开发者控制台中显示出来。
如果想要进入开发者控制台,点击控制面板右上方的”Tools”菜单,选择”Develoepr Console”。调试模式也允许在Xcode控制台以及adb logcat中创建日志。
如果您想要获取这一信息,在Tapjoy窗口中选择enable debug mode
注意:请不要将您的应用部署到任何允许调试模式的应用商店中
开发者控制台只显示开启之后的活动日志,而不会“回顾”开启之前所发生的事件。
以下是日志样本:
现在,您已将Tapjoy集成到您的应用中了,我们可以开始使用它。