---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://ads.yandex.com/helpcenter/en/easy/integration/unity/formats/UI-inspector.md
  - https://ads.yandex.com/helpcenter/ru/easy/integration/unity/formats/UI-inspector.md
  - https://ads.yandex.com/helpcenter/zh/easy/integration/unity/formats/UI-inspector.md
  - href: zh/easy/integration/unity/formats/UI-inspector.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://ads.yandex.com/helpcenter/zh/llms.txt

# 使用 UI Inspector 设置格式

设置前，请先安装 [Yandex Mobile Ads SDK 软件包](https://ads.yandex.com/helpcenter/zh/easy/integration/unity/integration/mediation.md)。

## 使用 UI Inspector 添加格式 {#add}

1. 打开我们的 [GitHub 存储库](https://github.com/yandexmobile/yandex-ads-unity-plugin/releases)并下载 `Source code.zip`。此压缩包包含 `samples` 文件夹，其中包含四个不同格式的测试文件：
    - 开屏广告。
    - 激励广告。
    - 横幅广告。
    - 插屏广告。

2. 将所有文件移动到 Unity 项目中的 `Assets` 文件夹，或使用 **Inspector** 选项卡：`添加组件/Yandex Ads/[横幅广告类型]`。之后，您可以将组件附加到其中一个场景以测试组件运作方式：

![](https://doc-static.yandex.net/support/RSYA-RMP/gif/unity_demo_samples_setup.gif)

{% cut "横幅广告" %}

**独特的横幅广告设置**
- 横幅广告类型 — 内嵌、粘性。
- 相对于屏幕的位置调整（`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`

|

广告展示次数已记录

||
|#

{% endcut %}


{% cut "插屏广告" %}

#|
||

**事件**

|

**事件触发操作**

||
||

`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`

|

广告投放失败

||
|#

{% endcut %}

{% cut "激励广告" %}

#|
||

**事件**

|

**事件触发操作**

||
||

`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`

|

广告展示获得奖励

||
|#

{% endcut %}

{% cut "开屏广告" %}

**独特的横幅广告设置**
- `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`

|

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

||
|#

{% endcut %}

## 术语 {#terms}

**冷启动**：启动不在 RAM 中的应用，创建一个新的应用会话。

**热启动**：将应用从后台模式（此时应用在内存中暂停运行）切换至前台模式。

## 开屏广告集成的特点

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


## 常规横幅广告设置 {#common-settings}

- 组件名称：您可以使用任何名称，这不会产生任何影响。

- `Ad Unit Id`：
    - **开发模式**，用于配合[演示广告单元](https://ads.yandex.com/helpcenter/zh/easy/integration/unity/testing.md#blocks)使用。

    - **生产模式**，用于配合 `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 方法。

    例如：

    ```C#
    public void InterstitialSomeMethod(string message) {
        Debug.Log("Interstitial show msg: " + message);
    }
    ```