# DT Exchange 集成

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

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

本指南将逐步说明如何在 Unity LevelPlay Mediation 中将 DT Exchange Live 设置为广告网络。

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

## 先决条件##prerequisites

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

  **Integration guides:**

  * [奖励广告服务](/grow/levelplay/sdk/android/rewarded-ads-integration.md)
  * [插屏广告](/grow/levelplay/sdk/android/interstitial-integration.md)
  * [横幅广告](/grow/levelplay/sdk/android/banner-integration.md)

* DT Exchange 支持 Android 操作系统版本 4.1（API 级别 16）及更高版本。

## 步骤 1.创建 DT Exchange 帐户

1. 使用 DT Exchange 创建帐户。您可以在[此处](https://console.fyber.com/sign-up)执行此操作。
2. 验证您的帐户后，您可以在[此处](https://console.fyber.com/login)登录他们的合作伙伴。

## 步骤 2.在 DT Exchange 中创建应用程序和广告位

要在 IronSource 平台中访问 DT Exchange 资源库，必须首先添加 app 并在 DT Exchange 帐户中设置广告位。

1. **添加 app**
   1. 日志 DT Exchange 帐户，导航到“Monetization”>“New app Management”。选择“**添加 app**”。
   2. 定义 app 的设置：选择平台和类别
   3. 添加广告位 - 奖励广告服务、插页式广告、横幅广告、MREC
   4. 设置完成后，选择 **Create app**

## 步骤 3.在 SDK Networks 设置模块中激活 DT Exchange

要使 DT Exchange 能够与 LevelPlay SDK 正常工作，必须将 DT Exchange 帐户中的一些参数插入到 ironSource 平台上的 SDK 网络设置模块中：

|                                        |                                                                         |
| -------------------------------------- | ----------------------------------------------------------------------- |
| \*\*发布者 ID、\*\*\*\*消费者密钥、\*\***消费者密钥** | 这是 DT Exchange 帐户的唯一标识符，允许 IronSource 平台从 DT Exchange 帐户导入性能数据以用于报告和优化。 |
| **App ID（应用 ID）**                      | 这是 DT Exchange 系统中应用程序的唯一标识符。                                           |
| **Placement ID**                       | 这是 DT Exchange 将向其投放广告服务的唯一位置。                                          |

获取此信息后，必须在 ironSource 帐户中**配置 DT Exchange 参数**。正确添加上述信息后，您将能够充分利用 IronSource 平台上的 DT Exchange 广告库存和报告数据。

1. \*\*\*\***Publisher ID、** **Consumer Key、****Consumer Secret****** 导航到 **User Profile** 页面，然后在页面底部的“Reporting API Keys”下找到它们
2. **app ID、放置/位置 ID** 导航到 'Inventory' > 'Manage Apps & Sites' > 从列表中选择相关应用程序 > 从右侧菜单中选择 'Integration Options'。

**将 DT Exchange 参数配置为 ironSource 帐户**

* 拥有所有这些参数后，登录 IronSource 帐户，然后转到 **Monetize** > **Mediation** > **SDK Networks**。
* 从 **Available Ad Networks** 列表中选择 DT Exchange，然后输入 DT Exchange **Publisher ID**、**Consumer Key** 和 **Consumer Secret**。 选择 **Save（保存）**。
* 然后，将在 **Available Ad Networks** 表中启用 DT Exchange。
* 确保定义要使用 DT Exchange 运行 Unity LevePlay 的app程序。转到 Ad Networks 的设置列表上的 DT Exchange 行，然后选择 **Setup**。
* 在应用程序级别上插入 **app** **ID** 和相关广告单位的**放置/位置 ID**。
* 选择 **Save（保存）**。
* 激活请求的广告单位。
* 验证与 Reporting API 的集成；此列将通过 Reporting API 检查您的集成，并返回三种可能的响应：Verified、Failed 和 No Response。仔细检查您的集成和上面输入的信息；然后选择 **Retry**（重试），直到看到 **Verified（已验证**）。

## 步骤 4.将 DT Exchange 适配器添加到构建中##step-4.-add-the-dt-exchange-adapter-to-your-build

LevelPlay SDK 支持适配器的 Gradle 依赖关系和手动下载机制，而 DT ExchangeSDK 仅支持手动下载。

**Gradle：**

1. 确保 app 模块的构建.gradle 脚本中存在以下 Maven 网址。
   ```java
   repositories {
       mavenCentral()
   }
   ```

2. 将适配器的 Maven 名称添加到 app 模块的构建.gradle 脚本。
   ```java
   dependencies {
      implementation 'com.unity3d.ads-mediation:fyber-adapter:5.3.0'
      implementation 'com.fyber:marketplace-sdk:8.4.2'
   }
   ```

**手动\*\*\*\*下载：**

1. \*\*下载 DT Exchange 适配器：\*\*将 DT Exchange 适配器添加到构建中。您可以在[此处](/grow/levelplay/sdk/android/mediation-networks.md)找到最新的 DT Exchange 适配器。

2. \*\*将 DT Exchange 适配器添加到项目中：\*\*下载适配器后，将 DT ExchangeAdapter jar 放入 Android 项目的 **libs** 文件夹。

   ![将适配器 JAR 文件拖放到 Android 项目的 libs 文件夹中。](/api/media?file=/grow/media/images/Supersonic-Mediation-Drop-Libs.png)

3. 确保在 Gradle 构建文件的 **dependencies 部分**下添加以下内容
   ```java
   dependencies {
      implementation 'com.unity3d.ads-mediation:fyber-adapter:5.3.0'
      implementation 'com.fyber:marketplace-sdk:8.4.2'
   }
   ```

4. **下载 DT Exchange [.AAR](https://developers.is.com/wp-content/uploads/2020/04/InneractiveAdSDK-Android-v7.5.3.zip) 文件**
   1. 如果使用 Eclipse：将 .AAR 文件作为库项目导入。
   2. 如果使用 Android Studio，请下载 DT Exchange .AAR 文件并作为依赖项添加到您自己的模块。转到**文件** > **New** > **New Module** > **Import .AAR**，然后导航到已下载 Fyber .AAR 文件的位置。

## 验证广告网络集成##verify-your-ad-network-integration

* 验证您的广告网络与我们的 [Integration Helper](/grow/levelplay/sdk/android/integration-helper.md) 集成。LevelPlay SDK 提供了一个工具，可确保已成功集成我们的 SDK 以及任何其他网络适配器。
* 使用此布尔值管理集成的聚合广告网络的调试日志

  ```java
  LevelPlay.setAdaptersDebug(true);
  ```

  设置为 **TRUE** 时，这行代码将启用调试日志，以帮助您解决所有聚合广告网络的问题。 在 app 与我们的广告单位上线之前，请删除此代码！ 

## 步骤 5。DT Exchange 附加设置##step-5.-dt-exchange-additional-settings

### Google 家庭政策和 DFF##google-families-policy-&-dff

Unity LevelPlay 聚合允许发布者将 DT Exchange 面向儿童的设置直接传达给 DT Exchange 网络。此功能是使用 LevelPlay SDK 7.2.5+、DT Exchange Android 适配器 4.3.23+ 已启用的。

使用以下语法添加对儿童受众的支持：

```java
LevelPlay.setMetaData("DT_IsChild", "true");
```

要了解有关 DT Exchange 网络下的 Google 家庭策略支持的更多信息，请访问[此处](https://developer.digitalturbine.com/hc/en-us/articles/360010822437-Integrating-the-Android-SDK)。

### 用户级别 COPPA##user-level-coppa

Unity LevelPlay 允许发行商将 DT Exchange 用户级别的 COPPA 设置直接传达给 DT Exchange 网络。此功能是使用 LevelPlay SDK 7.3.0.1+、DT Exchange Android 适配器 4.3.26+ 已启用的。

使用以下语法使用参数“True”更新 COPPA：

```java
LevelPlay.setMetaData("DT_COPPA", "true");
```

您现在可以在应用程序中投放 DT Exchange 广告服务。