此页面由 Cloud Translation API 翻译。

将 myTarget 与中介集成

本指南面向希望使用 Google 移动广告 SDK 通过中介加载和展示来自 myTarget 的广告的发布商。其中介绍了如何将 myTarget 添加到广告单元的中介配置，以及如何将 myTarget SDK 和适配器集成到 iOS应用中。

支持的集成和广告格式

适用于 myTarget 的 AdMob 中介适配器具有以下功能：

集成
出价
瀑布
格式
横幅
插页式广告
激励广告
原生

要求

iOS 部署目标为 10.0 或更高版本

最新版 Google 移动广告 SDK

第 1 步：设置 myTarget 网络

首先，注册或登录您的 myTarget 帐号。点击标题上的应用可导航到“应用”页面。点击添加应用以添加您的应用。

接下来，为应用提供 iTunes 网址。

添加应用时，myTarget 需要您创建一个广告单元，然后才能完成此流程。

从可用的广告格式中选择 BANNER，然后点击添加广告单元按钮。

插页式广告

从可用的广告格式中选择插页式，然后点击添加广告单元按钮。

激励广告

从可用的广告格式中选择激励视频广告，然后点击添加广告单元按钮。

原生

从可用的广告格式中选择 NATIVE，然后点击 Add ad Unit（添加广告单元）。

在广告单元的详情页面中，记下您的广告位 ID（可在广告单元设置下找到，格式为 slot_id）。在下一部分中，系统会使用此广告位 ID 设置您的 AdMob 广告单元。

除了 slot_id 之外，您还需要使用 MyTarget 永久访问令牌来设置 AdMob 广告单元 ID。转到 Profile 标签页，然后选择 Access Tokens。点击创建令牌或显示令牌以查看 MyTarget 永久访问令牌。

第 2 步：为广告单元 AdMob 配置中介设置

您需要将 myTarget 添加到广告单元的中介配置中。首先，登录您的 AdMob 帐号。

接下来，转到中介标签页。如果您已有要修改的中介组，请点击该中介组的名称进行修改，然后直接跳至将 myTarget 添加为广告来源。

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

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

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

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

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

将 myTarget 添加为广告来源

在“广告来源”卡片中，选择添加广告联盟。

选择 myTarget 作为广告联盟，启用优化开关，输入在上一部分中获取的永久访问令牌，然后输入 MyTarget 的有效每千次展示费用值，为 MyTarget 设置 ANO。点击继续。

输入在上一部分中获取的广告位 ID，然后点击完成。

使用激励广告

在激励广告单元的设置中，提供奖励金额和奖励类型的值。然后，为确保无论投放哪个广告联盟，您都能向用户提供相同的奖励，请选中 应用于中介组中的所有广告联盟复选框。

如果您不应用此设置，myTarget 适配器会默认采用值为 "" 的空字符串形式的字符串（值为 1）。

如需详细了解如何为 AdMob 广告单元设置奖励值，请参阅创建广告单元。

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

使用 CocoaPods（推荐）

将以下行添加到项目的 Podfile 中：
```
pod 'GoogleMobileAdsMediationMyTarget'
```
从命令行中运行以下命令：
```
pod install --repo-update
```

手动集成

下载最新版本的 myTarget SDK。
从变更日志的下载链接中下载最新版本的 myTarget 适配器，并在项目中下载 MyTargetAdapter.framework。
将以下框架添加到您的项目中：
- CoreLocation
- CoreTelephony
- CoreMedia
- SystemConfiguration
- StoreKit
- AdSupport
- SafariServices
- AVFoundation

第 4 步：需要其他代码

myTarget 集成不需要其他代码。

第 5 步：测试您的实现效果

在测试时，myTarget 建议使用其开源示例应用中的广告位 ID 来请求广告。您可以输入这些 ID 作为AdMob 广告单元的广告位 ID 进行测试，然后在您的应用准备好投入实际使用时将其替换为实际的广告位 ID。

可选步骤

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

根据 Google《欧盟地区用户意见征求政策》，您必须确保向欧洲经济区 (EEA) 内的用户披露与使用设备标识符和个人数据有关的信息，以及征得这些用户的同意。此政策反映了欧盟《电子隐私指令》和《一般数据保护条例》(GDPR) 的要求。在征求用户意见时，您必须指明中介链中可能会收集、接收或使用个人数据的广告联盟，并提供各个广告联盟的使用情况信息。Google 目前无法自动将用户的意见传递给此类网络。

以下部分介绍了如何为 myTarget 启用或停用个性化广告。

在 myTarget SDK 版本 4.7.9中，myTarget 添加了用户用户意见征求 API。以下示例代码展示了如何在 myTarget SDK 上将用户同意设置为YES 。如果您选择调用此方法，建议您在通过 Google 移动广告 SDK 请求广告之前执行此操作。

#import <MyTargetSDK/MyTargetSDK.h>
// ...

[MTRGPrivacy setUserConsent:YES];

此外，如果已知用户属于有年龄限制的类别，您可以使用 setUserAgeRestricted: 方法。

[MTRGPrivacy setUserAgeRestricted:YES];

如需了解详情，请参阅 myTarget 的 GDPR 指南。

广告联盟专用参数

myTarget 适配器支持 isDebugMode，这是一个用于启用日志记录的可选 extra，默认值为 YES。该参数可以使用 GADMAdapterMyTargetExtras 类传递给适配器，并且必须针对每个广告请求进行设置。设置方法如下：

Swift

let request = GADRequest()
let extras = GADMAdapterMyTargetExtras()
extras.isDebugMode = false
adRequest.register(extras)

Objective-C

GADRequest *request = [GADRequest request];
GADMAdapterMyTargetExtras * extras = [[GADMAdapterMyTargetExtras alloc] init];
extras.isDebugMode = NO;
[request registerAdNetworkExtras:extras];

使用原生广告

广告呈现

myTarget 适配器以GADNativeAd对象的形式返回其原生广告。它填充了GADNativeAd。

字段	由 myTarget 适配器填充
标题	始终
映像	始终
车身	始终
应用图标	始终
号召性用语	始终
Star rating	不保证
存储	不保证
价格	不保证
徽标	不保证
广告客户	始终

展示和点击跟踪

Google 移动广告 SDK 使用 myTarget SDK 的回调来跟踪展示和点击，因此来自两个来源的报告应该几乎没有差异。

错误代码

如果适配器未能从 myTarget 收到广告，发布商可以使用以下类中的 GADResponseInfo.adNetworkInfoArray，位于以下类下：

GADMAdapterMyTarget
GADMediationAdapterMyTargetNative
GADMediationAdapterMyTargetRewarded

广告加载失败时，myTarget 适配器抛出的代码和附带的消息如下：

错误代码	原因
100	myTarget SDK 返回错误。
101	AdMob 界面中配置的 myTarget 服务器参数缺失/无效。
102	请求的广告尺寸与 myTarget 支持的横幅广告尺寸不符。
103	广告请求不是统一的原生广告请求。
104	从 myTarget 加载的原生广告与所请求的原生广告不同。
105	从 myTarget 加载的原生广告缺少一些必需的素材资源（例如图片或图标）。
100	myTarget SDK 还没有广告。
101	AdMob 界面中配置的 myTarget 服务器参数缺失/无效。
102	myTarget Adapter 不支持所请求的广告格式。
103	尝试展示一个未加载的 myTarget 广告。
104	请求的广告尺寸与 myTarget 支持的横幅广告尺寸不符。
105	缺少必需的原生广告素材资源。