将 DT Exchange 与中介集成

选择平台： Android（Beta 版） Android iOS Unity Flutter

本指南介绍了如何使用 GMA Next-Gen SDK 通过 AdMob 中介加载和展示 来自 DT Exchange 的广告，其中涵盖了瀑布流集成。本指南还介绍了如何将 DT Exchange 添加到广告单元的中介配置中，以及如何将 DT SDK 和适配器集成到 Android 应用中。

支持的集成和广告格式

DT Exchange 的中介适配器具有以下功能：

¹ 出价集成目前处于封闭 Beta 版阶段，请与您的客户经理联系以 申请访问权限。

要求

• Android API 级别 24 或更高级别

• 最新版 GMA Next-Gen SDK。

• 完成中介 入门指南。

第 1 步：在 DT Exchange 界面中设置配置

添加新的应用和广告展示位置

注册或登录到 DT Exchange 控制台。

点击添加应用 。

选择平台和展示位置，填写表单的其余部分，然后点击 Create App （创建应用）。

输入展示位置的名称并选择类型。然后，点击 Save Placement （保存展示位置）。

应用 ID 和展示位置 ID

将鼠标悬停在左侧导航栏上以将其打开，然后点击 App Management （应用管理）。

在 App Management （应用管理）页面上，记下应用旁边的 App ID （应用 ID）。

选择您的应用，然后前往 Placements （展示位置）标签页。 记下 Placement ID （展示位置 ID）。

发布商 ID、使用方密钥和使用方密钥令牌

在左侧菜单中点击您的用户名，然后选择 User Profile （用户个人资料）。

记下 Publisher ID（发布商 ID）、Consumer Key（使用方密钥）和 Consumer Secret（使用方密钥令牌），因为在下一步中需要用到这些信息。

更新 app-ads.txt

应用授权卖方（或 app-ads.txt）是一项 IAB Tech Lab 计划，有助于确保只通过您认定的授权渠道销售您的 应用广告资源。为避免损失大量广告收入，您需要实施 app-ads.txt 文件。 如果您尚未为应用设置 app-ads.txt 文件，请立即设置。 set up an app-ads.txt file for your app.

如需为 DT Exchange 实施 app-ads.txt， 请将 DT 添加到 app-ads.txt 文件中。

第 2 步：在 AdMob 界面中设置 DT Exchange 需求

为广告单元配置中介设置

您需要将 DT Exchange 添加到广告单元的中介配置。

首先，登录您的 AdMob 账号。接下来，前往中介 标签页。如果您要修改某个现有中介组， 请点击该中介组的名称进行修改，然后跳至 将 DT Exchange 添加为广告来源。

若要创建新中介组，请选择创建中介组 。

输入广告格式和平台，然后点击继续 。

为中介组命名，然后选择要定位到的地理位置。接下来，将 中介组状态设置为已启用 ，然后点击添加广告单元 。

将此中介组与您的一个或多个现有 AdMob 广告单元相关联。然后，点击完成 。

现在，您应该会看到“广告单元”卡片中填充了您选择的广告单元：

将 DT Exchange 添加为广告来源

出价

在广告来源 部分的出价 卡片下，选择添加广告来源 。然后选择 DT Exchange 。

点击 如何签署合作伙伴协议 ，然后 与 DT Exchange 建立出价合作伙伴关系。



点击确认并同意 ，然后点击继续 。



如果您已为 DT Exchange 创建映射， 可以选择该映射。否则，请点击添加映射 。



接下来，输入在上一部分获得的 应用 ID 和 展示位置 ID 。然后点击完成 。

瀑布

在广告来源 部分的广告瀑布流 卡片下，选择添加广告来源 。

选择 DT Exchange ，然后启用优化 开关。输入在上一部分获得的 Publisher ID（发布商 ID）、Consumer Secret（使用方密钥令牌）和Consumer Key（使用方密钥），以便为 DT Exchange 设置广告来源优化。 然后，输入 DT Exchange 的 eCPM 值 ，并点击继续 。



如果您已为 DT Exchange 创建映射，可以选择该映射。 否则，请点击添加映射 。

接下来，输入在上一部分获得的 应用 ID 和 展示位置 ID 。然后点击完成 。

将 DT Exchange（Fyber Monetization）添加到 GDPR 和美国州级法规广告合作伙伴名单中

请按照 欧洲法规设置 和 美国州级法规设置 中的步骤，将 DT Exchange (Fyber Monetization) 添加到 AdMob 界面内的欧洲法规和美国州级法规广告合作伙伴名单中。

第 3 步：导入 DT SDK 和适配器

Android Studio 集成（推荐）

在应用级 Gradle 文件中，添加以下实现依赖项和配置：

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:fyber:8.4.3.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:fyber:8.4.3.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

手动集成

• 下载最新版 DT SDK for Android，并将 fyber-marketplace-x.y.z.aar 添加到您的项目中。
• 前往 Google 的 Maven 制品库中的 DT Exchange 适配器工件 。选择最新版本，下载 DT Exchange 适配器的 .aar 文件，并将其添加到您的项目中。

第 4 步：在 DT SDK 上实现隐私设置

欧盟地区用户意见征求和 GDPR

为了遵守 Google 的《欧盟地区用户意见征求政策》，您必须：向位于欧洲经济区 (EEA)、英国和瑞士境内的用户披露相关信息；如果法律要求在使用 Cookie 或存储在本地的其他 ID 之前必须先征得用户同意，您必须照做；如果需要收集、分享和使用个人数据来实现广告个性化，也必须征得用户同意。此政策反映了欧盟《电子隐私指令》和《一般数据保护条例》(GDPR) 的要求。您要负责验证用户意见是否已传播到中介链中的每个广告来源。 Google 无法自动将用户意见传递给此类广告资源网。

从 DT Exchange SDK 8.3.0 版开始，DT Exchange 会自动读取支持Google 的额外意见规范的意见管理平台设置的 GDPR 意见。如需了解详情，请参阅 DT Exchange GDPR 实现指南。

美国州级隐私保护法律

美国各州隐私保护法律要求向用户提供选择拒绝“出售”其“个人信息”（该法律中对这些术语做出了定义）的权利，“出售”方须在首页醒目位置提供“Do Not Sell My Personal Information”（不出售我的个人信息）链接，以供这些用户选择。美国州级隐私保护法律合规性指南可让您为 Google 广告投放启用受限的数据处理，但 Google 无法将此设置应用于您的中介链中的每个广告联盟。因此，您必须确定中介链中可能参与个人信息出售的每个广告联盟，并遵循这些广告联盟的指南来确保合规性。

DT Exchange 包含一个 API，可让您将用户同意转发给其 SDK。以下示例代码展示了如何手动将用户意见信息传递给 DT SDK。如果您选择手动将用户意见信息传递给 DT SDK，建议您在通过 GMA Next-Gen SDK请求广告之前调用此代码。

InneractiveAdManager.setUSPrivacyString(US_PRIVACY_STRING);
DTExchangeMediationSnippets.java

InneractiveAdManager.setUSPrivacyString(US_PRIVACY_STRING)
DTExchangeMediationSnippets.kt

将 US_PRIVACY_STRING 替换为您的美国隐私权 字符串。

如需了解详情以及可在该方法中提供的值，请访问 DT Exchange 的 CCPA 实现指南 。

第 5 步：添加必需的代码

使用 activity 上下文加载广告

加载插页式广告格式时，传递 Activity 上下文。如果没有 activity 上下文，广告加载将会失败。

第 6 步：测试您的实现

启用测试广告

请确保您已为 AdMob 注册测试设备。

验证测试广告

若要验证您是否能收到来自 DT Exchange 的测试广告，请在广告检查器中启用 single ad source testing （单个广告来源测试），并选择 DT Exchange (Bidding) and DT Exchange (Waterfall)（DT Exchange [出价] 和 DT Exchange [瀑布]）作为广告来源。

可选步骤

广告资源网专用参数

DT Exchange 适配器支持其他请求参数，这些参数可以作为 Android Bundle 传递给适配器。适配器会在 Bundle 中查找以下键：

以下代码示例展示了如何设置这些广告请求参数：

Bundle extras = new Bundle();
extras.putInt(InneractiveMediationDefs.KEY_AGE, 10);
extras.putBoolean(FyberMediationAdapter.KEY_MUTE_VIDEO, false);

AdRequest request =
    new AdRequest.Builder().addNetworkExtrasBundle(FyberMediationAdapter.class, extras).build();
DTExchangeMediationSnippets.java

val extras = Bundle()
extras.putInt(InneractiveMediationDefs.KEY_AGE, 10)
extras.putBoolean(FyberMediationAdapter.KEY_MUTE_VIDEO, false)

val request =
  AdRequest.Builder().addNetworkExtrasBundle(FyberMediationAdapter::class.java, extras).build()
DTExchangeMediationSnippets.kt

错误代码

如果适配器未能收到来自 DT Exchange 的广告，您可以使用 来检查广告响应中归属于以下类的 ResponseInfo.getAdSourceResponses() 底层错误：

com.google.ads.mediation.fyber.FyberMediationAdapter

以下是当广告加载失败时，DT Exchange 适配器会抛出的代码和随附的消息：