将 Pangle 与中介集成

选择平台： Android（Beta 版） 新 Android iOS Unity Flutter

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

支持的集成和广告格式

Pangle 的 Ad Manager 中介适配器具有以下功能：

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

要求

  • 最新版 Google Mobile Ads Flutter Plugin
  • Flutter 3.7.0 或更高版本
  • [适用于出价]：如需在出价中集成所有受支持的广告格式，请使用 Google 移动广告中介插件（适用于 Pangle）2.4.0 或更高版本（建议使用最新版本）
  • 如需在 Android 上部署，则要求：
    • Android API 级别 23 或更高级别
  • 如需在 iOS 上部署，则要求：
    • iOS 部署目标版本为 13.0 或更高版本
  • 已配置 Google Mobile Ads Flutter Plugin 的正常运行的 Flutter 项目。如需了解详情，请参阅 设置 Google Mobile Ads Flutter Plugin。
  • 如何设置中介

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

注册或 登录您的 Pangle 账号。

添加新应用

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

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

Android

iOS

记下应用的 ID。

Android

iOS

创建广告展示位置

创建应用后，点击 Add （添加）按钮即可创建广告展示位置。

Android

iOS

出价

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

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

Android

iOS

瀑布流

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

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

Android

iOS

更新 app-ads.txt

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

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

启用测试模式

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

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

为广告单元配置中介设置

Android

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

iOS

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

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

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

第 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: ^3.5.3

手动集成

下载最新版 Google 移动广告中介插件（适用于 Pangle）， 提取下载的文件，并将提取的插件文件夹 （及其内容）添加到您的 Flutter 项目中。然后，在 pubspec.yaml 文件中引用该插件，方法是添加以下依赖项：

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

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

为了遵守 Google 的《欧盟地区用户意见征求政策》，您必须：向位于欧洲经济区 (EEA)、英国和瑞士境内的 用户披露相关信息；如果法律 要求在使用 Cookie 或存储在本地的其他 ID 之前必须先征得用户同意，您必须照做；如果需要收集、分享和使用个人数据来实现广告 个性化，也必须征得 他们的同意。此政策反映了欧盟《电子隐私指令》和《一般数据保护条例》(GDPR) 的要求。您要负责验证用户意见是否已传播到中介链中的每个广告来源。 Google 无法自动将用户的意见征求选择传递给此类广告联盟。

从 Google 移动广告中介插件（适用于 Pangle）5.9.0 版开始， Pangle 会自动读取支持 Google's Additional Consent specification的意见征求管理平台设置的 GDPR 意见征求， 包括 UMP SDK。

美国州级隐私保护法律

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

Google 移动广告中介插件（适用于 Pangle）包含 Pangle.SetPAConsent() 方法。以下示例代码展示了如何将用户意见信息传递给 Pangle SDK。请先设置用户意见信息，然后再 初始化 Google Mobile Ads Flutter Plugin ，以确保这些信息正确转发给 Pangle SDK。

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

Pangle.SetPAConsent(0);

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

第 5 步：添加所需代码

Android

Pangle 集成不需要额外的代码。

iOS

SKAdNetwork 集成

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

第 6 步：测试实现

启用测试广告

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

验证测试广告

若要验证您是否能收到来自 Pangle 的测试广告，请在广告检查器中启用 single ad source testing（单个广告来源测试），并选择 Pangle (Bidding) and Pangle (Waterfall)（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 中介适配器变更日志

3.6.0 版（正在开发中）

3.5.4 版（正在开发中）

3.5.3 版

3.5.2 版

3.5.1 版

3.5.0 版

3.4.0 版

3.3.0 版

3.2.1 版

3.2.0 版

3.1.1 版

3.1.0 版

3.0.0 版

2.2.0 版

2.1.0 版

2.0.0 版

1.1.0 版

1.0.0 版