DCloud_App_Array
DCloud_App_Array
  • 发布:2019-12-20 22:13
  • 更新:2022-11-08 15:33
  • 阅读:57726

uni-AD App端打包注意及plus.ad使用指南

分类:HTML5+

HBuilderX 2.5.3 版本起,DCloud广告联盟升级为uni-AD。uni-app、5+ App、wap2app等项目全都支持使用uni-AD。

概述

uni-AD聚合目前国内流行的广告平台广点通(腾讯)、穿山甲(今日头条)、360广告等,支持开屏广告和信息流、Banner广告。

使用uni-AD前,需登录uni-AD广告联盟申请开通
参考教程:https://ask.dcloud.net.cn/article/36769

注意问题

Android平台

Android权限问题

我们目前测试发现在华为Android8以上手机,使用穿山甲(今日头条)广告时如果没有给应用读取设备信息权限,只会显示抖音广告。
建议开发者开通广告时,最好能引导用户允许读取设备信息权限,这样给用户下发的广告会更精准,可以获得更高的CPM。
由于2019年底开始工业和信息化部展开App侵犯用户权益专项整治行动,不允许App在用户拒绝授权后应用退出或关闭。因此建议开发者根据以下方案进行选择:

  • 如果不提交到各应用商店
    建议开发者配置应用每次启动都申请读取设备信息权限,并且用户必须允许,即permissionPhoneState下的request配置为"always",详情参考:https://ask.dcloud.net.cn/article/36549#phonestate
  • 如果提交应用市场
    建议开发者申请穿山甲(今日头条)广告,同时申请开通广点通(腾讯)和360广告,uni-AD会自动优化选择展现效果好的广告,最大化提升广告的CPM。

华为应用市场审核问题

目前已知开通广告后提交华为应用市场可能无法通过审核
反馈信息:“未通过原因:您的应用点闪屏广告或者弹窗广告立即下载,请修复
这是因为穿山甲和广点通的app推广广告,用户点击后不会弹窗提示确认,直接下载apk导致的。如果要修改为提示用户确认后再下载,需人工向穿山甲和广点通广告平台申请操作。
如碰到此问题,请邮件联系:uniad@dcloud.io
邮件标题:华为应用市场点击广告立即下载问题
并提供以下内容:

应用标识:__UNI__XXXXXX

谷歌应用(google play)市场审核问题

谷歌应用市场最新政策要求应用中不能包含直接下载apk的逻辑,只能通过google play更新/安装应用。目前国内广告厂商(穿山甲、广点通)都是直接下载apk安装,所以无法通过谷歌应用市场的审核。
如果要提交谷歌应用市场,请不要勾选第三方广告联盟(360、穿山甲、广点通),广告基础功能不受影响
后续我们会接入Google Ads、Facebook Ads等。

iOS平台

为了提升广告效果,如果勾选了广点通(腾讯)、穿山甲(今日头条)、360广告中的任何一个广告平台,则一定会使用广告标识(IDFA)
此时提交AppStore审核时注意需要勾选使用广告标识符,详情参考:https://ask.dcloud.net.cn/article/36107
注意:从HBuilder X- 3.1.13版本之后,iOS14.5的手机会在流量中显示 App Tracking Transparency 授权来获取IDFA,所以需要在manifest.json -> "App权限配置"中配置NSUserTrackingUsageDescription,描述获取IDFA的用途,否则会导致App Store审核不过或者导致应用运行闪退。例如:

配置uni-AD广告模块

云端打包时选择要集成的广告平台sdk。

  • 方式1:
    打开项目的manifest.json文件,在“App模块配置”页的“uni-AD”项下勾选需要集成的广告平台:

  • 方式2:云打包界面直接选中,然后打包

勾选App需要支持的广告平台,提交云端打包生效

不勾选广告平台,打包将不会把对应的广告SDK打进去,也就无法显示对应平台的广告

使用广告

开屏广告

uni-AD广告联盟申请开通“开屏广告”后重新提交云端打包即可。
开屏广告无需编程,可直接使用。

自定义开屏广告界面

开屏广告界面屏幕顶部85%区域显示广告内容,屏幕底部15%区域默认显示应用图标及名称,支持自定义底部区域显示内容:

  • uni-app项目
    在manifest.json文件的 "app-plus" -> "splashscreen" 下添加ads节点
  • 5+ APp项目
    在manifest.json文件的 "plus" -> "splashscreen" 下添加ads节点
        "splashscreen" : {  
            "ads" : {  
                "background" : "#FF0000",  
                "image" : "static/logo.png"  
            },  
            //...  
        },

其中 background 配置背景颜色,格式为“#RRGGBB”;
image 配置底部区域显示的图片,配置不再显示应用图标及名称,图片路径相对应用资源目录路径,不支持网络地址,建议分辨率720x256(要求png格式,背景透明,留出边距,在不同分辨率手机上会自动等比例缩放处理。

注意:

  • Android平台
    自定义开屏广告界面更新应用资源生效
  • iOS平台
    开屏广告显示在默认开屏界面splash上,仅在使用通用启动界面才支持自定义底部区域显示内容,且需提交云端打包后生效。
    如果使用自定义storyboard启动界面,则以上配置失效,显示自定义storyboard启动界面底部15%区域。

更多开屏界面配置项,请登录uni-AD广告联盟,在应用详情的开屏配置页面修改:

开屏广告是否全屏展示

HBuilderX2.8.12及以下版本,应用仅支持费全屏开屏广告。
HBuilderX2.8.7及以上版本,新增支持应用设置开屏广告全屏显示,默认非全屏显示,如需全屏显示,请登录uni-AD广告联盟,进入应用详情页面,在修改开屏配置中打开“是否全屏展示”开关。

应用从后台切回到前台是否显示广告

HBuilderX2.8.12及以下版本,应用仅在启动时显示开屏广告,应用从后台切换到前台不会显示开屏广告。
HBuilderX2.9.0及以上版本,应用支持从后台切换到前台时显示开屏广告,如果应用开通了开屏广告功能,默认也会开通后台切换到前台显示开屏广告,如需关闭此功能,请登录uni-AD广告联盟,进入应用详情页面,在修改开屏配置中关闭“从后台切回后是否展示”开关。

信息流、Banner广告

信息流和banner,需要编程。
使用信息流前,需在uni-AD广告联盟申请获取广告位标识(adpid)
HBuilderX标准基座真机运行测试信息流广告位标识(adpid)为:1111111111

注意:AdView为原生组件,仅支持页面级的滚动。

uni-app项目

使用已经封装好的 ad 组件。
详情参考:https://uniapp.dcloud.io/component/ad

5+ App(WAP2APP)项目

5+ APP中使用原生AdView原生控件渲染广告数据,其层级要高于所有DOM元素,使用时务必注意层级问题。
使用信息流、banner广告时,按以下步骤操作:

  • 在DOM中创建占位div
    var adDom = null;  
    // DOMContentloaded事件处理  
    document.addEventListener('DOMContentLoaded', function(){  
    //获取占位div元素  
    adDom = document.getElementById('ad');  
    }, false);  
    //在html中要显示广告的位置放置占位div  
    <div id="ad" style="width:100%;height:0px;"></div>
  • 获取广告数据
    var adata = null;  
    function getAdData(){  
    //获取广告数据  
    plus.ad.getAds({adpid:'1111111111',  //替换为自己申请获取的广告位标识,此广告位标识仅在HBuilderX标准基座中有效  
      width:'100%',  //广告将要显示的宽度  
      count:1           //注意实际业务中建议一次请求3-5条广告,避免请求到相同的广告  
    }, function(e){  
    console.log('获取广告成功: '+JSON.stringify(e));  
    if(!e || !e.ads || e.ads.length<1){  
      console.log('无广告数据!');  
    }else{  
      console.log('更新广告数据!');  
      adata = e.ads[0];  //这里只使用一条广告数据  
    }  
    }, function(e){  
    console.log('获取广告失败: '+JSON.stringify(e));  
    });  
    }

    注意:获取广告数据时需传入广告展现时真实的宽度,便于向广告平台获取合适的广告数据

  • 创建广告控件,监听渲染和关闭事件,绑定并渲染广告数据
    var adView = null;  
    function showAdView(){  
    //创建AdView控件  
    adView = plus.ad.createAdView({  
    top:adDom.offsetTop+'px',  
    left:'0px',  
    width:'100%',  
    height:'0px',  
    position: 'static'  
    });  
    //将AdView添加到Webview窗口中  
    plus.webview.currentWebview().append(adView);  
    //监听AdView渲染完成事件,动态调整高度  
    adView.setRenderingListener(function(e){  
    console.log('渲染广告完成: '+JSON.stringify(e));  
    if(0 != e.result){  
      console.log('渲染失败!');  
    }else{  
      //调整广告控件高度,显示广告内容;调整广告控件的top值,避免渲染过程中top值发生变化导致的广告位置不对的问题。  
      adView.setStyle({top: adDom.offsetTop + 'px', height: e.height + 'px' });  
      //调整占位div高度,避免被广告控件盖住DOM元素  
      adDom.style.height = e.height+'px';  
    }  
    });  
    //监听用户关闭广告控件事件  
    adView.setDislikeListener(function(e){  
    console.log('用户关闭广告: '+JSON.stringify(e));  
    adView.close(),adView=null;  
    //调整占位div高度,避免关闭广告控件后显示空白区域  
    adDom.style.height = '0px';  
    });  
    //绑定并渲染广告数据  
    adView.renderingBind(adata);  
    }

激励视频广告

HBuilderX标准基座真机运行测试激励视频广告位标识(adpid)为:1507000689

uni-app项目

使用已经封装成uni API。
详情参考:https://uniapp.dcloud.io/api/ad/rewarded-video-ad

5+ App(WAP2APP)项目

激励视频广告由RewardedVideoAd管理。
操作步骤如下:

  • 创建激励视频广告对象 plus.ad.createRewardedVideoAd,需传入在uni-AD平台申请的广告位标识adpid
  • 监听激励视频加载成功事件:调用广告对象的onLoad方法监听,加载成功后调用其 show 方法播放视频
  • 监听激励视频错误事件(可选):调用广告对象的onError方法监听错误,发生错误时可以尝试重新加载一次,如果还失败可以释放广告对象
  • 监听激励视频播放完成:调用广告对象的onClose发监听播放完成,触发此事件说用户已看完广告,发放奖励
  • 加载激励视频广告:调用广告对象load

示例如下:

//视频激励广告  
var adReward = null;  
function rewardedVideoAd(){  
  if(adReward){  
    outLine('正在加载激励视频广告');  
    return;  
  }  
  console.log('#视频激励广告#');  
  adReward = plus.ad.createRewardedVideoAd({adpid:'1507000689'});  // 注意替换为自己申请的adpid,此广告位标识仅在HBuilderX标准基座中有效  
  adReward.onLoad(function(){  
    console.log('加载成功')  
    adReward.show();  
  });  
  adReward.onError(function(e){  
    console.log('加载失败: '+JSON.stringify(e));  
    adReward.destroy();  
    adReward = null;  
  });  
  adReward.onClose(function(e){  
    if(e.isEnded){  
      console.log('激励视频播放完成');  
      plus.nativeUI.toast('激励视频播放完成');  
    }else{  
      console.log('激励视频未播放完成关闭!')  
    }  
    adReward.destroy();  
    adReward = null;  
  });  
  adReward.load();  
}

全屏视频广告

HBuilderX标准基座真机运行测试全屏视频广告位标识(adpid)为:1507000611
全屏视频广告与激励视频广告效果类似,在应用中可以在激励视频广告填充不足时用全屏视频广告来代替。
全屏视频与激励视频广告的差别:

  1. 不支持视频服务器回调校验事件
  2. 全屏视频在播放结束前(通常播放6-10秒)可以关闭,用户关闭视频不会提醒用户无法获取奖励

uni-app项目

使用已经封装成uni API。
详情参考:https://uniapp.dcloud.net.cn/api/a-d/full-screen-video

5+ App(WAP2APP)项目

全屏视频广告由FullScreenVideoAd管理。
操作步骤如下:

  • 创建全屏视频广告对象 plus.ad.createFullScreenVideoAd,需传入在uni-AD平台申请的广告位标识adpid
  • 监听全屏视频加载成功事件:调用广告对象的onLoad方法监听,加载成功后调用其 show 方法播放视频
  • 监听全屏视频错误事件(可选):调用广告对象的onError方法监听错误,发生错误时可以尝试重新加载一次,如果还失败可以释放广告对象
  • 监听全屏视频播放完成:调用广告对象的onClose发监听播放完成,触发此事件说用户已看完广告
  • 加载激励视频广告:调用广告对象load

示例如下:

//视全屏激励广告  
var adFull = null;  
function fullVideoAd(){  
  if(adFull){  
    outLine('正在加载全屏视频广告');  
    return;  
  }  
  console.log('#全屏视频广告#');  
  adFull = plus.ad.createFullScreenVideoAd({adpid:'1507000611'});  // 注意替换为自己申请的adpid,此广告位标识仅在HBuilderX标准基座中有效  
  adFull.onLoad(function(){  
    console.log('加载成功')  
    adFull.show();  
  });  
  adFull.onError(function(e){  
    console.log('加载失败: '+JSON.stringify(e));  
    adFull.destroy();  
    adFull = null;  
  });  
  adFull.onClose(function(e){  
    if(e.isEnded){  
      console.log('全屏视频播放完成');  
      plus.nativeUI.toast('全屏视频播放完成');  
    }else{  
      console.log('全屏视频未播放完成关闭!')  
    }  
    adFull.destroy();  
    adFull = null;  
  });  
  adFull.load();  
}

沉浸视频流广告

也称为Draw视频信息流广告

沉浸视频流广告为媒体提供了竖屏视频信息流广告样式,适合在全屏的竖屏视频中使用。目前仅提供了nvue的方式使用,使用方式可以参考文档:https://uniapp.dcloud.net.cn/component/ad-draw

HBuilderX3.0.0及以上版本开始支持。

内容联盟

内容联盟提供了单独的接口接入视频流供接入方接入。是一种支持用户上下滑动的切换视频的内容形式。

使用步骤:

示例:

        plus.ad.showContentPage({  
            adpid:"1111111112", // 1111111112为测试广告位,使用时请替换成自己的。  
        }, function(e) {  
            console.log("成功")  
        }, function(e) {  
            console.log(JSON.stringify(e))  
        });  


广告错误码

激励视频及全屏视频广告常见错误及处理建议:

  • "-5001"
    广告位标识adpid为空,请传入有效的adpid
    请到广告平台申请广告位并获取adpid。
  • "-5002"
    无效的广告位标识adpid,请使用正确的adpid
    请到广告平台确认使用的广告位标识adpid是否正确。
  • "-5003"
    未开通广告,请在广告平台申请并确保已审核通过
    当前应用还没有开通广告,或者广告还没有审核通过,请到广告平台查看申请状态。
  • "-5004"
    无广告模块,打包时请配置要使用的广告模块
    云端打包时没有勾选广告平台SDK,请参考前面“配置uni-AD广告模块”方法勾选后重新提交云端打包。
  • "-5005"
    广告加载失败,请稍后重试
    加载视频激励广告失败,返回此错误时建议过一段时间再重新加载一次。
  • "-5006"
    广告未加载完成无法播放,请加载完成后再调show播放
  • "-5007"
    无法获取广告配置数据,请尝试重试
    返回此错误时建议重新加载一次。
  • "-5100"
    其他错误,聚合广告商内部错误。

本地离线打包

Android平台参考:https://nativesupport.dcloud.net.cn/AppDocs/usemodule/androidModuleConfig/uniad
iOS平台参数:https://nativesupport.dcloud.net.cn/AppDocs/usemodule/iOSModuleConfig/uniad

0 关注 分享

要回复文章请先登录注册

3***@qq.com

3***@qq.com

为什么iOS自定义启动图下在manifest里面app-plus->splashscreen放了ads,打包后开屏广告还是应用名称和应用logo,并不是文档提到的自定义启动图的15%,求解
2022-11-08 15:33
1***@qq.com

1***@qq.com

APPID:NA03B6711
微信小程序APPID:wxfacdadb51a1f271c
广告审核状态:审核中
广告插件:申请中
已经三天了,麻烦尽快申请下呢,感谢了!!
2022-09-28 18:43
d***@163.com

d***@163.com

视频广告在华为荣耀手机上无法展示
2022-09-05 17:42
奋斗季节

奋斗季节

根本就没客服,Q群申请就拒绝,说什么要收益,几块钱就不是收益吗?就是因为有问题所以才几块钱收益,想找你们解决,然后Q群加不了,邮箱也是假的,发的邮件一两个星期都没人回!特么的要不我买的APP他们目前只对接你们这垃圾玩意,谁用啊?谁知道会不会私下扣量呢
2022-08-15 15:26
1***@163.com

1***@163.com

基础广告里面有激励视频吗?
2022-06-27 22:58
1***@qq.com

1***@qq.com

能不能把你们的废物广告给关掉?狗皮膏药一样,关了自动开就不说了,现在都关不掉
2022-04-20 09:42
1***@qq.com

1***@qq.com

使用vue写的项目 可以用这个吗?
2022-03-12 16:35
2***@qq.com

2***@qq.com

好奇怪 为啥激励视频的价格越来越低 只有一开始的十分之一
2021-11-28 15:31
1***@qq.com

1***@qq.com

回复 风雅 :
解决了吗
2021-11-26 17:13
2***@qq.com

2***@qq.com

为啥一直是-5005呢 有人这样码
2021-10-28 10:20