将 Pangle 与中介集成

请选择平台： Android iOS Unity Flutter Android（旧版）

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

支持的集成和广告格式

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

集成
出价  1
瀑布
格式
打开应用  2
横幅  2
插页式广告
已获得奖励
插页式激励广告
原生  2

1 可用的 Pangle 出价广告来源包括 Pangle US、Pangle KR 和 Pangle ROW。

2 以下 Pangle 出价广告来源不支持此格式：Pangle US。

前提条件

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

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

    注册或登录您的 Pangle 账号。

    添加新应用

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

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

    Android

    iOS

    记下应用的 ID。

    Android

    iOS

    创建广告展示位置

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

    Android

    iOS

    出价

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

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

    Android

    iOS

    瀑布流

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

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

    Android

    iOS

    更新 app-ads.txt

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

    如需为 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 和适配器

    OpenUPM-CLI

    如果您已安装 OpenUPM-CLI，则可以在项目的根目录中运行以下命令，将适用于 Unity 的 Google 移动广告 Pangle 中介插件安装到项目中：

    openupm add com.google.ads.mobile.mediation.pangle

    OpenUPM

    在 Unity 项目编辑器中，依次选择 Edit（修改）> Project Settings（项目设置）> Package Manager（资源包管理器），打开 Unity 资源包管理器设置。

    在 Scoped Registries 标签页下，将 OpenUPM 添加为限定范围的注册表，并提供以下详细信息：

    • 名称：OpenUPM
    • URL：https://package.openupm.com
    • 范围：com.google

    OpenUPM 详情

    然后，依次前往 Window > Package Manager，打开 Unity Package Manager，并从下拉菜单中选择 My Registries。

    Unity 注册表

    选择 Google Mobile Ads Pangle Mediation（Google 移动广告 Pangle 中介）软件包，然后点击 Install（安装）。

    从 OpenUPM 安装

    Unity 软件包

    从变更日志中的下载链接下载适用于 Pangle 的最新版 Google 移动广告中介插件，然后从 ZIP 文件中解压缩 GoogleMobileAdsPangleMediation.unitypackage。

    在 Unity 项目编辑器中，依次选择 Assets > Import Package > Custom Package，然后找到您下载的 GoogleMobileAdsPangleMediation.unitypackage 文件。确保已选择所有文件，然后点击导入。

    从 Unity 导入

    然后，依次选择 Assets > External Dependency Manager > Android Resolver > Force Resolve。外部依赖项管理器库将从头开始执行依赖项解析，并将声明的依赖项复制到 Unity 应用的 Assets/Plugins/Android 目录中。

    强制解决

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

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

    在 Pangle Unity 适配器 5.9.0 及更高版本中，Pangle 会自动读取支持 Google 的“征得用户同意情况的其他规范”（包括 UMP SDK）的意见征求管理平台设置的 GDPR 意见征求。

    美国州级隐私保护法律

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

    以下示例代码展示了如何将用户意见信息传递给 Pangle SDK。在初始化 Google Mobile Ads Unity 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 (Waterfall)、Pangle US SDK (Bidding)、Pangle KR SDK (Bidding) 和 Pangle ROW SDK (Bidding) 作为广告来源。

    错误代码

    如果适配器未能收到来自 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 Pangle SDK 不支持儿童用户。
    -1-60000 com.pangle.ads Pangle SDK 返回了错误。如需了解详情，请参阅 Pangle 的文档。

    iOS

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

    Pangle Unity 中介插件变更日志

    版本 7.2.2（开发中）

    版本 7.2.1

    版本 7.2.0

    7.1.1 版

    版本 7.1.0

    版本 7.0.0（已回滚）

    版本 6.0.1

    版本 6.0.0

    版本 5.9.2

    5.9.1 版

    版本 5.9.0

    5.8.5 版

    版本 5.8.4

    版本 5.8.3

    版本 5.8.2

    版本 5.8.1

    版本 5.8.0

    版本 5.7.1

    版本 5.7.0

    版本 5.6.0

    版本 5.5.3

    版本 5.5.2

    版本 5.5.1

    版本 5.5.0

    版本 5.4.0

    版本 5.3.0

    版本 5.2.2

    版本 5.2.1

    版本 5.2.0

    版本 5.1.1

    版本 5.1.0

    5.0.0 版

    版本 4.6.2

    版本 4.6.1

    版本 4.6.0

    版本 4.5.4

    版本 4.5.3

    4.5.2 版

    版本 4.5.1

    4.5.0 版

    版本 4.4.2

    版本 4.4.1

    版本 4.4.0

    版本 4.3.3

    版本 4.3.2

    版本 4.3.1

    版本 4.3.0

    版本 4.2.1

    版本 4.2.0

    版本 4.1.0

    4.0.1 版

    版本 4.0.0

    3.0.0 版

    版本 2.8.1

    版本 2.8.0

    版本 2.7.0

    版本 2.6.0

    版本 2.5.0

    版本 2.4.0

    版本 2.3.0

    版本 2.2.0

    版本 2.1.0

    版本 2.0.0

    版本 1.5.1

    1.5.0 版

    版本 1.4.0

    版本 1.3.1

    版本 1.3.0

    版本 1.2.0

    1.1.0 版

    1.0.0 版