文档

LevelPlay SDK - Adobe AIR

Adobe AIR 横幅集成

通过初始化 SDK、在初始化后创建横幅广告对象以及设置适当的广告大小和位置来集成横幅广告服务。
阅读时间6 分钟最后更新于 1 个月前

横幅是由系统启动的矩形广告服务,可以是静态广告,也可以是动画广告,并在实时 app 内容周围的指定区域提供。
通过 Unity LevelPlay 集成横幅广告服务并完成以下步骤:
  1. 实现横幅事件
  2. 加载横幅广告
  3. 销毁横幅广告
  4. 集成横幅提供商

先决条件

  • 确保已将 ironSource Air Plugin 正确集成到应用程序中。此处概述了集成。
  • 将我们的聚合适配器之一与横幅支持集成以投放此广告单元。

步骤 1.实现横幅事件

ironSource Air Plugin 会触发多个事件来通知您广告的可用性和活动。要监听任何事件,请调用以下方法:
IronSource.instance.addEventListener( "EventName", functionToCall );
注意
  1. EventName 是包含要监听的事件的字符串。
  2. functionToCall 是在触发事件时要调用的函数。
IronSource.instance.addEventListener("levelPlayBannerAdLoaded", levelPlayBannerAdLoaded);IronSource.instance.addEventListener("levelPlayBannerAdLoadFailed", levelPlayBannerAdLoadFailed);IronSource.instance.addEventListener("levelPlayBannerAdClicked", levelPlayBannerAdClicked);IronSource.instance.addEventListener("levelPlayBannerAdLeftApplication", levelPlayBannerAdLeftApplication);IronSource.instance.addEventListener("levelPlayBannerAdScreenPresented", levelPlayBannerAdScreenPresented);IronSource.instance.addEventListener("levelPlayBannerAdScreenDismissed", levelPlayBannerAdScreenDismissed);
插件将通知监听器以下列出的所有可能事件:
private function levelPlayBannerAdLoaded(event:Event):void { //level Play Banner Ad Loaded}private function levelPlayBannerAdLoadFailed(event:Event):void { //level Play Banner Ad Load Failed}private function levelPlayBannerAdClicked(event:Event):void { //level Play Banner Ad Clicked}private function levelPlayBannerAdLeftApplication(event:Event):void { //level Play Banner Ad Left Application}private function levelPlayBannerAdScreenPresented(event:Event):void { //level Play Banner Ad Screen Presented}private function levelPlayBannerAdScreenDismissed(event:Event):void { //level Play Banner Ad Screen Dismissed}

步骤 2.加载横幅广告

要加载横幅广告,请调用以下方法:
IronSource.instance.loadBanner(IronSourceBannerSize.BANNER, IronSource.POSITION_BOTTOM);
加载横幅时,请确保配置横幅大小和位置:

大小

描述

维度

广告网络支持

BANNER最适合手机和平板电脑的标准横幅50 X 屏幕宽度AppLovin、Digital Turbine、Google、Liftoff Monetize、Meta、Mintegral、Unity Ads
LARGE_BANNER最适合平板电脑和更大设备的大横幅90 X 屏幕宽度Admob、AppLovin
RECTANGLE_BANNER适合滚动源或游戏关卡之间的大型矩形横幅250 X 屏幕宽度Admob、AppLovin
SMART_BANNERSmart Banner 渲染自动调整大小以适应设备大小和方向的广告服务50(屏幕高度 ≤ 720)X 屏幕宽度 90(屏幕高度 > 720)X 屏幕宽度Admob、AppLovin

位置

描述

POSITION_TOP横幅将位于屏幕顶部中心
POSITION_BOTTOM横幅将位于屏幕底部中心
我们支持在 Unity LevelPlay 后台上放置广告位以及横幅的封顶和节奏。
如果您已经为横幅设置了广告位,请调用以下方法在指定的位置投放横幅广告:
IronSource.instance.loadBanner(IronSourceBannerSize.BANNER, IronSource.POSITION_BOTTOM, YOUR_PLACEMENT_NAME);
您将收到
levelPlayBannerAdLoaded
,横幅将显示在您的 app 上。

隐藏和显示横幅

为了在广告体验中提供最大的灵活性,您现在可以在 app 上隐藏和显示横幅。
加载并投放横幅广告后,可以选择隐藏此横幅广告并在稍后在 app 中重新显示。
要隐藏横幅,请调用以下函数:
IronSource.instance.hideBanner();
然后,要再次显示相同的横幅,请调用以下函数:
IronSource.instance.displayBanner();

步骤 3.销毁横幅广告

成功投放横幅广告后,建议调用以下函数来销毁以前的横幅广告。
IronSource.instance.destroyBanner();
调用此方法后,无法再使用相关的横幅。如果要再次提供横幅,需要使用 [icode]loadBanner[/icode] 方法请求新的横幅。

步骤 4.集成横幅提供商

接下来,通过 Unity LevelPlay Mediation 集成广告网络适配器以投放横幅广告。
您可以在下面找到支持的网络以及每个网络的 bannerSize 行为:

BANNER

大型

矩形

SMART

ironSource横幅广告Large(大)横幅/排行榜
AppLovin横幅广告横幅广告中等矩形横幅/排行榜
数字涡轮机横幅广告横幅广告中等矩形横幅/排行榜
谷歌横幅广告大*中等矩形横幅/排行榜
Meta Audience Network横幅广告Large(大)中等矩形横幅/排行榜
UnityAds横幅广告横幅广告-排行榜
旺格尔横幅广告横幅广告中等矩形横幅/排行榜
验证您与我们的 Integration Helper 的集成。

后续步骤

按照我们的集成指南集成其他广告单位:
另请参阅我们支持的 Mediation Networks。