更新日期:2024年 09月 05日QuickAD+安卓接入文档
<p>
<br />
</p>
<p>
<span style="line-height:2.5;font-size:16px;">SDK说明:应用接入QuickAd+后,可以统计该应用的激活,注册,支付等数据,以追踪所投放渠道的广告效果。</span>
</p>
<p>
<br />
</p>
<p>
<span style="font-size:16px;">接入流程:</span>
</p>
<p>
<br />
</p>
<h3>
<span style="line-height:2.5;font-size:16px;"><strong>1.导入SDK</strong></span>
</h3>
<p>
<span style="line-height:2.5;font-size:14px;">将lib下的jar包复制到项目lib中。</span>
</p>
<h3>
<span style="line-height:2.5;font-size:16px;">2.配置权限</span>
</h3>
<p>
<span style="line-height:2.5;font-size:14px;">在项目的AndroidManifest.xml中添加以下权限:</span>
</p>
<p>
<br />
</p>
<pre class="brush:js;toolbar:false"><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" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /></pre>
<p>
<br />
</p>
<h3>
<span style="font-size:16px;">3.接口调用</span>
</h3>
<p>
<span style="font-size:16px;"><br />
</span>
</p>
<h4>
<span style="line-height:2.5;font-size:16px;">3.1.初始化接口</span>
</h4>
<p>
<span style="line-height:2.5;font-size:14px;">接口:void init(Context context, String appID);</span>
</p>
<p>
<span style="line-height:2.5;font-size:14px;">功能:初始化SDK,其中appID为QuickSDK的产品号,此接口应该在其他接口之前调用</span>
</p>
<p>
<span style="line-height:2.5;font-size:14px;"><span style="color:#E53333;">说明:请一定确保用户同意隐私协议和用户协议之后再调用此接口以及后续接口,如果用户拒绝隐私协议,既不能执行任何sdk的接口</span><span style="color:#E53333;"></span><br />
</span>
</p>
<p>
<span style="line-height:2.5;font-size:14px;">案例:</span>
</p>
<pre class="brush:js;toolbar:false">ADP.getInstance().init(this, “123456789”);</pre>
<p>
<span style="font-size:16px;"><br />
</span>
</p>
<h4>
<span style="font-size:16px;">3.2.统计激活设备</span>
</h4>
<p>
<span style="line-height:2.5;font-size:14px;">接口:void active(String userID, String userName, String roleID);</span>
</p>
<p>
<span style="line-height:2.5;font-size:14px;">功能:统计激活设备情况(可多次调用,有排重机制),一个设备对应一个激活,参数分别为用户ID,用户名,角色ID,如果没有则传“0”,该接口调用时机可以是登录前,也可以是登录后。</span>
</p>
<p>
<span style="line-height:2.5;font-size:14px;">案例:</span>
</p>
<pre class="brush:js;toolbar:false">ADP.getInstance().active(“123”, “用户名”,“456”);</pre>
<p>
<br />
</p>
<h4>
<span style="line-height:2.5;font-size:16px;">3.3.统计注册</span>
</h4>
<p>
<span style="line-height:2.5;font-size:14px;">接口:void account(String userID, String userName);</span>
</p>
<p>
<span style="line-height:2.5;font-size:14px;">功能:统计注册数据,一个用户ID对应一个注册,参数分别用户ID,用户名。</span>
</p>
<p>
<span style="line-height:2.5;font-size:14px;">案例:</span>
</p>
<p>
<br />
</p>
<pre class="brush:js;toolbar:false">ADP.getInstance().account(“123”, “用户名”);</pre>
<p>
<br />
</p>
<h4>
<span style="line-height:2.5;font-size:16px;">3.4.统计角色信息</span>
</h4>
<p>
<span style="line-height:2.5;font-size:14px;">接口:void role(String userID, String userName, String roleID, String roleName, String roleServer, String roleLevel, String roleVip,String roleBanlance);</span>
</p>
<p>
<span style="line-height:2.5;font-size:14px;">功能:统计角色信息,参数分别为用户ID,用户名,角色ID,角色名,角色区服,角色等级,vip等级,角色余额。</span>
</p>
<p>
<span style="line-height:2.5;font-size:14px;">案例:</span>
</p>
<pre class="brush:js;toolbar:false">ADP.getInstance().role(“123”, “用户名”,“456”,“角色名”,“1”,“1”,“1”,“0”);</pre>
<p>
<br />
</p>
<h4>
<span style="line-height:2.5;font-size:16px;">3.5.统计支付信息</span>
</h4>
<p>
<span style="line-height:2.5;font-size:14px;">接口:void pay(String userID, String userName, String roleID, String orderID, String goodsID, String goodsName, float amount, String currency);</span>
</p>
<p>
<span style="line-height:2.5;font-size:14px;">功能:统计支付信息,参数分别为用户ID,用户名,角色ID,订单号,商品ID,商品名,支付金额,货币种类。</span>
</p>
<p>
<span style="line-height:2.5;font-size:14px;">案例:</span>
</p>
<pre class="brush:js;toolbar:false">ADP.getInstance().pay(“123”, “用户名”,“456”,“201711170001”,“1001”,“元宝”,6.00,“CNY”);</pre>
<p>
<br />
</p>
<h4>
<span style="line-height:2.5;font-size:16px;">3.6.退出接口</span>
</h4>
<p>
<span style="line-height:2.5;font-size:14px;">接口:void exit();</span>
</p>
<p>
<span style="line-height:2.5;font-size:14px;">功能:退出,释放SDK资源,一般在应用退出的时候调用。</span>
</p>
<p>
<span style="line-height:2.5;font-size:14px;">案例:</span>
</p>
<pre class="brush:js;toolbar:false">ADP.getInstance().exit();</pre>
<p>
<br />
</p>
<h4>
<span style="font-size:16px;">3.7.cp自定义事件上传</span>
</h4>
<p>
<br />
</p>
<p>
<span style="line-height:2.5;font-size:14px;">接口:void setEvent(String userID, String userName, String roleID, String eventCode, String eventParams);</span>
</p>
<p>
<span style="line-height:2.5;font-size:14px;">功能:上传CP需要的自定义事件(如果UID等参数为空可不传,但最后2个事件参数不能为空)</span>
</p>
<p>
<span style="line-height:2.5;font-size:14px;">案例:</span>
</p>
<pre class="brush:js;toolbar:false">ADP.getInstance().setEvent("", "", "", "TEST", "TEST FOR API ");</pre>
<p>
<br />
</p>