将 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

  • compileSdkVersiontargetSdkVersion 更新为 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 兼容。

早期版本

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