将 Verizon Media 与中介集成

本指南介绍了如何使用 Google 移动广告 SDK 通过中介功能加载和展示 Verizon Media 提供的广告。文中介绍了如何将 Verizon Media 添加到广告单元的中介配置、以及如何将 Verizon Media SDK 和适配器集成到 Android 应用中。

支持的集成和广告格式

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

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

要求

  • Android API 级别 19 或更高级别
  • 最新版 Google 移动广告 SDK

第 1 步：设置 Verizon Media

注册或登录 Verizon Media 的 SSP。在应用和网站下，点击按钮以创建应用，然后选择Android 作为平台。

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

创建应用后，您需要创建展示位置。选择展示位置类型，填写表单，然后点击保存并创收。记下您的展示位置 ID。您在下一步中会用到该变量。

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

最后，将您刚刚创建的广告来源表格下方的广告来源添加到展示位置。记下网站 ID，就在应用的名称旁边。您在下一步中也需要用到此信息。

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

您需要将 Verizon Media 添加到广告单元的中介配置中。

首先，登录您的 AdMob 帐号。接下来，转到中介标签页。如果您已修改现有中介组，请点击该中介组的名称进行修改，然后跳至将 Verizon Media 添加为广告来源。

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

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

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

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

现在，您应该会看到填充了所选广告单元的广告单元卡片：

添加 Verizon Media 作为广告来源

在广告来源卡片中，选择添加广告联盟。选择 Verizon Media，然后输入 Verizon Media 的有效每千次展示费用值，并点击继续。

输入在上一部分中获得的展示位置 ID 和网站 ID。

使用激励广告

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

如果您不应用此设置，则 Verizon Media 适配器默认采用 ""（空字符串）类型的奖励，其值为 1。Verizon Media SDK 不会为其激励广告提供特定的奖励值。

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

第 3 步：导入 Verizon Media SDK 和适配器

在应用级 build.gradle 文件中添加以下实现依赖项与最新版 Verizon Media Ads SDK 和适配器：

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

...
dependencies {
    implementation 'androidx.appcompat:appcompat:1.2.0'
    implementation 'com.google.android.gms:play-services-ads:21.1.0'
    implementation 'com.google.ads.mediation:verizonmedia:1.14.0.1'
}
...

手动集成

第 4 步：需要额外的代码

Verizon Media 集成无需其他代码。

第 5 步：测试您的实现

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

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

大功告成！您现在已经与 Verizon Media 建立了有效的中介集成。

可选步骤

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

在 1.14.0.0 版中，Verizon Media 适配器添加了 VerizonPrivacy 类以支持隐私设置。以下示例代码展示了如何将用户意见征求信息传递给 Verizon Media SDK。如果您选择调用此方法，建议您在通过 Google 移动广告 SDK 请求广告之前执行此操作。

Java

import com.google.ads.mediation.verizon.VerizonPrivacy;
import com.verizon.ads.DataPrivacy;
// ...

DataPrivacy dataPrivacy = new DataPrivacy.Builder()
    .setGdprScope(true)
    .setGdprConsent("<GDPR CONSENT>")
    .setGdprContractualAgreement(true)
    .build();
VerizonPrivacy.getInstance().setDataPrivacy(dataPrivacy);

Kotlin

import com.google.ads.mediation.verizon.VerizonPrivacy
import com.verizon.ads.DataPrivacy
// ...

val dataPrivacy = DataPrivacy.Builder()
    .setGdprScope(true)
    .setGdprConsent("<GDPR CONSENT>")
    .setGdprContractualAgreement(true)
    .build()
VerizonPrivacy.getInstance().setDataPrivacy(dataPrivacy)

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

将 Verizon Media 添加到 GDPR 广告合作伙伴列表

按照GDPR 设置中的步骤将 Verizon Media 添加到AdMob 界面中的 GDPR 广告合作伙伴列表。

CCPA

《加州消费者隐私法案》(CCPA) 要求赋予加利福尼亚州居民选择不通过醒目的“出售”链接提供“不出售个人信息”链接所表示的“出售”个人信息（根据相关法律所定义条款）。CCPA 准备工作指南提供了为 Google 广告投放启用受限的数据处理的功能，但 Google 无法为中介链中的每个广告联盟应用此设置。因此，您必须在中介链中标识可能参与个人信息销售的各个广告联盟，并遵循各个广告联盟的指导意见，以确保符合《加州消费者隐私法案》(CCPA) 的规定。

在 1.14.0.0 版中，Verizon Media 适配器添加了 VerizonPrivacy 类以支持隐私设置。以下示例代码展示了如何将用户意见征求信息传递给 Verizon Media SDK。如果您选择调用此方法，建议您在通过 Google 移动广告 SDK 请求广告之前执行此操作。

Java

import com.google.ads.mediation.verizon.VerizonPrivacy;
import com.verizon.ads.DataPrivacy;
// ...

DataPrivacy dataPrivacy = new DataPrivacy.Builder()
    .setCcpaPrivacy("<CCPA CONSENT>")
    .build();
VerizonPrivacy.getInstance().setDataPrivacy(dataPrivacy);

Kotlin

import com.google.ads.mediation.verizon.VerizonPrivacy
import com.verizon.ads.DataPrivacy
// ...

val dataPrivacy = DataPrivacy.Builder()
    .setCcpaPrivacy("<CCPA CONSENT>")
    .build()
VerizonPrivacy.getInstance().setDataPrivacy(dataPrivacy)

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

使用原生广告

广告呈现

Verizon Media 适配器以 NativeAd 对象的形式返回其原生广告。它填充了 NativeAd 的 原生广告字段说明 。

字段 由 Verizon Media 适配器填充
标题
映像
身体
应用图标
号召性用语
广告客户名称
Star rating
存储
价格

Verizon Media Android 中介适配器变更日志

版本 1.14.0.1

  • 将 compileSdkVersion 和 targetSdkVersion 更新为 API 31。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 21.0.0。
  • 将所需的最低 Android API 级别更新为 19。

构建和测试所用代码：

  • Google 移动广告 SDK 版本 21.0.0。
  • Verizon Media SDK 1.14.0。

版本 1.14.0.0

  • 支持 Verizon Media SDK v1.14.0。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 20.3.0。

构建和测试所用代码：

  • Google 移动广告 SDK 版本 20.3.0。
  • Verizon Media SDK 1.14.0。

版本 1.13.0.0

  • 支持 Verizon Media SDK v1.13.0。
  • 已将所需的最低 Google 移动广告 SDK 版本更新为 20.1.0。

构建和测试所用代码：

  • Google 移动广告 SDK 版本 20.1.0。
  • Verizon Media SDK 1.13.0。

版本 1.12.1.0

  • 支持 Verizon Media SDK v1.12.1。
  • 已将所需的最低 Google 移动广告 SDK 版本更新为 20.0.0。

构建和测试所用代码：

  • Google 移动广告 SDK 版本 20.0.0。
  • Verizon Media SDK 1.12.1。

版本 1.9.0.0

  • 支持 Verizon Media SDK v1.9.0。
  • 将 Google 移动广告 SDK 所需的最低版本更新为 19.7.0。

构建和测试所用代码：

  • Google 移动广告 SDK 19.7.0。
  • Verizon Media SDK 1.9.0。

版本 1.8.1.0

  • 支持 Verizon Media SDK v1.8.1。
  • 修复了适配器返回版本字符串不正确的问题。
  • 将 Google 移动广告 SDK 的最低版本要求更新为 19.5.0。

构建和测试所用代码：

  • Google 移动广告 SDK 19.5.0。
  • Verizon Media SDK 1.8.1。

版本 1.8.0.0

  • 支持 Verizon Media SDK v1.8.0。
  • 将 Google 移动广告 SDK 的最低版本要求更新为 19.4.0。

构建和测试所用代码：

  • Google 移动广告 SDK 19.4.0。
  • Verizon Media SDK 1.8.0。

版本 1.7.0.0

  • 支持 Verizon Media SDK v1.7.0。
  • 将 Google 移动广告 SDK 的最低版本要求更新为 19.3.0。
  • 更新了适配器以支持内嵌自适应横幅广告请求。
  • 根据 Verizon 的文档，添加了 androidx.browser:browser 作为依赖项。

构建和测试所用代码：

  • Google 移动广告 SDK 19.3.0。
  • Verizon Media SDK 1.7.0。

版本 1.6.0.0

  • 支持 Verizon Media SDK v1.6.0。
  • 将 Google 移动广告 SDK 的最低版本要求更新为 19.1.0。

构建和测试所用代码：

  • Google 移动广告 SDK 19.1.0。
  • Verizon Media SDK 1.6.0。

版本 1.5.0.0

  • 支持 Verizon Media SDK v1.5.0。
  • 将 Google 移动广告 SDK 的最低版本要求更新为 19.0.1。

构建和测试所用代码：

  • Google 移动广告 SDK 版本 19.0.1。
  • Verizon Media SDK 1.5.0。

版本 1.4.0.0

  • 支持 Verizon Media SDK v1.4.0。

构建和测试所用代码：

  • Google 移动广告 SDK 版本 18.3.0。
  • Verizon Media SDK 1.4.0。

版本 1.3.1.0

  • 支持 Verizon Media SDK v1.3.1。

构建和测试所用代码：

  • Google 移动广告 SDK 版本 18.3.0。
  • Verizon Media SDK 1.3.1。

版本 1.3.0.0

  • 支持 Verizon Media SDK v1.3.0。
  • 移除了 VerizonConsent.getInstance().setConsentData() API。
  • 添加了 VerizonPrivacy.getInstance().setPrivacyData() API。现在，发布商必须通过此 API 将 GDPR 信息传递给 Verizon Media SDK。

构建和测试所用代码：

  • Google 移动广告 SDK 版本 18.3.0。
  • Verizon Media SDK 1.3.0。

版本 1.2.1.0

  • 支持 Verizon Media SDK v1.2.1。
  • 添加了对原生广告的支持。
  • 添加了对激励视频广告的支持。

构建和测试所用代码：

  • Google 移动广告 SDK 18.2.0 版。
  • Verizon Media SDK 1.2.1。

版本 1.1.1.0

  • 适配器已更名为“Verizon Media”。
  • 与 Verizon Media SDK 1.1.1 兼容。

早期版本

  • 支持横幅广告和插页式广告。