# Ogury 集成

> 通过创建 Ogury 帐户、设置广告单位并将 Ogury 适配器添加到项目中，将 Ogury 与 Unity LevelPlay 集成。

> **Important:**
>
> 以下文档涉及非 Unity 开发、拥有或运营的产品或服务（“第三方产品”）。
> 这些信息可能已过时或不完整，仅为方便您参考才提供。
> 您对任何第三方产品的使用均受产品自身条款的约束。
> Unity 对这些产品不提供任何担保，也不对因使用这些产品而造成的任何损害或损失负责，包括与第三方供应商提供的内容、广告或材料有关的问题。

> **Note:**
>
> 要查看此聚合网络的适配器更改日志，请参阅[适用于 Android 的聚合网络](/grow/levelplay/sdk/android/mediation-networks.md.md#integrate-network-adapters)。

本指南将逐步指导如何在 Unity LevelPlay 中将 Ogury Live 设置为广告网络。

## 先决条件

确保将奖励广告服务、插页式广告服务或横幅广告服务正确集成到应用程序中。请参阅以下指定的于平台的指南以了解集成说明：

**Rewarded ads integration:**

* [Unity](/grow/levelplay/sdk/unity/rewarded-ad-integration-package.md.md)
* [Android](/grow/levelplay/sdk/android/rewarded-ads-integration.md.md)
* [iOS](/grow/levelplay/sdk/ios/rewarded-ads-integration.md.md)
* [Adobe Air](/grow/levelplay/sdk/adobe/rewarded-ads-integration.md.md)
* [Flutter](/grow/levelplay/sdk/flutter/rewarded-ads-integration.md.md)
* [原生反应](/grow/levelplay/sdk/react/rewarded-ads-integration.md.md)

**Interstitial integration:**

* [Unity](/grow/levelplay/sdk/unity/interstitial-integration.md.md)
* [Android](/grow/levelplay/sdk/android/interstitial-integration.md.md)
* [iOS](/grow/levelplay/sdk/ios/interstitial-integration.md.md)
* [Adobe Air](/grow/levelplay/sdk/adobe/interstitial-integration.md.md)
* [Flutter](/grow/levelplay/sdk/flutter/interstitial-integration.md.md)
* [原生反应](/grow/levelplay/sdk/react/interstitial-integration.md.md)

**Banner integration:**

* [Unity](/grow/levelplay/sdk/unity/banner-integration.md.md)
* [Android](/grow/levelplay/sdk/android/banner-integration.md.md)
* [iOS](/grow/levelplay/sdk/ios/banner-integration.md.md)
* [Adobe Air](/grow/levelplay/sdk/adobe/banner-integration.md.md)
* [Flutter](/grow/levelplay/sdk/flutter/banner-integration.md.md)
* [原生反应](/grow/levelplay/sdk/react/banner-integration.md.md)

## 步骤 1.创建 Ogury 帐户

在通过 Unity LevelPlay Mediation 激活 Ogury 广告库存之前，您需要在 Ogury 中拥有经批准的 Monetization 帐户。如果您没有帐户，请在 [Ogury 站点](https://publishers.ogury.co/registration)注册或联系 [app-all@ogury.co](mailto:app-all@ogury.co)

## 步骤 2.在 Ogury Dashboard 中创建资源和广告单位

如果在 Ogury Monetization（变现）后台中已经创建了广告单位，请跳至步骤 3 在 UnityLevelPLay 广告单位中激活 Ogury。

1.  **添加 app**

您可以直接在 [Ogury Monetization 后台](https://publishers.ogury.co/dashboard)中注册资源，也可以联系发布者经理为您创建资源。 

* 要自行创建，请选择屏幕右上角的“NEW 资产”，然后选择 Android 或 iOS app
  ![NEW Asset 按钮](/api/media?file=/grow/media/images/Screenshot-2024-10-07-at-10.42.11.png) - 在 app 选择字段中搜索或键入应用程序名称，并在 app NAME 和 BUNDLE 字段中键入应用程序的软件包名称和 Bundle 名称。
* 选择 REGISTER 资产。

  ![应用选择表单](/api/media?file=/grow/media/images/Screenshot-2024-10-07-at-10.42.20.png)
* 对于 Android 应用程序，可以声明资源的年龄类别（稍后可以执行此操作），选择 **CONTINUE**。

  ![年龄类别选择](/api/media?file=/grow/media/images/Screenshot-2024-10-07-at-10.42.26.png)
* 您可以从 Ogury Monetization（变现）后台的 Assets（资源）> Overview（概述）部分中检索资产密钥。稍后在 Unity LevelPlay 平台中启用 Ogury 网络将需要此信息。

  ![资源密钥位置](/api/media?file=/grow/media/images/Screenshot-2024-10-07-at-10.42.33.png) 

2. **创建广告单位**

* 进入 Ogury 的 Publishers 平台，然后选择要设置的资产 
* 在屏幕左侧的菜单中选择“Monetization 设置”
* 选择屏幕右上角的 **NEW AD UNIT**
  ![NEW AD Unit 按钮](/api/media?file=/grow/media/images/Screenshot-2024-10-07-at-10.42.39.png) -- 您将在屏幕右侧看到一个弹出展开窗口，您可以添加所需信息： 
  * ad unit name（广告单元名称）
  * 集成类型 
  * 广告单元类型（格式类型）
  * fixed(Landscape/Portrait) 或灵活定向
    ![广告单位配置表](/api/media?file=/grow/media/images/Screenshot-2024-10-07-at-10.42.46.png) -- -- 创建广告单位后，可从 Ogury Monetization（变现）后台中查看这些广告单位的摘要。 
* 您可以从 Ogury Monetization（变现）后台的 Assets（资源）> Monetization Settings（变现设置）部分中检索广告单元 ID。为此，请选择与要检索其 ID 的广告单元关联的 AD UNIT ID 列中的 **⎘** 图标。稍后在 Unity LevelPlay 平台中启用 Ogury 网络将需要此信息。
  ![Ad Unit ID 复制按钮](/api/media?file=/grow/media/images/Screenshot-2024-10-07-at-10.42.52.png)

3. **创建报告 API 令牌**

* 转到 Ogury Publisher（Ogury 发布者）后台。在右上角选择您的姓名，然后打开帐户设置

  ![帐户设置菜单](/api/media?file=/grow/media/images/Screenshot-2024-10-07-at-10.42.57.png)
* 转到 API 令牌

  ![API 令牌部分](/api/media?file=/grow/media/images/Screenshot-2024-10-07-at-10.43.03.png)
* 在表中查找 Reporting API，然后选择 **Create Token**。
* 在 UnityLevelPlay 平台中复制并粘贴令牌，以便稍后启用 Ogury Network。

  ![创建令牌按钮](/api/media?file=/grow/media/images/Screenshot-2024-10-07-at-10.43.08.png) 
* 妥善保管令牌！如果令牌丢失，则需要将其撤销并重新创建。旧令牌将立即停止工作。

## 步骤 3.在 LevelPlay 平台上激活 Ogury

1. 登录 LevelPlay 帐户，然后转到 **LevelPlay 侧导航栏** > **Setup** > **Networks**
2. 选择 **Manage Networks**（管理网络），然后从可用广告网络列表中选择 Ogury（Ogury）。输入 Reporting API 令牌 
3. 接下来，选择要在其上运行 Unity LevelPlay 的 Mediation with **Ogury** bid 的应用。
4. 从 Ad Networks 的设置列表中选择 Ogury，然后选择 tool **Setup** 按钮。
5. 插入 **Interstitial**、**奖励广告服务**、**横幅广告和原生**设置的相关信息。然后选择 **保存。**

网络将针对 app 激活。

## 步骤 4.将 Ogury 适配器添加到构建中##step-4.-add-the-ogury-adapter-to-your-build

Unity LevelPlay 支持 Gradle 依赖关系和手动下载机制。

### Gradle##gradle

1. 确保 app 模块的构建.gradle 脚本中存在以下 Maven 网址。

```groovy
repositories {
  mavenCentral()
  maven {
    url "https://maven.ogury.co"
  }
}
```

2. 将适配器的 Maven 名称添加到 app 模块的构建.gradle 脚本。

```groovy
dependencies {
  implementation 'com.unity3d.ads-mediation:ogury-adapter:5.2.0'
  implementation 'co.ogury:ogury-sdk:6.2.1'
}
```

现在可以在应用程序中交付 Ogury。