logo

帮助中心/文档详情/

Android模板渲染插屏广告

简介

模版渲染插屏:开发者不用自行对广告样式进行编辑和渲染,可直接调用相关接口进行广告展示。

支持的广告尺寸:1:1、2:3、3:2 三种尺寸

注意:不支持开发者在view添加按钮及对广告拦截处理

权限

模板渲染插屏广告: 默认提供

模板渲染插屏广告

创建TTAdNative对象

//创建TTAdNative对象,createAdNative(Context context) context需要传入Activity对象
TTAdNative mTTAdNative = TTAdSdk.getAdManager().createAdNative(this);

创建广告请求AdSlot

注意:
1.模板广告请求方法需要开发者设置setExpressViewAcceptedSize参数,单位dp。
2. 期望个性化模板尺寸的参数设置中,个性化模板插屏广告⚠️⚠️⚠️高度不能设置为0⚠️⚠️⚠️
3. setExpressViewAcceptedSize参数请按照平台勾选的比例去进行请求。现有1:1,3:2 ,2:3 三种比例可供选择。

AdSlot adSlot = new AdSlot.Builder()
        .setCodeId(codeId) //广告位id
        .setSupportDeepLink(true)
        .setAdCount(1) //请求广告数量为1到3条
        .setExpressViewAcceptedSize(expressViewWidth,expressViewHeight) //期望模板广告view的size,单位dp
        .build();

参数说明

参数 说明
setCodeId 平台创建的代码位ID 以9开头9位数字
setAdCount 请求数量1-3条。建议设置为1
setExpressViewAcceptedSize 设置请求模板广告素材的尺寸 单位:dp

请求广告

接入方可调用loadInteractionExpressAd(AdSlot adSlot, @NonNull NativeExpressAdListener listener)异步加载广告

注意:模板插屏广告不支持dislike逻辑

mTTAdNative.loadInteractionExpressAd(adSlot, new TTAdNative.NativeExpressAdListener() {
	//请求广告失败
    @Override
    public void onError(int code, String message) {
       
    }
	//请求广告成功
    @Override
    public void onNativeExpressAdLoad(List<TTNativeExpressAd> ads) {
       
    }
});

NativeExpressAdListener 说明

回调 说明
onError() 广告请求失败回调 返回的错误码(code)表示广告请求失败的原因,详情请见链接
onNativeExpressAdLoad() 广告请求成功的回调,客户端可在该回调中调用render()进行广告渲染

广告点击事件监听器

mTTAd.setExpressInteractionListener(new TTNativeExpressAd.AdInteractionListener() {
	//广告关闭回调
    @Override
    public void onAdDismiss() {
       
    }
	//广告点击回调
    @Override
    public void onAdClicked(View view, int type) {
       
    }
	//广告展示回调
    @Override
    public void onAdShow(View view, int type) {
       
    }
	//广告渲染失败回调
    @Override
    public void onRenderFail(View view, String msg, int code) {
       
    }
	//广告渲染成功回调
    @Override
    public void onRenderSuccess(View view, float width, float height) {
        //在渲染成功回调时展示广告,提升体验
 		mTTAd.showInteractionExpressAd(InteractionExpressActivity.this);
    }
});

ExpressAdInteractionListener说明

回调 说明
onAdDismiss() 广告关闭回调
onAdClicked() 广告被点击回调
onAdShow() 广告展示回调
onRenderFail() 广告渲染失败回调
onRenderSuccess() 广告渲染成功回调 在该回调中调用showInteractionExpressAd()进行广告的展示

注意:

  • SDK2.9.5.5版本之后在onRenderSuccess回调方法中使用showInteractionExpressAd渲染广告
  • 通过showXXAd()方法展示的广告素材是要独立占用一个activity 不可和开发者APP内容拼接

销毁广告对象

//在Activity的onDestroy回调方法中销毁广告对象
@Override
protected void onDestroy() {
    super.onDestroy();
    if (mTTAd != null) {
        mTTAd.destroy();
    }
}

参考Demo

模板Draw广告请参考Demo中的InteractionExpressActivity示例

模板渲染插屏注意点:

1.期望个性化模板尺寸的参数设置中,尺寸大小请保持和平台设置一致
2.SDK2.9.5.5版本之后在onRenderSuccess回调方法回调之后直接使用showInteractionExpressAd展示广告,不可单独拿到view去进行展示。
3.模板插屏广告不支持dislike逻辑

文档内容是否对您有帮助?
联系我们