将 DT Exchange 与中介集成

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

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

支持的集成和广告格式

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

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

要求

• Android API 级别 24 或更高级别

• “GMA Next-Gen SDK”的最新视频。

• 完成中介入门指南。

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

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

注册或登录 DT Exchange 控制台。

点击添加应用。

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

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

应用 ID 和展示位置 ID

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

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

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

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

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

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

更新 app-ads.txt

应用授权卖方 (app-ads.txt) 是一项 IAB Tech Lab 计划，有助于确保只通过您认定的授权渠道销售您的应用广告资源。为避免损失大量广告收入，您需要实施 app-ads.txt 文件。 如果您尚未完成此项操作，请为 Ad Manager 创建 app-ads.txt 文件。

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

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

登录您的 Ad Manager 账号。

在“公司”中添加 DT Exchange

启用安全信号共享

在出价请求中共享安全信号

允许出于 SDK 出价目的共享安全信号

配置 DT Exchange 出价

配置广告单元映射

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

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

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

Android Studio 集成（推荐）

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

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    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.24.0-beta02'
    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 或其他本地存储（如果法律有此要求），以及收集、分享和使用个人数据以实现广告个性化。此政策反映了欧盟《电子隐私指令》和《一般数据保护条例》(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 步：测试您的实现

启用测试广告

确保针对 Ad Manager 注册测试设备。

验证测试广告

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

可选步骤

广告资源网专用参数

DT Exchange 适配器支持可作为 Android 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 适配器会抛出的代码和随附的消息：