将 Yahoo 与中介集成

本指南介绍了如何使用 Google 移动广告 SDK 通过涵盖广告瀑布流集成的中介来加载和展示 Yahoo 提供的广告。它介绍了如何将 Yahoo 添加到广告单元的中介配置，以及如何将 Yahoo Mobile SDK 和适配器集成到Android 应用中。

支持的集成和广告格式

适用于 Yahoo 的 Ad Manager 中介适配器具有以下功能：

集成
出价
瀑布
表现形式
横幅
插页式广告
已奖励
原生

要求

  • Android API 级别 19 或更高级别

  • 最新版 Google 移动广告 SDK

  • 完成中介 入门指南

第 1 步：在 Yahoo 界面中设置配置

登录 Yahoo 的 SSP。在应用和网站下，点击 + 按钮，然后点击应用。

填写表单，然后点击 Save and Add Placement（保存并添加展示位置）以创建您的应用。

创建应用后，您需要创建 Placement。选择展示位置类型，填写表单，然后点击保存并获利。

记下您的展示位置 ID。

您需要向展示位置添加广告来源。在下一个表单中，选择 Yahoo SSP 作为广告来源，然后在表单中填写所需的信息。填写完表单后，请点击保存。

最后，将您刚刚创建的广告来源拖动到 Waterfall 广告来源表格下方，将其添加到您的展示位置。

记下网站 ID。

开启测试模式

要测试 Yahoo 广告，可以创建一个测试广告来源，并将其添加到您展示位置的瀑布流广告来源中。转到展示位置 ID 的设置页面，点击添加按钮，然后选择测试广告来源。

创建广告来源后，将其拖动到展示位置的瀑布流广告来源中。

大功告成！您现在已经与 Yahoo 实现了有效的中介集成。

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

为广告单元配置中介设置

登录您的 Ad Manager 帐号。

依次转到投放 > 收益组，然后点击新建收益组按钮。

为您的收益组输入一个独一无二的名称，将状态设为有效，选择广告格式，然后将广告资源类型设为移动应用。在定位 > 广告资源部分下，选择广告资源和移动应用（您要向其中添加中介）下方的广告单元。

接下来，点击添加收益合作伙伴按钮。

如果您已有 Yahoo - App & Display 的收益合作伙伴，可以选择它。否则，请选择创建新的收益合作伙伴。

选择 Yahoo - App & Display 作为广告联盟，输入一个具有唯一性的名称并启用中介。

选择收益合作伙伴后，选择移动 SDK 中介作为集成类型，选择 Android 作为平台，选择有效作为状态。输入在上一部分获得的Placement ID and Site ID 。然后，输入默认每千次展示费用值。

完成后，点击页面底部的保存。

添加到 GDPR 和美国州级法规的广告合作伙伴列表中 Yahoo

按照 GDPR 设置 和 美国州级法规设置 中的步骤，将 Yahoo 添加到 Ad Manager 界面中的 GDPR 和美国州级法规广告合作伙伴列表中。

第 3 步：导入 Yahoo Mobile SDK 和适配器

在应用级 build.gradle 文件中添加以下实现依赖项，其中包含最新版本的 Yahoo Ads SDK 和适配器：

repositories {
    google()
    mavenCentral()
    maven {
      url 'https://artifactory.yahooinc.com/artifactory/maven/'
    }
}

...
dependencies {
    implementation 'androidx.appcompat:appcompat:1.2.0'
    implementation 'com.google.android.gms:play-services-ads:22.6.0'
    implementation 'com.google.ads.mediation:yahoo:1.4.1.1'
}
...

手动集成

  • 如需添加 Yahoo Mobile SDK，请参阅 Yahoo Android SDK 文档。

  • 转到 Google Maven 制品库中的 Yahoo 适配器工件。选择最新版本，下载 Yahoo 适配器的 .aar 文件，并将其添加到您的项目。

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

美国州级隐私保护法律

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

以下示例代码展示了如何将用户意见征求信息传递给 Yahoo Mobile SDK。如果您选择调用此方法，请在通过 Google 移动广告 SDK 请求广告之前调用。

Java

import com.yahoo.ads.YASAds;
import com.yahoo.ads.CcpaConsent;

// ...
CcpaConsent ccpaConsent = new CcpaConsent("<CCPA CONSENT>");
YASAds.addConsent(ccpaConsent);

Kotlin

import com.yahoo.ads.YASAds
import com.yahoo.ads.CcpaConsent

// ...
val ccpaConsent = CcpaConsent("<CCPA CONSENT>")
YASAds.addConsent(ccpaConsent)

如需了解详情以及可通过该方法提供的值，请参阅发布商隐私设置。

第 5 步：添加所需的代码

Yahoo 集成无需额外代码。

第 6 步：测试实现效果

启用测试广告

请务必为Ad Manager 注册您的测试设备，并在 Yahoo - App & Display 界面中启用测试模式。

验证测试广告

如需验证您收到的是来自 Yahoo - App & Display 的测试广告，请使用相应广告来源在广告检查器中启用单一广告来源测试。 Yahoo (Waterfall)

可选步骤

使用原生广告

广告呈现

Yahoo 适配器以 NativeAd 对象的形式返回其原生广告。它会填充 NativeAd 的以下 字段 。

字段 由 Yahoo 适配器填充
标题
映像
正文
应用图标
号召性用语
广告客户名称
星级
存储
价格

Yahoo Android 中介适配器更新日志

下一版本

  • 将 Google 移动广告 SDK 的最低版本更新为 22.4.0。

版本 1.4.1.1

  • 更新了适配器以使用新的 VersionInfo 类。
  • 将 Google 移动广告 SDK 最低版本更新到了 22.0.0。

构建和测试方式：

  • Google 移动广告 SDK 22.0.0 版
  • Yahoo Mobile SDK 1.4.1。

版本 1.4.1.0

  • Verizon Media 适配器已更名为“Yahoo”。
  • 添加了描述性的错误代码以及适配器加载和显示失败的原因。
  • 已验证与 Yahoo Mobile SDK 版本 1.4.1 的兼容性。
  • 将 Google 移动广告 SDK 的最低版本更新为 21.5.0。

构建和测试方式：

  • Google 移动广告 SDK 21.5.0 版
  • Yahoo Mobile SDK 1.4.1。