将 Pangle 与中介集成

本指南介绍了如何使用 Google 移动广告 SDK 使用中介加载和展示来自 Pangle 的广告，涵盖采用广告瀑布流和出价的集成方式。其中介绍了如何将 Pangle 添加到广告单元的中介配置，以及如何将 Pangle SDK 和适配器集成到 Flutter 应用中。

支持的集成和广告格式

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

集成
出价
瀑布
表现形式
打开应用
横幅
插页式广告
激励广告
插页式激励广告
原生

要求

  • 最新版 Google 移动广告 SDK
  • Flutter 3.7.0 或更高版本
  • [出价]：如需在出价中集成所有受支持的广告格式，请使用适用于 Pangle 的 Google 移动广告中介插件 2.4.0 或更高版本（建议使用最新版本）
  • 如需在 Android 上部署，请执行以下操作：
    • Android API 级别 23 或更高级别
  • 要在 iOS 上部署，需具备以下条件：
    • iOS 部署目标为 12.0 或更高版本
  • 使用 Google 移动广告 SDK 配置的正常运行的 Flutter 项目。如需了解详情，请参阅开始使用。
  • 完成中介入门指南

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

注册或登录您的 Pangle 账号。

添加新应用

前往应用标签页，然后点击添加应用按钮。

选择您要为哪个操作系统创建应用，然后填写表单的其余部分。然后点击提交。

Android

iOS

记下应用的应用 ID。

Android

iOS

创建广告展示位置

创建应用后，点击添加按钮以创建广告展示位置。

Android

iOS

出价

选择广告格式和广告展示位置名称，然后选择应用内出价作为定价类型。填写表单的其余部分，然后点击提交。

创建展示位置后，记下展示位置 ID。

Android

iOS

瀑布

选择广告格式和广告展示位置名称，并将全球每千次展示费用作为定价类型。填写表单的其余部分，然后点击提交。

创建展示位置后，记下展示位置 ID。

Android

iOS

找到 Pangle Reporting API 密钥

出价

出价集成不需要执行此步骤。

瀑布

记下页面左下角的用户 ID。

依次点击 Integrations > SDK & API > Pangle Reporting API 2.0。记下角色 ID 和安全密钥。

更新您的 app-ads.txt

应用授权卖方 app-ads.txt 是一项 IAB Tech Lab 计划，有助于确保只通过您认定的授权渠道销售您的应用广告资源。为避免损失大量广告收入，您需要实施 app-ads.txt 文件。 如果您尚未完成此操作，请为 Ad Manager 创建 app-ads.txt 文件。

如需为 Pangle 实现 app-ads.txt，请参阅如何将 Pangle 添加到 app-ads.txt 文件。

开启测试模式

请按照 Pangle 的如何添加测试广告指南中的说明，了解如何启用 Pangle 测试广告。

第 2 步：在 AdMob 界面中设置 Pangle 需求

为广告单元配置中介设置

Android

如需查看相关说明，请参阅 Android 指南中的第 2 步。

iOS

如需了解相关说明，请参阅 iOS 指南中的第 2 步。

将 Pangle DSP 添加到 GDPR 和美国州级法规广告合作伙伴名单

请按照欧洲法规设置和美国州级法规设置中的步骤，将 Pangle DSP 添加到 AdMob 界面中的欧洲法规和美国州级法规广告合作伙伴名单中。

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

通过 pub.dev 集成

（仅限 Android）将以下代码库添加到项目的 android 目录下的 build.gradle 文件中：

  repositories {
      google()
      mavenCentral()
      maven {
          url = uri("https://artifact.bytedance.com/repository/pangle/")
      }
  }

在软件包的 pubspec.yaml 文件中添加以下依赖项，其中包含最新版本的 Pangle SDK 和适配器：

dependencies:
  gma_mediation_pangle: ^

手动集成

下载适用于 Pangle 的最新版 Google 移动广告中介插件，解压缩下载的文件，然后将解压缩的插件文件夹及其内容添加到您的 Flutter 项目中。然后，通过添加以下依赖项在 pubspec.yaml 文件中引用该插件：

dependencies:
  gma_mediation_pangle:
    path: path/to/local/package

第 4 步：在 Pangle SDK 中实现隐私设置

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

适用于 Pangle 的 Google 移动广告中介插件包含 Pangle.SetGDPRConsent() 方法。以下示例代码展示了如何将意见征求信息传递给 Pangle SDK。请在初始化 Google 移动广告 SDK 之前设置用户意见信息，以确保这些信息能够正确转发给 Pangle SDK。

using GoogleMobileAds.Api.Mediation.Pangle;
// ...

Pangle.SetGDPRConsent(0);

如需了解详情以及可在每种方法中提供的值，请参阅 Pangle 的集成指南。

美国州级隐私保护法律

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

适用于 Pangle 的 Google 移动广告中介插件包含 Pangle.SetPAConsent() 方法。以下示例代码展示了如何将意见征求信息传递给 Pangle SDK。请在初始化 Google 移动广告 SDK 之前设置用户意见信息，以确保这些信息能够正确转发给 Pangle SDK。

using GoogleMobileAds.Api.Mediation.Pangle;
// ...

Pangle.SetPAConsent(0);

如需了解详情以及可在每种方法中提供的值，请参阅 Pangle 的集成指南。

第 5 步：添加所需代码

Android

无需额外代码即可集成 Pangle。

iOS

SKAdNetwork 集成

按照 Pangle 文档中的说明，将 SKAdNetwork 标识符添加到项目的 Info.plist 文件中。

第 6 步：测试您的实现

启用测试广告

请务必为 AdMob 注册测试设备，并在 Pangle 界面中启用测试模式。

验证测试广告

如需验证您是否在从 Pangle 接收测试广告，请在广告检查器中使用 Pangle（出价）和 Pangle（广告瀑布流）广告来源启用单一广告来源测试。

错误代码

如果适配器未能从 Pangle 收到广告，发布商可以使用以下类下的 ResponseInfo 检查广告响应的根本错误：

Android

com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter

iOS

GADMediationAdapterPangle

以下是 Pangle 适配器在广告加载失败时抛出的代码和随附消息：

Android

错误代码 网域 原因
101 com.google.ads.mediation.pangle 服务器参数无效（例如缺少应用 ID 或展示位置 ID）。
102 com.google.ads.mediation.pangle 请求的广告尺寸与 Pangle 支持的横幅广告尺寸不符。
103 com.google.ads.mediation.pangle 出价响应缺失或无效。
-1-60000 com.pangle.ads Pangle SDK 返回了错误。如需了解详情，请参阅 Pangle 的文档。

iOS

错误代码 网域 原因
101 com.google.ads.mediation.pangle 服务器参数无效（例如缺少应用 ID 或展示位置 ID）。
102 com.google.ads.mediation.pangle 请求的广告尺寸与 Pangle 支持的横幅广告尺寸不符。
-1-60000 由 Pangle SDK 发送 Pangle SDK 返回了错误。如需了解详情，请参阅 Pangle 的文档。

Pangle Flutter 中介适配器变更日志

版本 2.2.0

版本 2.1.0

版本 2.0.0

版本 1.1.0

版本 1.0.0