聚合广告 Android接入文档

聚合广告 Android接入文档

前言

  • 本文档介绍 Android Studio 开发环境下基于 Maven 方式集成的步骤,请仔细阅读文档和 Demo 工程。
  • 个推变现SDK可通过个推广告配置动态下发并展示广告,可精确查询投放信息等。
  • SDK最低版本: 17
  • 目前支持以下广告SDK及推荐版本,v3.0.0.0开始增加百度联盟、变现猫
  • 单独集成个推变现SDK,包体积增量为:0.6MB左右。在此基础上集成其他第三方SDK,包体积增量参考下表:
广告SDK 推荐版本 包大小增量
穿山甲 4.0.1.1 5.4MB
广点通 4.420.1290 1.6MB
Inmobi 7.5.3 0.9MB
百度联盟 9.16.0 1MB
变现猫 2.4.0 0.8MB
  • SDK资源包下载:请联系我们的技术支持:文档中心右侧“技术咨询”
  • SDK资料包结构:打开下载的 SDK 资料包,资料包的详细结构如下:
GETUI_BX_ANDROID_SDK/
  |- 变现SDK接入文档.pdf
  |- 变现SDK权限说明.pdf
  |- README.pdf
  |- Demo 工程/
  |    |- BX_SDK_Demo_AS_official/ (AndroidStudio 标准集成 Demo 工程)
  |       |- app/ (项目主模块)
  |       |     |- libs/ (第三方库)
  |       |     |- src/ (代码目录)
  |       |     |- build.gradle (模块级 gradle 文件)
  |       |- gradle/
  |       |- build.gradle (顶层 gradle 文件)
  |       |- settings.gradle
  |       | .....

注:其中 “......” 表示省略其他与本教程无关的内容,以下 “......” 表示相同意义,不再重复说明。

重点提示

  • 为兼容 Android 9.0,请在 application 节点添加 android:usesCleartextTraffic="true";

1. 创建个推应用

2. Maven 集成(推荐)

2.1. 在工程的根目录下的build.gradle文件中的 allprojects { } 中,添加如下代码:

maven {
 url "https://mvn.getui.com/nexus/content/repositories/releases/"
}

2.2. 在 app/build.gradle 文件中的 android.defaultConfig 下添加 manifestPlaceholders

manifestPlaceholders = [
   GETUI_APPID: "your GETUI_APPID",
   GT_INSTALL_CHANNEL: "your GT_INSTALL_CHANNEL",
   CSJ_APP_ID: "your CSJ_APP_ID", // 穿山甲官网申请
   GDT_APP_ID: "your GDT_APP_ID",  // 广点通官网申请
   INMOBI_APP_ID: "your INMOBI_APP_ID", // InMobi官网申请
   BaiduMobAd_APP_ID : "your BAIDU_APP_ID"//百度官网申请
]

2.3. 在app所在module的build.gradle文件中的 dependencies { } 中,添加如下代码:

// 变现SDK 核心库
implementation 'com.getui:bxsdk:3.0.2.0'
// 如果需要接入广点通SDK,需接入bxsdk-gdt
implementation 'com.getui:bxsdk-gdt:4.420.1290'
// 如果需要接入穿山甲SDK,需接入bxsdk-csj
implementation 'com.getui:bxsdk-csj:4.0.1.1'

// 如果需要接入Inmobi SDK,需接入bxsdk-inmobi、picasso、oaid(inmobi该版本没有oaid会初始化失败,资源从demo中获取)
implementation 'com.getui:bxsdk-inmobi:7.5.3'
implementation 'com.squareup.picasso:picasso:2.71828'
implementation(name: 'oaid_sdk_1.0.25', ext: 'aar')

//如果需要接入Baidu SDK,需接入bxsdk-baidu 
implementation 'com.getui:bxsdk-bd:9.16.0'
//如果需要接入变现猫 SDK,需接入bxsdk-bxm
implementation 'com.getui:bxsdk-bxm:2.4.0'

// gtc 为个推公司公共代码库,如果已经接入的个推其他产品内已经包含 gtc ,则无需再次引入
implementation 'com.getui:gtc:3.1.6.0'

3. 初始化SDK

类名 com.getui.bxsdk.BXManager
接口 public void init(Context context)

说明:

  • 初始化变现SDK
  • 请在主线程中调用,建议在Application

参数:

context:应用的 ApplicationContext

示例

BXManager.getInstance().init(context);

4. 变现SDK Debug模式

类名 com.getui.bxsdk.BXManager
接口 public void setDebug(boolean isDebug)

参数:

  • isDebug:是否打开Debug模式,默认关闭.

示例

BXManager.getInstance().setDebug(boolean isDebug);

5. 广告资源方Debug模式

类名 com.getui.bxsdk.BXManager
接口 public void setAdSourceDebug(boolean isDebug)

参数:

  • isDebug:是否打开广告资源方Debug模式,默认关闭.

6. 广告配置缓存开关

类名 com.getui.bxsdk.BXManager
接口 public void useCacheConfig(boolean useCache)

说明:

  • 关闭useCacheConfig模式,广告位配置从线上同步获取,会影响广告响应性能。
  • 开启useCacheConfig模式,广告位配置从本地获取,同时异步更新线上最新的配置到本地。

参数:

  • useCache:是否使用本地缓存的广告配置,默认开启.

7. 获取版本号

类名 com.getui.bxsdk.BXManager
接口 public String getVersion()

说明:

  • 获取版本号

示例

BXManager.getInstance().getVersion();

8. Banner广告

类名 com.getui.bxsdk.BXManager
接口              public void startBannerAD(Activity activity,ViewGroup container, String gtAdId, BXConfig config, BXBannerListener listener)
public void startBannerAd( BXConfig bxConfig, BXBannerListener bannerListener)

说明:

  • 初始化Banner广告

参数BXConfig:

  • activity:当前activity对象
  • container:广告容器
  • gtAdId: 个推广告Id
  • adTimeOut: 超时时长
  • expressViewWidth:期望宽度 dp
  • expressViewHeight: 期望高度 dp
  • listener: 回调接口

调用示例:

BXConfig config = new BXConfig.Builder()
                //设置广告素材的高度(仅穿山甲有效)
                .setExpressViewHeight(300f)
                //设置广告素材的宽度(仅穿山甲有效)
                .setExpressViewWidth(500f)
                //设置请求超时时间,请求超时时间必须>=500毫秒,否则不会生效
                .setAdTimeOut(3000)
                //设置上下文
                .setActivity(this)
                //设置个推广告位Id
                .setGtAdId(gtAdId)
                //设置广告容器
                .setContainer(container);
                .build();
BXManager.getInstance().startBannerAd(BXConfig config, new BXBannerListener() {
        @Override
    public void loadError(int type, String message) {
            //加载失败,type是最终失败的广告渠道,NO_SOURCE = -1; BXM = 0; CSJ = 1; GDT = 2; BD = 3; INMOBI = 4;

            Log.d(TAG,"loadError:"+message);
    }

    @Override
    public void loadSuccess(int type ,View bannerView) {
            //加载成功,type是最终失败的广告渠道
            Log.e(TAG,"loadSuccess"+type);
            container.addView(bannerView);
    }

    @Override
    public void onAdShow() {
            //广告展示
            Log.d(TAG,"onAdShow");
    }

    @Override
    public void onAdClick() {
            //广告被点击
            Log.d(TAG,"onAdClick");
    }

    @Override
    public void onAdClosed() {
            //广告被关闭
            Log.d(TAG,"onAdClosed");
    }

    @Override
    public void onAdTimeOut() {
            //加载广告超时
            Log.d(TAG,"onAdTimeOut");
    }
});

BXBannerListener回调对象

public interface BXBannerListener {
        //加载失败
    void loadError(int type, String message);
    //加载成功
    void loadSuccess(int type,View bannerView);
    //广告展示
    void onAdShow();
    //广告被点击
    void onAdClick();
    //广告被关闭
    void onAdClosed();
    //广告加载超时
    void onAdTimeOut();
}

9. 开屏广告

类名 com.getui.bxsdk.BXManager
接口              public void startSplashAD(Activity activity, ViewGroup viewGroup, String gtAdId, BXConfig config, BXSplashAdListener listener)
public void startSplashAd(BXConfig bxConfig, BXSplashAdListener bxSplashAdListener)

说明:

  • 初始化开屏广告

参数BXConfig:

  • activity:当前activity对象
  • viewGroup:广告容器
  • gtAdId: 个推广告Id
  • expressViewWidth: 期望宽度 dp
  • expressViewHeight:期望高度 dp
  • listener: 回调接口

示例

BXConfig config = new BXConfig.Builder()
                // 设置广告素材的高度(仅穿山甲有效)
                .setExpressViewHeight(300f)
                // 设置广告素材的宽度(仅穿山甲有效)
                .setExpressViewWidth(500f)
                // 设置请求超时时间,请求超时时间必须>=500毫秒,否则不会生效,建议开屏广告设置为5000ms
                .setAdTimeOut(5000)
                //上下文
                .setActivity(activity)
                //广告容器
                .setContainer(container)
                //个推广告Id
                .setGtAdId(gtAdId)
                .build();
BXManager.getInstance().startSplashAd( config, new BXSplashAdListener() {
        @Override
    public void loadError(int type, String message) {
            // 加载失败,type是最终失败的广告渠道,例如NO_SOURCE = -1; BXM = 0; CSJ = 1; GDT = 2; BD = 3; INMOBI = 4;
            Log.d(TAG,"loadError:"+message);
    }

    @Override
    public void loadSucceed(int type) {
            // 加载成功,type是最终失败的广告渠道,例如NO_SOURCE = -1; BXM = 0; CSJ = 1; GDT = 2; BD = 3; INMOBI = 4;
            Log.d(TAG,"loadSucceed"+type);
    }

    @Override
    public void onAdShow() {
            // 广告展示
            Log.d(TAG,"onAdShow");
    }

    @Override
    public void onAdClick() {
            //广告被点击
            Log.d(TAG,"onAdClick");
    }

    @Override
    public void onAdDismiss() {
            //广告被关闭
            Log.d(TAG,"onAdDismiss");
    }

    @Override
    public void onAdTimeOut() {
            //加载超时
            Log.d(TAG,"onAdTimeOut");
    }
});

BXSplashAdListener回调对象

public interface BXSplashAdListener {
    //加载失败
    void loadError(int type, String message);
    //加载成功
    void loadSucceed(int type);
    //广告展示
    void onAdShow();
    //广告被点击
    void onAdClick();
    //广告被关闭
    void onAdDismiss();
    //加载超时
    void onAdTimeOut();
}

10. 插屏广告

类名 com.getui.bxsdk.BXManager
接口              public void startInterstitialAD(Activity activity, String gtAdId, BXConfig config, BXInterstitialListener listener)
public void startInterstitialAd(BXConfig bxConfig, BXInterstitialListener bxInterstitialListener)

说明:

初始化插屏广告

参数:

  • activity:当前activity对象
  • gtAdId: 个推广告Id
  • bXConfig:配置项
  • listener: 回调接口

调用示例:

BXConfig config = new BXConfig.Builder()
                //设置广告素材的高度(仅穿山甲有效)
                .setExpressViewHeight(300f)
                //设置广告素材的宽度(仅穿山甲有效)
                .setExpressViewWidth(500f)
                //设置请求超时时间,请求超时时间必须>=500毫秒,否则不会生效
                .setAdTimeOut(3000)
                //设置上下文
                .setActivity(activity)
                //设置个推广告Id
                .setGtAdId(gtAdId)
                .build();
BXManager.getInstance().startInterstitialAd( config, new BXInterstitialListener() {
        @Override
    public void loadError(int type, String message) {
            //加载失败
            Log.d(TAG,"当前渠道:"+type+",loadError"+message);
    }

    @Override
    public void loadSuccess(int type,BXInterstitialAd bxInterstitialAd) {
            //加载成功
            Log.e(TAG,"loadSuccess:"+type);
            bxInterstitialAd.show();
       }

    @Override
    public void onAdShow() {
            //广告展示
            Log.e(TAG,"onAdShow");
    }

    @Override
    public void onAdClick() {
            //广告被点击
            Log.e(TAG,"onAdClick");
    }

    @Override
    public void onAdClosed() {
            //广告被关闭
            Log.e(TAG,"onAdClosed");
    }

    @Override
    public void onAdTimeOut() {
            //广告加载超时
            Log.e(TAG,"onAdTimeOut");
    }

    @Override
    public void onVideoComplete() {
            //全屏视频广告播放完成
            Log.e(TAG,"onVideoComplete");
    }

    @Override
    public void onSkippedVideo() {
            //全屏视频广告被跳过
            Log.e(TAG,"onSkippedVideo");
    }

    @Override
    public void onAdVideoBarClick() {
            //全屏视频广告广告相关的View被点击
            Log.e(TAG,"onAdVideoBarClick");
    }

});

BXInterstitialListener回调对象

public interface BXInterstitialListener {
        //广告加载失败
    void loadError(int type, String message);
    //广告加载成功
    void loadSuccess(int type ,BXInterstitialAd bxInterstitialAd);
    //广告被展示
    void onAdShow();
    //广告被点击
    void onAdClick();
    //广告被关闭
    void onAdClosed();
    //广告加载超时
    void onAdTimeOut();
    //全屏视频广告播放完成
    void onVideoComplete();
        //全屏视频广告被跳过
    void onSkippedVideo();
    //全屏视频广告广告相关的View被点击
    void onAdVideoBarClick();
}

11. 激励视频广告

类名 com.getui.bxsdk.BXManager
接口              public void startRewardVideoAD(Activity activity, String gtAdId, BXConfig config, BXRewardVideoAdListener listener)
public void startRewardVideoAd(BXConfig bxConfig, BXRewardVideoAdListener bxRewardVideoAdListener)

说明:

  • 初始化激励视频广告

参数:

  • activity:当前activity对象
  • gtAdId: 个推广告Id
  • bXConfig:配置项
  • expressViewWidth:期望宽度 dp
  • expressViewHeight:期望高度 dp
  • listener: 回调接口

调用示例:


BXConfig config = new BXConfig.Builder()
                //设置广告素材的高度(仅穿山甲有效)
                .setExpressViewHeight(300f)
                //设置广告素材的宽度(仅穿山甲有效)
                .setExpressViewWidth(500f)
                //设置请求超时时间,请求超时时间必须>=500毫秒,否则不会生效
                .setAdTimeOut(5000)
                //设置上下文
                .setActivity(activity)
                //设置个推广告Id
                setGtAdId(gtAdId)
                .build();
BXManager.getInstance().startRewardVideoAd(config, new BXRewardVideoAdListener() {
        @Override
    public void loadError(int type, String message) {
            //加载失败
            Log.e(TAG,"loadError:"+message);
    }


    @Override
    public void loadSuccess(int type,BXRewardVideo bxRewardVideo) {
            //加载成功
            Log.e(TAG,"loadSuccess");
            //展示广告
            bxRewardVideo.show();
    }

    @Override
    public void onAdTimeOut() {
            //广告加载超时
            Log.e(TAG,"onAdTimeOut");
    }

    @Override
    public void onAdShow() {
            //广告被展示
            Log.e(TAG,"onAdShow");
    }

    @Override
    public void onAdClick() {
            //广告被点击
            Log.e(TAG,"onAdClick");
    }

    @Override
    public void onAdDismiss() {
            //广告被关闭
            Log.e(TAG,"onAdDismiss");
    }

    @Override
    public void onRewardVideoCached() {
            //广告被缓存成功
            Log.e(TAG,"onRewardVideoCached");
    }

    @Override
    public void onVideoComplete() {
            //广告视频播放完毕
            Log.e(TAG,"onVideoComplete");
            finish();
    }

    @Override
    public void onSkippedVideo() {
            //广告被点击跳过
            Log.e(TAG,"onSkippedVideo");
    }

    @Override
    public void onRewardVerify() {
            //视频广告播完验证奖励有效性回调
            Log.e(TAG,"onRewardVerify");
    }
});

BXRewardVideoAdListener回调对象

public interface BXRewardVideoAdListener {
    // 加载失败
    void loadError(int type, String message);
    //加载成功
    void loadSuccess(int type ,BXRewardVideo bxRewardVideo);
    // 超时
    void onAdTimeOut();
    // 展示
    void onAdShow();
    // 点击
    void onAdClick();
    // 广告关闭
    void onAdDismiss();
    // 视频缓存
    void onRewardVideoCached();
    // 播放完成
    void onVideoComplete();
    // 点击跳过
    void onSkippedVideo();
    // 视频广告播完验证奖励有效性回调
    void onRewardVerify();
}

12. 信息流广告

类名 com.getui.bxsdk.BXManager
接口              public void startNativeAD(Activity activity, String gtAdId, BXConfig config, BXNativeAdListener listener)
public void startNativeAd( BXConfig bxConfig, BXNativeAdListener bxNativeAdListener)

说明:

  • 初始化信息流广告

参数:

  • activity:当前activity对象
  • gtAdId: 个推广告Id
  • adTimeOut:超时时长
  • listener: 回调接口

示例


BXConfig config = new BXConfig.Builder()
                //设置广告素材的高度(仅穿山甲有效)
                .setExpressViewHeight(300f)
                //设置广告素材的宽度(仅穿山甲有效)
                .setExpressViewWidth(500f)
                //设置请求超时时间,请求超时时间必须>=500毫秒,否则不会生效
                .setAdTimeOut(3000)
                //设置上下文
                .setActivity(activity)
                //设置个推广告Id
                .setGtAdId(gtAdId)
                .build();
BXManager.getInstance().startNatived(config, new BXNativeAdListener() {
    @Override
    public void loadError(int type, String message) {
            //加载失败,type是最终失败的广告渠道,例如NO_SOURCE = -1; BXM = 0; CSJ = 1; GDT = 2; BD = 3; INMOBI = 4;
            Log.d(TAG,"loadError");
    }

    @Override
    public void loadSuccess(int type,List<BXNativeAd> bxNativeAdList) {
        //加载成功,type是最终失败的广告渠道,例如NO_SOURCE = -1; BXM = 0; CSJ = 1; GDT = 2; BD = 3; INMOBI = 4;
            Log.d(TAG,"loadError");  
    }

    @Override
    public void onAdTimeOut() {
               //加载超时
            Log.d(TAG,"onAdTimeOut");
    }

    @Override
    public void onAdClosed(BXNativeAd bxNativeAd) {
            //信息流广告被关闭
            Log.d(TAG,"onAdClosed"); 
    }

    @Override
    public void onAdShow() {
            //广告被展示
            Log.d(TAG,"onAdShow");
    }

    @Override
    public void onAdClick(BXNativeAd bxNativeAd) {
            //广告被点击
            Log.d(TAG,"onAdClick");
    }
});

BXNativeAdListener回调对象

public interface BXNativeAdListener {
    // 加载失败
    void loadError(int type,String message);
    // 加载成功
    void loadSuccess(int type ,List<BXNativeAd> bxNativeAdList);
    // 加载达到设置的超时时间,加载超时
    void onAdTimeOut();
    // 信息流广告被关闭
    void onAdClosed(BXNativeAd bxNativeAd);
    // 信息流广告被展示
    void onAdShow();
    // 信息流广告被点击
    void onAdClick(BXNativeAd bxNativeAd);
}

13. Draw信息流广告

类名 com.getui.bxsdk.BXManager
接口              public void startDrawAD(Activity activity, String gtAdId, BXConfig config, @NonNull BXDrawListener bxDrawListener)
public void startDrawAd(BXConfig bxConfig, BXDrawListener bxDrawListener)

说明:

  • 初始化Draw信息流广告

参数:

  • activity:当前activity对象
  • gtAdId: 个推广告Id
  • bXConfig:配置项
  • listener: 回调接口

调用示例:

BXConfig config = new BXConfig.Builder()
                                //设置广告素材的高度(仅穿山甲有效)
                .setExpressViewHeight(300f)
                //设置广告素材的宽度(仅穿山甲有效)
                .setExpressViewWidth(500f)
                //设置请求超时时间,请求超时时间必须>=500毫秒,否则不会生效
                .setAdTimeOut(3000)
                //设置上下文
                .setActivity(activity)
                //个推广告Id
                .setGtAdId(gtAdId)
                .build();
BXManager.getInstance().startDrawAd( config, new BXDrawListener() {
        @Override
        public void loadError(int type, String message) {
                //加载失败
            Log.d(TAG,"loadError:"+message);
    }

    @Override
    public void loadSuccess(int type, List<BXDrawAd> bxDrawAdList) {
            //加载成功
            Log.d(TAG,"loadSuccess");
        BXDrawAd bxDrawAd =bxDrawAdList.get(0);
        //渲染广告
        bxDrawAd.render();
    }

    @Override
    public void onAdTimeOut() {
            //加载广告超时
            Log.d(TAG,"onAdTimeOut");
    }

    @Override
    public void onAdClicked(View view, int type) {
            //广告被点击
            Log.d(TAG,"onAdClicked");
    }

    @Override
    public void onAdShow(View view, int type) {
            //广告被展示
            Log.d(TAG,"onAdShow");
    }

    @Override
    public void onRenderFail(View view, String msg, int code) {
            //广告渲染失败
            Log.d(TAG,"onRenderFail");
    }

    @Override
    public void onRenderSuccess(View view, float width, float height) {
            //广告渲染成功
            Log.d(TAG,"onRenderSuccess");
     }
});

BXDrawListener回调对象

public interface BXDrawListener {
    //加载失败
    void loadError(int type, String message);
    //加载成功
    void loadSuccess(int type, List<BXDrawAd> bxDrawAdList);
    //超时
    void onAdTimeOut();
        //广告被点击
    void onAdClicked(View view, int type);
        //广告被展示
    void onAdShow(View view, int type);
        //广告渲染失败
    void onRenderFail(View view, String msg, int code);
        //广告渲染成功
    void onRenderSuccess(View view, float width, float height);
}

14. 按钮广告

类名 com.getui.bxsdk.BXManager
接口              public void startButtonAd(Activity activity, ViewGroup adContainer, String gtAdId, BXButtonListener listener)
public void startButtonAd(BXConfig bxConfig, BXButtonListener bxButtonListener)

说明:

  • 初始化按钮广告

参数:

  • activity:当前activity对象
  • container: 承载按钮广告按钮容器
  • gtAdId: 个推广告Id
  • listener: 回调接口

示例


BXManager.getInstance().startButtonAd( new BXButtonListener() {
           @Override
            public void onLoadAd() {

                Log.d(TAG, "onLoadAd");
            }
            @Override
            public void onAdShow() {
                // 按钮广告展示回调
                Log.d(TAG,"onAdShow");
            }

            @Override
            public void onAdFailed(int type,String msg) {
                // 按钮广告加载失败回调
                Log.d(TAG,"onAdFailed");
            }

            @Override
            public void onAdClicked() {
                // 按钮广告被点击回调
                Log.d(TAG,"onAdClicked");
            }
             @Override
            public void onAdTimeOut() {
                //广告超时    
            }
});

BXButtonListener回调对象

public interface BXButtonListener {
      //⼴告加载成功
    void onLoadAd();
    //⼴告展示
    void onAdShow();
    //⼴告加载失败
    void onAdFailed(int type,String msg);
    //⼴告点击
    void onAdClicked();
    //加载超时
    void onAdTimeOut();
}

15. 浮标广告

类名 com.getui.bxsdk.BXManager
接口              public void startFloatAd(Activity activity, ViewGroup adContainer, String gtAdId, BXButtonListener listener)
public void startFloatAd( BXConfig bxConfig, BXButtonListener bxButtonListener)

说明:

  • 初始化浮标广告

参数:

  • activity:当前activity对象
  • adContainer: 承载浮标广告按钮容器
  • gtAdId: 个推广告Id
  • listener: 回调接口

示例


BXManager.getInstance().startFloatAd(bxConfig, new BXButtonListener() {

            @Override
            public void onLoadAd() {

                Log.d(TAG, "onLoadAd");
            }
            @Override
            public void onAdShow() {
                //浮标广告展示回调
                Log.d(TAG,"onAdShow");
            }

            @Override
            public void onAdFailed(int type,String msg) {
                //浮标广告加载失败回调
                Log.d(TAG,"onAdFailed");
            }

            @Override
            public void onAdClicked() {
                //浮标广告被点击回调
                Log.d(TAG,"onAdClicked");
            }
             @Override
            public void onAdTimeOut() {
                //广告超时    
            }

BXButtonListener回调对象

public interface BXButtonListener {
     //⼴告加载成功
    void onLoadAd();
    //⼴告展示
    void onAdShow();
    //⼴告加载失败
    void onAdFailed(int type,String msg);
    //⼴告点击
    void onAdClicked();
    //加载超时
    void onAdTimeOut();
}

16. 自渲染广告

类名 com.getui.bxsdk.BXManager
接口              public void startAdvanceFeedAD(Activity activity, View view, String gtAdId, BXAdvanceFeedListener listener)
接口              public void startAdvanceFeedAD(Activity activity, List views, String gtAdId, BXAdvanceFeedListener listener)
public void startAdvanceFeedAd(BXConfig bxConfig, BXAdvanceFeedListener listener)

说明:

初始化自渲染广告

参数:

  • activity:当前activity对象
  • containerList: 将自渲染广告事件注册到该List
  • gtAdId: 个推广告Id
  • listener: 回调接口

示例


BXManager.getInstance().startAdvanceFeedAd(bxConfig ,new BXAdvanceFeedListener() {
            @Override
            public void onLoadAd() {
                //加载自渲染广告完成
                Log.d(TAG,"onLoadAd");
            }

            @Override
            public void onAdFailed(int type,String msg) {
                //加载自渲染广告失败
                Log.d(TAG,"onAdFailed");
            }

            @Override
            public void onAdClicked(View view) {
                //绑定自渲染广告的view被点击
                Log.d(TAG,"onAdClicked");
            }
                @Override
            public void onAdShow() {
                Log.d(TAG, "onAdShow");
            }
               @Override
            public void onAdTimeOut() {

            }
});

BXAdvanceFeedListener回调对象

public interface BXAdvanceFeedListener {
    //加载自渲染广告完成
    void onLoadAd();
     //加载自渲染广告失败
    void onAdFailed(int type,String msg);
    //绑定自渲染广告的view被点击
    void onAdClicked(View view);
    // 自渲染广告显示
    void onAdShow();
      //加载超时
    void onAdTimeOut();
}

17. 设置标签

类名 com.getui.bxsdk.BXManager
接口              public void setTag(BXTag[] tags, BXTagListener bxTagListener)

说明:

设置标签

参数:

  • tags:需要设置的标签数组。注意:单个Tag的最大字符串长度为64个字符,且不能包含以下特殊字符(",","|","|","空格","回车"等);单次上传Tag的数组最大长度为10个Tag;
  • bxTagListener: 标签设置结果的回调

示例

BXTag[] tags = new BXTag[5];
String[] tagName = new String[]{"tag1","tag2","tag3"};
for (int i = 0;i<tagName.length;i++){
        BXTag bxTag = new BXTag();
        bxTag.setName(tagName[i]);
      tags[i] = bxTag;
}
BXManager.getInstance().setTag(tags, new BXTagListener() {
        @Override
    public void onResult(int resultCode,String resultMsg) {
            Log.d("TAG","TAG组设置结果:"+resultMsg);
    }
});

BXAdvanceFeedListener回调对象

public interface BXTagListener {
        // Tag结果设置的回调
    void onResult(int resultCode,String resultMessage);
}

18. 获取gtcID

类名 com.getui.bxsdk.BXManager
接口              public void getGtcId()

说明:

resultCode说明

resultCode resultMessage
50005 标签数量超限,最大单词上传Tag数组长度为10
50006 单个标签长度超限,单个标签最大字符串长度为64个字符
50007 当天操作setTag接口频次超限,当天最大调用频次为10
50008 tag中含有非法字符
40001 接口调用间隔频次间隔小于5s
设置标签成功

文档中心搜索

技术
咨询

微信扫一扫

随时联系技术支持

在线
咨询