将 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 和适配器

  • 将以下行添加到项目的 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。

可选步骤

根据 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 缺少必需的原生广告素材资源。

myTarget iOS 中介适配器变更日志

版本 5.15.1.0

  • 经验证与 myTarget SDK 5.15.1 版本兼容。

构建和测试时使用的工具:

  • Google 移动广告 SDK 9.2.0 版。
  • MyTarget SDK 版本 5.15.1。

版本 5.15.0.1

  • 添加了对 arm64 模拟器架构的支持。

构建和测试时使用的工具:

  • Google 移动广告 SDK 9.0.0 版。
  • MyTarget SDK 版本 5.15.0。

版本 5.15.0.0

  • 经验证与 myTarget SDK 5.15.0 版本兼容。
  • 经验证与 Google 移动广告 SDK 9.0.0 版本兼容。
  • 现在需要使用 Google 移动广告 SDK 9.0.0 或更高版本。

构建和测试时使用的工具:

  • Google 移动广告 SDK 9.0.0 版。
  • MyTarget SDK 版本 5.15.0。

版本 5.14.4.0

  • 经验证与 myTarget SDK 5.14.4 兼容。

构建和测试所用平台:

  • Google 移动广告 SDK 版本 8.13.0。
  • MyTarget SDK 版本 5.14.4。

版本 5.14.3.0

  • 经验证与 myTarget SDK 5.14.3 兼容。
  • 添加了对在 GADMAdapterMyTargetExtras 中设置参数的支持。
  • 添加了对在激励广告中传递 extra 的支持。

构建和测试所用平台:

  • Google 移动广告 SDK 版本 8.13.0。
  • MyTarget SDK 5.14.3。

版本 5.14.2.0

  • 经验证与 myTarget SDK 5.14.2 兼容。

构建和测试所用平台:

  • Google 移动广告 SDK 版本 8.12.0。
  • MyTarget SDK 版本 5.14.2。

版本 5.14.1.0

  • 经验证与 myTarget SDK 5.14.1 版本兼容。

构建和测试所用平台:

  • Google 移动广告 SDK 版本 8.11.0。
  • MyTarget SDK 版本 5.14.1。

版本 5.14.0.0

  • 经验证与 myTarget SDK 5.14.0 兼容。
  • 现在要求的最低操作系统版本为 10.0。

构建和测试所用平台:

  • Google 移动广告 SDK 版本 8.11.0。
  • MyTarget SDK 版本 5.14.0。

版本 5.13.1.0

  • 经验证与 myTarget SDK 5.13.1 兼容。

构建和测试所用平台:

  • Google 移动广告 SDK 版本 8.10.0。
  • MyTarget SDK 5.13.1。

版本 5.13.0.0

  • 经验证与 myTarget SDK 5.13.0 兼容。

构建和测试所用平台:

  • Google 移动广告 SDK 版本 8.9.0。
  • MyTarget SDK 版本 5.13.0。

版本 5.12.1.0

  • 经验证与 myTarget SDK 5.12.1 兼容。

构建和测试所用平台:

  • Google 移动广告 SDK 版本 8.8.0。
  • MyTarget SDK 版本 5.12.1。

版本 5.12.0.0

  • 经验证与 myTarget SDK 5.12.0 版本兼容。

构建和测试所用平台:

  • Google 移动广告 SDK 版本 8.7.0。
  • MyTarget SDK 版本 5.12.0。

版本 5.11.2.0

  • 经验证与 myTarget SDK 5.11.2 兼容。

构建和测试所用平台:

  • Google 移动广告 SDK 8.5.0 版。
  • MyTarget SDK 5.11.2。

版本 5.11.1.0

  • 经验证与 myTarget SDK 5.11.1 兼容。
  • 已放宽对 Google 移动广告 SDK 8.0.0 或更高版本的依赖。

构建和测试所用平台:

  • Google 移动广告 SDK 8.5.0 版。
  • MyTarget SDK 版本 5.11.1。

版本 5.11.0.0

  • 经验证与 myTarget SDK 5.11.0 版本兼容。
  • 现在需要使用 Google 移动广告 SDK 8.4.0 或更高版本。

构建和测试所用平台:

  • Google 移动广告 SDK 版本 8.4.0。
  • MyTarget SDK 版本 5.11.0。

版本 5.10.3.0

  • 经验证与 myTarget SDK 5.10.3 兼容。
  • 现在需要使用 Google 移动广告 SDK 8.3.0 或更高版本。

构建和测试所用平台:

  • Google 移动广告 SDK 8.3.0 版。
  • MyTarget SDK 5.10.3。

版本 5.10.1.0

  • 经验证与 myTarget SDK 5.10.1 版本兼容。

构建和测试所用平台:

  • Google 移动广告 SDK 版本 8.1.0。
  • MyTarget SDK 版本 5.10.1。

版本 5.10.0.0

  • 经验证与 myTarget SDK 5.10.0 兼容。
  • 现在需要使用 Google 移动广告 SDK 8.1.0 或更高版本。
  • 更新了适配器以使用 .xcframework 格式。

构建和测试所用平台:

  • Google 移动广告 SDK 版本 8.1.0。
  • MyTarget SDK 版本 5.10.0。

版本 5.9.11.0

  • 经验证与 myTarget SDK 5.9.10 版本兼容。

构建和测试所用平台:

  • Google 移动广告 SDK 7.69.0 版。
  • MyTarget SDK 版本 5.9.11。

版本 5.9.10.0

  • 经验证与 myTarget SDK 5.9.10 版本兼容。

构建和测试所用平台:

  • Google 移动广告 SDK 7.69.0 版。
  • MyTarget SDK 版本 5.9.10。

版本 5.9.9.1

  • 修复了横幅广告的加载大小有时会大于请求尺寸的问题。

构建和测试所用平台:

  • Google 移动广告 SDK 7.69.0 版。
  • MyTarget SDK 版本 5.9.9。

版本 5.9.9.0

  • 经验证与 myTarget SDK 5.9.9 版本兼容。

构建和测试所用平台:

  • Google 移动广告 SDK 7.69.0 版。
  • MyTarget SDK 版本 5.9.9。

版本 5.9.8.0

  • 经验证与 myTarget SDK 5.9.8 版本兼容。

构建和测试所用平台:

  • Google 移动广告 SDK 7.69.0 版。
  • MyTarget SDK 版本 5.9.8。

版本 5.9.7.0

  • 经验证与 myTarget SDK 5.9.7 版本兼容。
  • 现在需要使用 Google 移动广告 SDK 7.69.0 或更高版本。

构建和测试所用平台:

  • Google 移动广告 SDK 7.69.0 版。
  • MyTarget SDK 版本 5.9.7。

版本 5.9.6.0

  • 经验证与 myTarget SDK 5.9.6 兼容。
  • 添加了标准化的适配器错误代码和消息。

构建和测试所用平台:

  • Google 移动广告 SDK 7.68.0 版。
  • MyTarget SDK 版本 5.9.6。

版本 5.9.5.0

  • 经验证与 myTarget SDK 5.9.5 版本兼容。

构建和测试所用平台:

  • Google 移动广告 SDK 7.68.0 版。
  • MyTarget SDK 版本 5.9.5。

版本 5.9.4.0

  • 经验证与 myTarget SDK 5.9.4 版本兼容。

构建和测试所用平台:

  • Google 移动广告 SDK 7.68.0 版。
  • MyTarget SDK 版本 5.9.4。

版本 5.9.3.0

  • 经验证与 myTarget SDK 5.9.3 版本兼容。
  • 现在需要使用 Google 移动广告 SDK 7.68.0 或更高版本。

构建和测试所用平台:

  • Google 移动广告 SDK 7.68.0 版。
  • MyTarget SDK 版本 5.9.3。

版本 5.9.2.0

  • 新增了对 myTarget 自适应横幅广告尺寸的支持。
  • 经验证与 myTarget SDK 5.9.2 版本兼容。
  • 现在需要使用 Google 移动广告 SDK 7.67.0 或更高版本。

构建和测试所用平台:

  • Google 移动广告 SDK 7.67.0 版。
  • MyTarget SDK 版本 5.9.2。

版本 5.7.5.0

  • 经验证与 myTarget SDK 5.7.5 版本兼容。

构建和测试所用平台:

  • Google 移动广告 SDK 7.64.0 版。
  • MyTarget SDK 版本 5.7.5。

版本 5.7.4.0

  • 经验证与 myTarget SDK 5.7.4 版本兼容。
  • 现在需要使用 Google 移动广告 SDK 7.64.0 或更高版本。

构建和测试所用平台:

  • Google 移动广告 SDK 7.64.0 版。
  • MyTarget SDK 版本 5.7.4。

版本 5.7.3.0

  • 经验证与 myTarget SDK 5.7.3 版本兼容。
  • 现在需要使用 Google 移动广告 SDK 7.63.0 或更高版本。

构建和测试所用平台:

  • Google 移动广告 SDK 7.63.0 版。
  • MyTarget SDK 5.7.3 版。

版本 5.7.2.0

  • 经验证与 myTarget SDK 5.7.2 版本兼容。

构建和测试所用平台:

  • Google 移动广告 SDK 7.62.0 版。
  • MyTarget SDK 5.7.2。

版本 5.7.1.0

  • 经验证与 myTarget SDK 5.7.1 版本兼容。

构建和测试所用平台:

  • Google 移动广告 SDK 7.61.0 版。
  • MyTarget SDK 版本 5.7.1。

版本 5.7.0.0

  • 经验证与 myTarget SDK 5.7.0 版本兼容。

构建和测试所用平台:

  • Google 移动广告 SDK 7.61.0 版。
  • MyTarget SDK 5.7.0。

版本 5.6.3.0

  • 经验证与 myTarget SDK 5.6.3 兼容。
  • 现在需要使用 Google 移动广告 SDK 7.61.0 或更高版本。

构建和测试所用平台:

  • Google 移动广告 SDK 7.61.0 版。
  • MyTarget SDK 版本 5.6.3。

版本 5.6.2.0

  • 经验证与 myTarget SDK 5.6.2 版本兼容。

构建和测试所用平台:

  • Google 移动广告 SDK 7.60.0 版。
  • MyTarget SDK 版本 5.6.2。

版本 5.6.1.0

  • 经验证与 myTarget SDK 5.6.1 版本兼容。

构建和测试所用平台:

  • Google 移动广告 SDK 7.60.0 版。
  • MyTarget SDK 版本 5.6.1。

版本 5.6.0.0

  • 经验证与 myTarget SDK 5.6.0 版本兼容。
  • 现在需要使用 Google 移动广告 SDK 7.60.0 或更高版本。

构建和测试所用平台:

  • Google 移动广告 SDK 7.60.0 版。
  • MyTarget SDK 版本 5.6.0。

版本 5.5.2.0

  • 经验证与 myTarget SDK 5.5.2 版本兼容。
  • 现在需要使用 Google 移动广告 SDK 7.59.0 或更高版本。

构建和测试所用平台:

  • Google 移动广告 SDK 7.59.0 版。
  • MyTarget SDK 版本 5.5.2。

版本 5.5.1.0

  • 经验证与 myTarget SDK 5.5.1 版本兼容。
  • 现在需要使用 Google 移动广告 SDK 7.58.0 或更高版本。

构建和测试所用平台:

  • Google 移动广告 SDK 7.58.0 版。
  • MyTarget SDK 版本 5.5.1。

版本 5.4.9.0

  • 经验证与 myTarget SDK 5.4.9 版本兼容。
  • 取消了对 i386 架构的支持。

构建和测试所用平台:

  • Google 移动广告 SDK 7.57.0 版。
  • MyTarget SDK 版本 5.4.9。

版本 5.4.7.0

  • 经验证与 myTarget SDK 5.4.7 兼容。
  • 现要求使用 iOS 最低 9.0 版。

构建和测试所用平台:

  • Google 移动广告 SDK 7.55.1 版。
  • MyTarget SDK 版本 5.4.7。

版本 5.4.5.0

  • 经验证与 myTarget SDK 5.4.5 兼容。

构建和测试所用平台:

  • Google 移动广告 SDK 7.53.1 版。
  • MyTarget SDK 版本 5.4.5。

版本 5.4.2.0

  • 经验证与 myTarget SDK 5.4.2 兼容。
  • 适配器现在会返回非零 mediaContent 宽高比。

构建和测试所用平台:

  • Google 移动广告 SDK 7.53.1 版。
  • MyTarget SDK 版本 5.4.2。

版本 5.3.3.0

  • 经验证与 myTarget SDK 5.3.3 版本兼容。
  • 取消了对原生和应用安装广告请求的支持。应用必须使用统一原生广告 API 来请求原生广告。
  • 现在需要使用 Google 移动广告 SDK 7.46.0 或更高版本。

版本 5.0.4.0

  • 经验证与 myTarget SDK 5.0.4 版本兼容。
  • 更新了适配器,以使用新的激励广告 API。
  • 现在需要使用 Google 移动广告 SDK 7.41.0 或更高版本。

版本 5.0.1.0

  • 经验证与 myTarget SDK 5.0.1 版本兼容。

4.8.9.0 版

  • 经验证与 myTarget SDK 4.8.9 兼容。

4.8.5.0 版

  • 经验证与 myTarget SDK 4.8.5 兼容。

4.8.0.0 版

  • 经验证与 myTarget SDK 4.8.0 兼容。

4.7.11.0 版

  • 经验证与 myTarget SDK 4.7.11 兼容。

4.7.10.0 版

  • 经验证与 myTarget SDK 4.7.10 兼容。
  • 向适配器添加了 adapterDidCompletePlayingRewardBasedVideoAd: 回调。

4.7.9.1 版

  • 新增了对统一原生广告的支持。

4.7.9.0 版

  • 经验证与 myTarget SDK 4.7.9 兼容。
  • 新增了对统一原生广告的支持。

4.7.8.0 版

  • 经验证与 myTarget SDK 4.7.8 兼容。

4.7.7.0 版

  • 经验证与 myTarget SDK 4.7.7 兼容。

4.7.6.0 版

  • 经验证与 myTarget SDK 4.7.6 兼容。

4.7.5.0 版

  • 经验证与 myTarget SDK 4.7.5 兼容。

4.7.4.0 版

  • 经验证与 myTarget SDK 4.7.4 兼容。

4.7.3.0 版

  • 经验证与 myTarget SDK 4.7.3 兼容。
  • 新增了对原生视频广告的支持。

4.6.25.0 版

  • 经验证与 myTarget SDK 4.6.25 兼容。

4.6.24.0 版

  • 第一个版本!
  • 新增了对横幅广告、插页式广告、激励广告和原生广告的支持。