安卓接入文档
SDK接入说明 统计SDK接入
iOS接入文档
SDK接入说明 统计SDK接入
PC端接入文档
海外PC端接入文档
服务端接入文档
SDK服务端接入说明 GM功能接入说明 附录-错误码表 附录-基础码表
数据接入文档
SDK打点接入 服务端打点接入 游戏快照接入

龙图安卓SDK Applovin功能接入说明

SDK说明

接入龙图安卓SDK的游戏及应用的android客户端开发者。
使用此文档内接口，需要先接入龙图安卓海外SDK。

SDK配置说明

1 接入龙图安卓SDK后，需要配置Applovin SDK需要的依赖库。

2 然后将 ApplovinSDKLibrary/libs目录下的jar 和 aar 复制到你的工程的
Application Module/libs文件夹(没有的话须手动创建),
需要删除龙图base内的LongTuApplication-release-{version}.aar

3 复制 ApplovinSDKLibrary/res 目录下的内容到工程的res目录下

4 将以下代码添加到您app的build.gradle中：

  2. implementation 'com.google.firebase:firebase-analytics:18.0.0'
  3. implementation 'com.appsflyer:af-android-sdk:6.0.0'
  4. implementation 'com.android.installreferrer:installreferrer:1.0'
  5. implementation 'androidx.multidex:multidex:2.0.1'
  6. implementation "com.google.android.gms:play-services-games:16.0.0"
  7. implementation "com.google.android.gms:play-services-auth:16.0.1"
  8. implementation 'com.google.firebase:firebase-messaging:18.0.0'
  9. implementation "com.android.billingclient:billing:3.0.0"
  10. implementation "com.facebook.android:facebook-login:5.13.0"
  11. implementation "com.facebook.android:facebook-share:5.13.0"
  12. implementation 'com.applovin:applovin-sdk:11.3.3'
  13. implementation 'com.applovin.mediation:tapjoy-adapter:+'
  14. implementation 'com.applovin.mediation:vungle-adapter:+'
  15. implementation 'com.applovin.mediation:unityads-adapter:+'
  16. implementation 'com.applovin.mediation:facebook-adapter:+'
  17. implementation 'com.android.support:recyclerview-v7:28.+'
  18. implementation 'com.android.support:appcompat-v7:28.+'
  19. implementation 'com.applovin.mediation:google-adapter:+'
  20. implementation 'com.applovin.mediation:bytedance-adapter:+'
  21. //积分墙
  22. implementation 'com.ironsource.sdk:mediationsdk:7.1.6.1'
  23. implementation 'com.tapjoy:tapjoy-android-sdk:12.8.1'

5 注意:AndroidManifest.xml 中有需要替换为包名的位置，需要配置为${applicationId}。
(apk版本的时候是 ltbase_package_name，这里是${applicationId})。

6 添加applovin参数，配置到 AndroidManifest.xml 内 meta-data 参数
applovin参数需要找运营同学获取
com.google.android.gms.ads.APPLICATION_ID参数需要找运营同学获取

参考SDK/ApplovinSDKLibrary/AndroidManifest.xml 文件

参数key 参数说明 是否必选 获取方式
applovin.sdk.key applovinsdkkey 必选 技术支持提供
com.google.android.gms.ads.APPLICATION_ID 谷歌gmsid 必选 技术支持提供
com.facebook.sdk.ApplicationId facebook appid 必选 技术支持提供
LTGooglePay_Default_PropID 默认商品id appid 必选 技术支持提供
LTGoogleLoginClient 谷歌登录客户端id 必选 技术支持提供
LTGoogleEncodedPublicKey 谷歌支付key 必选 技术支持提供
appsFlyerSDK_key appsflyerkey 必选 技术支持提供
CHANNEL appsflyer渠道 必选 技术支持提供

7 适配Android10
前提：如果您的应用需要适配Android10(即设置targetSdkVersion=29) ##### 1.2.5.1 沙盒特性适配 因为Android10增加了沙盒特性，为保证在Android 10手机上功能正常，请在AndroidManifest.xml``application节点添加如下配置： 

  1. <application
  2.         android:requestLegacyExternalStorage="true"
  3.         tools:ignore="GoogleAppIndexingWarning"
  4.        tools:replace="android:fullBackupContent"
  5.        android:fullBackupContent="@xml/backup_rules"
  6.         >

8 开启androidx
工程 gradle.properties 文件内 useAndroidX 和 enableJetifier 需要配置为true 

  1. android.useAndroidX=true
  2. android.enableJetifier=true

1.0 设置视频激励回调

此接口需要在龙图SDK 初始化以后调用。
设置视频激励回调，在回调内处理视频播放结果

1.0.1 接口介绍

  1.        /**
  2.          * 视频激励回调
  3.          */
  4.         LTAdsAppLovin.getInstance().setLTAdsApplovinListener(mLTAdsApplovinListener);

1.0.2 功能回调说明

接收到的数据为激励视频 播放结果。

接口 接口说明
onLoadAdError 视频加载错误
onLoadAdComplete 视频加载完成,可以播放
onAdShowStart 视频开始播放
onAdVideoBarClick 用户点击了广告上的下载链接
onAdClose 激励视频视频关闭
onVideoError 视频播放错误
onRewardVerify 激励视频发放奖励，奖励信息运营配置到广告后台 
  2.   /**
  3.      * 视频回调
  4.      */
  5.     private LTAdsApplovinListener mLTAdsApplovinListener = new LTAdsApplovinListener() {
  6.         @Override
  7.         public void onLoadAdError(int code, String message) {
  8.             Toast.makeText(LTBase_Demo_MainActivity.mMainActivity, "视频加载错误code:" + code + " " + message, Toast.LENGTH_LONG).show();
  9.         }
  11.         @Override
  12.         public void onLoadAdComplete() {
  13.             Toast.makeText(LTBase_Demo_MainActivity.mMainActivity, "视频加载完成", Toast.LENGTH_LONG).show();
  14.         }
  16.         @Override
  17.         public void onAdShowStart() {
  18.             Toast.makeText(LTBase_Demo_MainActivity.mMainActivity, "视频开始播放", Toast.LENGTH_LONG).show();
  19.         }
  21.         @Override
  22.         public void onAdVideoBarClick() {
  23.             Toast.makeText(LTBase_Demo_MainActivity.mMainActivity, "点击了广告上的下载", Toast.LENGTH_LONG).show();
  24.         }
  26.         @Override
  27.         public void onAdClose() {
  28.             Toast.makeText(LTBase_Demo_MainActivity.mMainActivity, "视频关闭", Toast.LENGTH_LONG).show();
  29.         }
  31.         @Override
  32.         public void onVideoError() {
  33.             Toast.makeText(LTBase_Demo_MainActivity.mMainActivity, "视频错误", Toast.LENGTH_LONG).show();
  34.         }
  36.         @Override
  37.         public void onRewardVerify(int rewardAmount, String rewardName) {
  38.             Toast.makeText(LTBase_Demo_MainActivity.mMainActivity, "奖励发放： 数量："
  39.                     + rewardAmount + " 名字：" + rewardName, Toast.LENGTH_LONG).show();
  40.         }
  41.     };

1.1 加载视频广告

1.1.1 功能介绍

缓存激励视频，研发可以先缓存一份广告，用于加速视频播放。

1.1.2 接口使用说明

  2.   /**
  3.      * 视频激励广告 加载
  4.      *
  5.      *@param activity   当前activity实列
  6.      * @param adid       applovin平台创建的代码位ID 以9开头9位数字
  7.      * @param MediaExtra 用户透传信息
  8.      */
  9.     public void LTLoadRewardAd(Activity activity, String adid, String MediaExtra);

1.1.3 接口使用说明

  1.   /**
  2.      *
  3.      * 视频激励广告 加载
  4.      * @param activity   当前activity实列
  5.      * @param adid       applovin平台创建的代码位ID 以9开头9位数字
  6.      * @param MediaExtra 用户透传信息（预留参数，暂时没有作用）
  7.      */
  8. LTAdsAppLovin.getInstance().LTLoadRewardAd(this, "视频广告id", "研发透传信息");

1.2 播放视频激励广告

1.2.1 功能介绍

视频上次加载完成广告。

1.2.2 接口使用说明

  1.     /**
  2.      * 播放视频激励广告
  3.      * @param Activity  当前activity实列
  4.      */
  5.     public void LTShowRewardAd(Activity activity)

1.2.3 接口使用说明

  1. /**
  2.      * 播放视频激励广告
  3.      * @param Activity  当前activity实列
  4.      */
  5. LTAdsAppLovin.getInstance().LTShowRewardAd(this);

1.3 视频加载并播放

1.3.1 功能介绍

调用此接口后视频先加载，加载完成以后自动播放。

1.3.2 接口使用说明

  1.     /**
  2.      * 视频激励广告 加载并播放
  3.      * @param activity    当前activity实列
  4.      * @param codeid     applovin平台创建的代码位ID 以9开头9位数字
  5.      * @param MediaExtra 用户透传信息（预留参数，暂时没有作用）
  6.      */
  7.     public void LTLoadAndShowRewardAd(Activity activity, String codeid, String MediaExtra) {

1.3.3 接口使用说明

  1.  /**
  2.      * 视频激励广告 加载并播放
  3.      * @param activity    当前activity实列
  4.      * @param codeid     applovin平台创建的代码位ID 以9开头9位数字
  5.      * @param MediaExtra 用户透传信息
  6.      */
  7. LTAdsAppLovin.getInstance().LTLoadAndShowRewardAd(this, "视频广告id", "研发透传信息");

1.4 播放视频激励广告（带参）

1.4.1 功能介绍

视频上次加载完成广告。传入事件名

1.4.2 接口使用说明

  1.     /**
  2.      * 播放视频激励广告
  3.      *
  4.      * @param placement 事件名
  5.      */
  6.     public void LTShowRewardAd(Activity activity, String placement);

1.4.3 接口使用说明

  1. /**
  2.      * 播放视频激励广告
  3.      * @param Activity  当前activity实列
  4.      */
  5. LTAdsAppLovin.getInstance().LTShowRewardAd(this, "事件名");

1.5 视频加载并播放（带参）

1.5.1 功能介绍

调用此接口后视频先加载，加载完成以后自动播放。传入事件名

1.5.2 接口使用说明

  1. /**
  2.      * 视频激励广告 加载并播放
  3.      *
  4.      * @param placement  事件名
  5.      * @param codeid     applovin平台创建的代码位ID 以9开头9位数字
  6.      * @param MediaExtra 用户透传信息
  7.      */
  8.     public void LTLoadAndShowRewardAd(Activity activity, String placement, String codeid, String MediaExtra);

1.5.3 接口使用说明

  1.  /**
  2.      * 视频激励广告 加载并播放
  3.      * @param activity    当前activity实列
  4.      * @param placement  事件名
  5.      * @param codeid     applovin平台创建的代码位ID 以9开头9位数字
  6.      * @param MediaExtra 用户透传信息
  7.      */
  8. LTAdsAppLovin.getInstance().LTLoadAndShowRewardAd(this,"事件名", "视频广告id", "研发透传信息");

2.0 积分墙功能

2.0.1 功能介绍

此功能用于积分墙功能接入，用户完成积分墙任务以获得奖励。目前提供IronSource和Tapjoy两种接入平台

2.0.2 参数配置

添加积分墙参数，配置到 AndroidManifest.xml 内 meta-data 参数
参数需要找运营同学获取

参考SDK/ApplovinSDKLibrary/AndroidManifest.xml 文件

参数key 参数说明 是否必选 获取方式
IronSourceAppKey ironsource参数 必选 运营提供
TapjoyAppKay tapjoy参数 必选 运营提供
TapJoyPlacementName tapjoy积分墙名称 必选 运营提供

2.1 初始化接口

  1.  /**
  2.      * 积分墙初始化
  3.      * 需在打开积分墙功能之前调用
  4.      * @param activity    当前activity实列
  5.      */
  6. LTAdsAppLovin.getInstance().Init(Activity activity);

2.2 设置扩展参数接口

此接口可以设置扩展参数，在服务端回调中返回此参数

  1.  /**
  2.      * 积分墙扩展参数
  3.      * 需在打开积分墙功能之前调用
  4.      * @param extention    扩展参数
  5.      */
  6. LTAdsAppLovin.getInstance().setLTAdsOfferWallSetExtentionId(String extention);

2.3 IronSource积分墙

2.3.1 功能回调说明

接口 接口说明
onRequestSuccess 积分墙请求成功
onRequestFailure 积分墙请求失败
onContentShow 积分墙展示成功
onContentShowFailed 积分墙请求失败
onContentDismiss 积分墙关闭 
  1.  /**
  2.      * 积分墙回调设置
  3.      */
  4. private LTAdsISOfferWallListener mLTAdsISOfferWallListener = new LTAdsISOfferWallListener() {
  5.         @Override
  6.         public void onRequestSuccess() { //初始化成功即会回调此接口，表示可以打开积分墙
  7.             LTToast.makeText(LTBase_Demo_MainActivity.mMainActivity, "IronSourceOfferWall:请求成功", Toast.LENGTH_LONG);
  8.         }
  10.         @Override
  11.         public void onRequestFailure() {//初始化失败即会回调此接口
  12.             LTToast.makeText(LTBase_Demo_MainActivity.mMainActivity, "IronSourceOfferWall:请求失败", Toast.LENGTH_LONG);
  13.         }
  15.         @Override
  16.         public void onContentShow() {
  17.             LTToast.makeText(LTBase_Demo_MainActivity.mMainActivity, "IronSourceOfferWall:展示成功", Toast.LENGTH_LONG);
  18.         }
  20.         @Override
  21.         public void onContentShowFailed(int code, String msg) {
  22.             LTToast.makeText(LTBase_Demo_MainActivity.mMainActivity, "IronSourceOfferWall:展示失败 " +
  23.                     "code:" + code + "@msg:" + msg, Toast.LENGTH_LONG);
  24.         }
  26.         @Override
  27.         public void onContentDismiss() {
  28.             LTToast.makeText(LTBase_Demo_MainActivity.mMainActivity, "IronSourceOfferWall:关闭", Toast.LENGTH_LONG);
  29.         }
  30.     };

2.3.2 IronSource积分墙调用

  1.  /**
  2.      * 积分墙调用
  3.      * @param activity    当前activity实列
  4.      */
  5. LTAdsAppLovin.getInstance().LTAdsOpenIronSourceOfferWall(Activity activity);

2.4 Tapjoy积分墙

2.4.1 功能回调说明

接口 接口说明
onRequestSuccess 积分墙请求成功
onRequestFailure 积分墙请求失败
onContentReady 积分墙加载完成
onContentShow 积分墙展示成功
onContentDismiss 积分墙关闭 
  1.  /**
  2.      * Tapjoy积分墙回调
  3.      */
  4. private LTAdsTJOfferWallListener mLTAdsTJOfferWallListener = new LTAdsTJOfferWallListener() {
  5.         @Override
  6.         public void onRequestSuccess() {
  7.             LTToast.makeText(LTBase_Demo_MainActivity.mMainActivity, "TapjoyOfferWall:请求成功", Toast.LENGTH_LONG);
  8.         }
  10.         @Override
  11.         public void onRequestFailure(int code, String msg) {
  12.             LTToast.makeText(LTBase_Demo_MainActivity.mMainActivity, "TapjoyOfferWall:请求失败code：" +
  13.                     "" + code + "@msg:" + msg, Toast.LENGTH_LONG);
  14.         }
  16.         @Override
  17.         public void onContentReady() {
  18.             LTToast.makeText(LTBase_Demo_MainActivity.mMainActivity, "TapjoyOfferWall:加载完成", Toast.LENGTH_LONG);
  19.         }
  21.         @Override
  22.         public void onContentShow() {
  23.             LTToast.makeText(LTBase_Demo_MainActivity.mMainActivity, "TapjoyOfferWall:展示成功", Toast.LENGTH_LONG);
  24.         }
  26.         @Override
  27.         public void onContentDismiss() {
  28.             LTToast.makeText(LTBase_Demo_MainActivity.mMainActivity, "TapjoyOfferWall:关闭", Toast.LENGTH_LONG);
  29.         }
  30.     };

2.4.2 Tapjoy积分墙调用

  1.  /**
  2.      * 积分墙调用
  3.      * @param activity    当前activity实列
  4.      */
  5. LTAdsAppLovin.getInstance().LTAdsOpenTapjoyOfferWall(Activity activity);

上海中清龙图软件有限公司

沪ICP备16008233号-4 京公网安备 11010502046250号