使用 UI Inspector 设置格式

设置前,请先安装 Yandex Mobile Ads SDK 软件包

使用 UI Inspector 添加格式

  1. 打开我们的 GitHub 存储库并下载 Source code.zip。此压缩包包含 samples 文件夹,其中包含四个不同格式的测试文件:

    • 开屏广告。
    • 激励广告。
    • 自适应横幅广告。
    • 插屏广告。
  2. 将所有文件移动到 Unity 项目中的 Assets 文件夹,或使用 Inspector 选项卡:添加组件/Yandex Ads/[横幅广告类型]。之后,您可以将组件附加到其中一个场景以测试组件运作方式:

自适应横幅广告

独特的横幅广告设置

  • 横幅广告类型 — 内嵌、粘性。
  • 相对于屏幕的位置调整(Banner Position)。
  • 宽度设置为屏幕尺寸(Use Screen Width)。

事件

事件触发操作

On Ad Successfully Loaded

广告加载完成

On Ad Failed To Load

广告加载失败

On User Left Application

用户点击广告后退出应用

On User Returned To Application

用户点击广告后返回应用

On Ad Clicked

用户点击广告

On Ad Impression Recorded

广告展示次数已记录

插屏广告

事件

事件触发操作

On Ad Successfully Loaded

广告加载完成

On Ad Failed To Load

广告加载失败

On Dismissed

广告关闭

On Ad Clicked

用户点击广告

On Ad Impression Recorded

广告展示次数已记录

On Ad Shown

广告展示成功

On Ad Failed To Show

广告投放失败

激励广告

事件

事件触发操作

On Ad Successfully Loaded

广告加载完成

On Ad Failed To Load

广告加载失败

On Dismissed

广告关闭

On Ad Clicked

用户点击广告

On Ad Impression Recorded

广告展示次数已记录

On Ad Shown

广告展示成功

On Ad Failed To Show

广告投放失败

On Rewarded

广告展示获得奖励

开屏广告

独特的横幅广告设置

  • Show AppOpenAd Once:每个会话仅显示一次。

事件

事件触发操作

On Ad Successfully Loaded

广告加载完成

On Ad Failed To Load

广告加载失败

On Dismissed

广告关闭

On Ad Clicked

用户点击广告

On Ad Impression Recorded

广告展示次数已记录

On Ad Shown

广告展示成功

On Ad Failed To Show

广告投放失败

On App State Change

应用切换到或进入后台模式

术语

冷启动:启动不在 RAM 中的应用,创建一个新的应用会话。

热启动:将应用从后台模式(此时应用在内存中暂停运行)切换至前台模式。

开屏广告集成的特点

  • 广告加载可能需要较长时间,因此如果广告尚未加载,应避免增加冷启动时间。
  • 为后续的热启动展示预加载广告。
  • 我们不建议在应用启动时同步加载开屏广告和其他广告格式,因为应用可能需要下载必要的运行数据。这可能会给您的设备和网络连接造成过大的负载,从而导致广告加载时间延长。
  • 如果 OnAdFailedToLoad 事件返回错误,请勿尝试再次加载新广告。如果确实需要,请限制广告加载重试次数——这有助于避免因资源限制而导致的持续请求失败和连接问题。

常规横幅广告设置

  • 组件名称:您可以使用任何名称,这不会产生任何影响。

  • Ad Unit Id

    • 开发模式,用于配合演示广告单元使用。

    • 生产模式,用于配合 R-M-XXXXXX-Y 使用(实际 ID 请在 Yandex Advertising Network 界面查询)。R-M-XXXXXX-Y 是您实际广告单元 ID 的模板,将用于接收各种广告创意。

  • 加载和投放设置:

    • Auto Load:SDK 自动初始化后立即加载。
    • Show After Loading:广告加载后立即投放。
  • 公共组件方法相同:

    • Load():手动加载广告。
    • Show():手动投放广告。
    • onDestroy():移除广告对象。
  • 使用 Unity Inspector 进行事件处理:任何事件都可以通过 Inspector 链接到自定义脚本的方法。点击加号图标,然后选择一个对象和所需的方法。

  • 对于所有事件,您可以创建具有参数化调用所需签名的公共 void 方法。

    例如:

    public void InterstitialSomeMethod(string message) {
        Debug.Log("Interstitial show msg: " + message);
    }
    
上一篇
下一篇