如需讨论我们的产品并提供反馈，请加入 Google 广告和效果衡量社区服务器中的官方 Ad Manager Discord 频道。

此页面由 Cloud Translation API 翻译。

将 DT Exchange 与中介集成

本指南介绍了如何使用 Google 移动广告 SDK 通过中介加载和展示来自 DT Exchange 的广告（内容涵盖瀑布流集成）、如何将 DT Exchange 添加到广告单元的中介配置，以及如何将 DT SDK 和适配器集成到 iOS 应用中。

支持的集成和广告格式

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

集成
出价	¹
瀑布
表现形式
横幅
插页式广告
激励广告	²
原生

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

² 只有瀑布流中介支持激励广告。

要求

iOS 部署目标版本为 12.0 或更高版本
[对于出价]：如需在出价中集成所有受支持的广告格式，请使用 DT Exchange 适配器 8.3.8.0 或更高版本（建议使用最新版本）。

最新版 Google 移动广告 SDK
通读中介入门指南

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

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

注册或登录 DT Exchange 控制台。

点击添加应用。

管理应用

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

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

应用 ID 和展示位置 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

出价

出价集成不需要执行此步骤。

瀑布

依次前往管理 > 公司，然后点击所有公司标签页中的新公司按钮。选择广告资源网。

选择 DT Exchange 作为广告联盟，输入唯一的名称，然后启用中介。开启自动收集数据，然后输入在上一部分中获得的发布商 ID、使用方密钥和使用方 Secret。

您无需输入用户名或密码。完成后，点击保存。

启用安全信号共享

出价

依次前往管理 > 全局设置。前往 Ad Exchange 账号设置标签页，然后查看并开启安全信号共享。点击保存。

瀑布

对于瀑布流集成，则无需执行此步骤。

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

出价

依次前往广告资源 > 安全信号。在安全信号下方，搜索 DT Exchange (Fyber Monetization)，然后将启用应用集成切换到开启状态。

点击保存。

瀑布

对于瀑布流集成，则无需执行此步骤。

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

出价

依次前往投放 > 需求渠道设置。在默认设置标签页中，将允许共享安全信号切换到开启状态，以便进行 SDK 出价。

点击保存。

瀑布

对于瀑布流集成，则无需执行此步骤。

配置 DT Exchange 出价

出价

依次前往投放 > 出价方，然后点击前往“SDK 出价”页面。

点击新增出价方。

选择 DT Exchange 作为出价方。

点击继续即可为此出价方启用 SDK 出价。

点击完成。

瀑布

对于瀑布流集成，则无需执行此步骤。

配置广告单元映射

出价

依次前往投放 > 出价方，然后点击前往“SDK 出价”页面。

选择 DT 交易平台的公司。

前往广告单元映射标签页，然后点击新建广告单元映射。

选择特定广告单元。选择广告单元和格式，选择移动应用作为广告资源类型，并选择您的移动应用。然后，输入在上一部分获得的应用 ID 和展示位置 ID。最后，点击保存。

瀑布

依次前往投放 > 收益组，然后点击新建收益组按钮。选择您的移动应用。

向下滚动，然后点击添加收益合作伙伴。

选择您在上一部分中为 DT Exchange 创建的公司。选择移动 SDK 中介作为集成类型，iOS 作为平台，有效作为状态。

输入在上一部分中获得的应用 ID 和展示位置 ID，以及默认每千次展示费用值。点击保存。

注意：“自动收集数据”功能需要几天时间来收集数据，然后才能准确计算中介广告联盟的动态 CPM 值。可以计算出 eCPM 后，系统会自动代表您更新此值。

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

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

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

使用 CocoaPods（推荐）

将以下行添加到项目的 Podfile：

pod 'GoogleMobileAdsMediationFyber'

在命令行中，运行以下代码：

pod install --repo-update

手动集成

下载最新版本的 DT SDK for iOS 并关联 IASDKCore.xcframework。
从更改日志中的下载链接下载最新版本的 DT Exchange 适配器，并在项目中关联 DTExchangeAdapter.xcframework。

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

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

为了遵守 Google 的《欧盟地区用户意见征求政策》，您必须向欧洲经济区 (EEA)、英国和瑞士的用户披露某些信息，并征得他们同意，才能在法律要求的情况下使用 Cookie 或其他本地存储空间，以及收集、分享和使用个人数据以实现广告个性化。此政策反映了欧盟《电子隐私指令》和《一般数据保护条例》(GDPR) 的要求。您要负责验证用户意见是否已传播到中介链中的每个广告来源。Google 无法自动将用户意见传递给此类广告资源网。

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

Swift

import IASDKCore
// ...

IASDKCore.sharedInstance().gdprConsent = IAGDPRConsentType.given
IASDKCore.sharedInstance().gdprConsentString = "myGdprConsentString"

Objective-C

#import <IASDKCore/IASDKCore.h>
// ...

[IASDKCore.sharedInstance setGDPRConsent:YES];
[IASDKCore.sharedInstance setGDPRConsentString:@"myGdprConsentString"];

如需详细了解该方法中可能提供的值，请访问 DT Exchange 的 GDPR 实施指南。

美国州级隐私权法

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

Swift

import IASDKCore
// ...

IASDKCore.sharedInstance().ccpaString = "myCCPAConsentString"

Objective-C

#import <IASDKCore/IASDKCore.h>
// ...

[IASDKCore.sharedInstance setCCPAString:@"myCCPAConsentString"];

如需详细了解此方法中可能提供的值，请访问 DT Exchange 的 CCPA 实施指南。

第 5 步：添加必需的代码

SKAdNetwork 集成

按照 DT Exchange 的文档将 SKAdNetwork 标识符添加到项目的 Info.plist 文件中。

第 6 步：测试您的实现

启用测试广告

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

验证测试广告

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

可选步骤

广告资源网专用参数

DT Exchange 适配器支持可以使用 GADMAdapterFyberExtras() 传递给适配器的其他请求参数。适配器会在软件包中查找以下键：

请求参数和值
`setUserData` 用户的年龄、性别和邮政编码。	`IAUserData`
`setMuteAudio`	Boolean。将视频静音或取消静音

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

Swift

let userData = IAUserData.build({ builder in
  builder.age = 23
  builder.gender = IAUserGenderType.male
  builder.zipCode = "1234"
}];

let request = GAMRequest()
let extras = GADMAdapterFyberExtras()
extras.userData = userData
extras.muteAudio = true
request.register(extras)

Objective-C

IAUserData *userData = [IAUserData build:^(id<IAUserDataBuilder> _Nonnull builder) {
    builder.age = 23;
    builder.gender = IAUserGenderTypeMale;
    builder.zipCode = @"1234";
}];

GAMRequest *request = [GAMRequest request];
GADMAdapterFyberExtras *extras = [[GADMAdapterFyberExtras alloc] init];
extras.userData = userData;
extras.muteAudio = YES;
[request registerAdNetworkExtras:extras];

如需了解详情，请参阅 DT Exchange 集成指南。

错误代码

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

GADMediationAdapterFyber

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

错误代码	原因
0-10	DT SDK 返回了错误。如需了解详情，请参阅文档。
101	在 Ad Manager 界面中配置的 DT Exchange 服务器参数缺失/无效。
102	所请求的广告尺寸与 DT Exchange 支持的横幅尺寸不一致。
103	未能展示广告，因为广告对象已被使用。
104	由于广告未就绪，未能展示 DT Exchange 广告。
105	DT SDK 返回了初始化错误。