将 Pangle 与中介集成

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

支持的集成和广告格式

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

集成
出价
瀑布
表现形式
开屏广告  1
横幅
插页式广告
激励广告
插页式激励广告
原生
1 此格式的出价集成功能目前处于封闭式 Beta 版阶段。

要求

  • iOS 部署目标版本为 10.0 或更高版本

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

注册或登录您的 Pangle 账号。

添加新应用

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

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

记下应用的应用 ID。

创建广告展示位置

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

出价

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

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

瀑布

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

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

找到 Pangle Reporting API 密钥

出价

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

瀑布

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

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

开启测试模式

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

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

为广告单元配置中介设置

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

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

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

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

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

将此中介组与一个或多个现有AdMob 广告单元相关联。接着，点击完成。

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

将 Pangle 添加为广告来源

出价


在广告来源部分的出价卡片下，选择添加广告来源。然后选择 Pangle 。
点击如何签署合作伙伴协议，然后与 Pangle 建立出价合作伙伴关系。
点击确认并同意，然后点击继续。
如果您已经有 Pangle 的映射，可以选择该映射。否则，请点击添加映射。
接下来，输入在上一部分中获取的应用 ID 和广告展示位置 ID。然后点击完成。

瀑布


在广告来源部分的广告瀑布流卡片下，选择添加广告来源。然后选择 Pangle。

选择 Pangle。 然后，为 Pangle 输入有效每千次展示费用值，然后点击继续。



如果您已为 Pangle 创建映射，可以选择该映射。 否则，请点击添加映射。

接下来，输入您在上一部分中获取的应用 ID 和广告展示位置 ID。然后，点击完成。


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

  • 将以下代码行添加到项目的 Podfile 中：

    pod 'GoogleMobileAdsMediationPangle'

  • 在命令行中运行以下命令：

    pod install --repo-update

手动集成

  • 下载最新版本的 Pangle SDK for iOS，并关联项目中的所有 .framework 文件和软件包。
  • 从更新日志中的下载链接下载最新版本的 Pangle 适配器，并在项目中关联 PangleAdapter.xcframework。

第 4 步：添加所需代码

SKAdNetwork 集成

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

第 5 步：测试您的实现

启用测试广告

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

验证测试广告

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

可选步骤

原生广告

广告呈现

Pangle 适配器会将其原生广告作为 GADNativeAd 对象返回。它会为 GADNativeAd。

字段 Pangle 适配器始终包含的素材资源
标题
Image 1
正文
图标
号召性用语
星级
商店
价格
广告客户

1 Pangle 适配器不为其原生广告提供对主图片素材资源的直接访问权限。而是使用视频或图片填充 GADMediaView 。

错误代码

如果适配器未能从 Pangle 收到广告，您可以使用以下类下的 GADResponseInfo.adNetworkInfoArray：

GADMediationAdapterPangle

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

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

Pangle iOS 中介适配器变更日志

版本 6.3.0.9.0

  • 已验证与 Pangle SDK 版本 6.3.0.9 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 11.12.0 版。
  • Pangle SDK 版本 6.3.0.9。

版本 6.3.0.8.0

  • 已验证与 Pangle SDK 版本 6.3.0.8 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 11.11.0 版。
  • Pangle SDK 版本 6.3.0.8。

版本 6.3.0.6.0

  • 已验证与 Pangle SDK 版本 6.3.0.6 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 11.11.0 版。
  • Pangle SDK 版本 6.3.0.6。

版本 6.2.0.9.0

  • 已验证与 Pangle SDK 版本 6.2.0.9 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 版本 11.10.0。
  • Pangle SDK 版本 6.2.0.9。

版本 6.2.0.8.0

  • 已验证与 Pangle SDK 版本 6.2.0.8 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 版本 11.10.0。
  • Pangle SDK 版本 6.2.0.8。

版本 6.2.0.7.0

  • 已验证与 Pangle SDK 版本 6.2.0.7 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 11.8.0 版。
  • Pangle SDK 版本 6.2.0.7。

版本 6.2.0.6.0

  • 已验证与 Pangle SDK 版本 6.2.0.6 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 11.8.0 版。
  • Pangle SDK 版本 6.2.0.6。

版本 6.2.0.5.0

  • 已验证与 Pangle SDK 版本 6.2.0.5 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 11.8.0 版。
  • Pangle SDK 版本 6.2.0.5。

版本 6.1.0.6.0

  • 已验证与 Pangle SDK 版本 6.1.0.6 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 11.7.0 版。
  • Pangle SDK 版本 6.1.0.6。

版本 6.1.0.5.0

  • 已验证与 Pangle SDK 版本 6.1.0.5 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 11.6.0 版。
  • Pangle SDK 版本 6.1.0.5。

版本 6.1.0.4.0

  • 已验证与 Pangle SDK 版本 6.1.0.4 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 11.6.0 版。
  • Pangle SDK 版本 6.1.0.4。

版本 6.0.0.6.0

  • 已验证与 Pangle SDK 版本 6.0.0.6 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 11.6.0 版。
  • Pangle SDK 版本 6.0.0.6。

版本 6.0.0.5.0

  • 已验证与 Pangle SDK 版本 6.0.0.5 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 11.5.0 版。
  • Pangle SDK 版本 6.0.0.5。

版本 6.0.0.4.0

  • 已验证与 Pangle SDK 版本 6.0.0.4 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 11.5.0 版。
  • Pangle SDK 版本 6.0.0.4。

版本 5.9.0.9.0

  • 已验证与 Pangle SDK 版本 5.9.0.9 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 11.5.0 版。
  • Pangle SDK 版本 5.9.0.9。

版本 5.9.0.8.0

  • 已验证与 Pangle SDK 版本 5.9.0.8 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 11.4.0 版。
  • Pangle SDK 版本 5.9.0.8。

版本 5.9.0.7.0

  • 已验证与 Pangle SDK 版本 5.9.0.7 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 11.3.0 版。
  • Pangle SDK 版本 5.9.0.7。

版本 5.8.0.8.0

  • 已验证与 Pangle SDK 版本 5.8.0.8 的兼容性。
  • 更新了适配器，以使用新的 Pangle SDK 信号收集 API。

构建和测试所需版本：

  • Google 移动广告 SDK 11.2.0 版。
  • Pangle SDK 版本 5.8.0.8。

版本 5.8.0.7.0

  • 已验证与 Pangle SDK 版本 5.8.0.7 的兼容性。
  • 现在，最低 iOS 版本要求为 12.0。
  • 现在需要 Google 移动广告 SDK 11.0 或更高版本。
  • 在 PangleAdapter.xcframework 中的框架中添加了 Info.plist。

构建和测试所需版本：

  • Google 移动广告 SDK 版本 11.0.1。
  • Pangle SDK 版本 5.8.0.7。

版本 5.7.0.7.0

  • 已验证与 Pangle SDK 版本 5.7.0.7 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 10.14.0 版。
  • Pangle SDK 版本 5.7.0.7。

版本 5.7.0.6.0

  • 已验证与 Pangle SDK 版本 5.7.0.6 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 10.14.0 版。
  • Pangle SDK 版本 5.7.0.6。

版本 5.6.0.8.0

  • 已验证与 Pangle SDK 版本 5.6.0.8 的兼容性。
  • 通过将已废弃的 adConfiguration.childDirectedTreatment 属性替换为新的 GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment 属性，重构了 +setCOPPA 方法。

构建和测试所需版本：

  • Google 移动广告 SDK 10.14.0 版。
  • Pangle SDK 版本 5.6.0.8。

版本 5.5.0.9.0

  • 已验证与 Pangle SDK 版本 5.5.0.9 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 10.13.0 版。
  • Pangle SDK 版本 5.5.0.9。

版本 5.5.0.7.0

  • 已验证与 Pangle SDK 版本 5.5.0.7 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 10.12.0 版。
  • Pangle SDK 版本 5.5.0.7。

版本 5.5.0.5.0

  • 已验证与 Pangle SDK 版本 5.5.0.5 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 10.11.0 版。
  • Pangle SDK 版本 5.5.0.5。

版本 5.4.1.1.0

  • 添加了对应用打开广告格式的出价支持。
  • 已验证与 Pangle SDK 版本 5.4.1.1 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 10.10.0 版。
  • Pangle SDK 版本 5.4.1.1。

版本 5.4.0.9.0

  • 已验证与 Pangle SDK 版本 5.4.0.9 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 10.9.0 版。
  • Pangle SDK 版本 5.4.0.9。

版本 5.4.0.8.0

  • 修复了 GADPangleNetworkExtras 不符合 GADAdNetworkExtras 协议的问题。
  • 在插页式广告、激励广告和开屏广告中实现了 adDidShowFail 协议方法。
  • 已验证与 Pangle SDK 版本 5.4.0.8 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 10.9.0 版。
  • Pangle SDK 版本 5.4.0.8。

版本 5.3.1.2.0

  • 已验证与 Pangle SDK 版本 5.3.1.2 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 10.8.0 版。
  • Pangle SDK 版本 5.3.1.2。

版本 5.3.1.0.0

  • 已验证与 Pangle SDK 版本 5.3.1.0 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 10.8.0 版。
  • Pangle SDK 版本 5.3.1.0。

版本 5.2.1.1.0

  • 已验证与 Pangle SDK 版本 5.2.1.1 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 10.7.0 版。
  • Pangle SDK 版本 5.2.1.1。

版本 5.2.0.9.0

  • 已验证与 Pangle SDK 版本 5.2.0.9 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 10.5.0 版。
  • Pangle SDK 版本 5.2.0.9。

版本 5.2.0.8.0

  • 已验证与 Pangle SDK 版本 5.2.0.8 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 10.5.0 版。
  • Pangle SDK 版本 5.2.0.8。

版本 5.2.0.7.0

  • 为开屏广告、横幅广告（包括 MREC）、插页式广告、激励广告和原生广告格式添加了广告瀑布流支持。
  • 已验证与 Pangle SDK 版本 5.2.0.7 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 10.5.0 版。
  • Pangle SDK 版本 5.2.0.7。

版本 5.2.0.6.0

  • 已验证与 Pangle SDK 版本 5.2.0.6 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 10.5.0 版。
  • Pangle SDK 版本 5.2.0.6。

版本 5.1.1.0.0

  • 已经验证与 Pangle SDK 版本 5.1.1.0 兼容。
  • 添加了对 arm64 模拟器架构的支持。
  • 现在需要 Google 移动广告 SDK 10.4.0 或更高版本。

构建和测试所需版本：

  • Google 移动广告 SDK 10.4.0 版。
  • Pangle SDK 版本 5.1.1.0。

版本 5.1.0.6.0

  • 已验证与 Pangle SDK 版本 5.1.0.6 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 10.3.0 版。
  • Pangle SDK 版本 5.1.0.6。

版本 5.0.1.0.0

  • 已验证与 Pangle SDK 版本 5.0.1.0 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 10.2.0 版。
  • Pangle SDK 版本 5.0.1.0。

版本 5.0.0.8.0

  • 已验证与 Pangle SDK 版本 5.0.0.8 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 10.2.0 版。
  • Pangle SDK 版本 5.0.0.8。

版本 5.0.0.7.0

  • 已验证与 Pangle SDK 版本 5.0.0.7 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 10.1.0 版。
  • Pangle SDK 版本 5.0.0.7。

版本 5.0.0.6.0

  • 已验证与 Pangle SDK 版本 5.0.0.6 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 10.1.0 版。
  • Pangle SDK 版本 5.0.0.6。

版本 4.9.1.0.0

  • 移除了对 armv7 架构的支持。
  • 已验证与 Pangle SDK 版本 4.9.1.0 的兼容性。
  • 现在，最低 iOS 版本要求为 12.0。
  • 现在需要 Google 移动广告 SDK 10.0.0 或更高版本。

构建和测试所需版本：

  • Google 移动广告 SDK 10.0.0 版。
  • Pangle SDK 版本 4.9.1.0。

版本 4.9.0.8.0

  • 已验证与 Pangle SDK 4.9.0.8 版的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 9.14.0 版。
  • Pangle SDK 版本 4.9.0.8。

版本 4.9.0.7.0

  • 已验证与 Pangle SDK 4.9.0.7 版本的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 9.14.0 版。
  • Pangle SDK 版本 4.9.0.7。

版本 4.9.0.6.0

  • 已验证与 Pangle SDK 4.9.0.6 版本的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 9.14.0 版。
  • Pangle SDK 版本 4.9.0.6。

版本 4.8.1.0.0

  • 已验证与 Pangle SDK 版本 4.8.1.0 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 9.14.0 版。
  • Pangle SDK 版本 4.8.1.0。

版本 4.8.0.9.0

  • 已验证与 Pangle SDK 4.8.0.9 版本的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 9.13.0 版。
  • Pangle SDK 版本 4.8.0.9。

版本 4.8.0.7.0

  • 已验证与 Pangle SDK 版本 4.8.0.7 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 9.13.0 版。
  • Pangle SDK 版本 4.8.0.7。

版本 4.8.0.6.0

  • 已验证与 Pangle SDK 版本 4.8.0.6 的兼容性。
  • 修复了在加载原生广告图标图片时主线程被阻塞的问题。

构建和测试所需版本：

  • Google 移动广告 SDK 9.13.0 版。
  • Pangle SDK 版本 4.8.0.6。

版本 4.7.0.7.0

  • 已验证与 Pangle SDK 版本 4.7.0.7 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 9.11.0 版。
  • Pangle SDK 版本 4.7.0.7。

版本 4.7.0.6.0

  • 已验证与 Pangle SDK 版本 4.7.0.6 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 9.11.0 版。
  • Pangle SDK 版本 4.7.0.6。

版本 4.7.0.5.0

  • 已验证与 Pangle SDK 版本 4.7.0.5 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 9.11.0 版。
  • Pangle SDK 版本 4.7.0.5。

版本 4.7.0.4.0

  • 已验证与 Pangle SDK 版本 4.7.0.4 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 9.10.0 版。
  • Pangle SDK 版本 4.7.0.4。

版本 4.6.2.2.0

  • 将 GADMediationAdapterPangle 类中的 setGDPR() 和 setCCPA() 方法分别重命名为 setGDPRConsent() 和 setDoNotSell。
  • 已验证与 Pangle SDK 版本 4.6.2.2 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 9.10.0 版。
  • Pangle SDK 版本 4.6.2.2。

版本 4.6.1.8.0

  • 已验证与 Pangle SDK 版本 4.6.1.8 的兼容性。
  • 添加了对原生广告格式的出价支持。
  • 更新了适配器以使用 didRewardUser API。
  • 现在需要 Google 移动广告 SDK 9.8.0 或更高版本。

构建和测试所需版本：

  • Google 移动广告 SDK 9.9.0 版。
  • Pangle SDK 版本 4.6.1.8。

版本 4.5.2.8.0

  • 已验证与 Pangle SDK 版本 4.5.2.8 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 9.7.0 版。
  • Pangle SDK 版本 4.5.2.8。

版本 4.5.2.7.0

  • 已验证与 Pangle SDK 版本 4.5.2.7 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 9.7.0 版。
  • Pangle SDK 版本 4.5.2.7。

版本 4.5.2.5.0

  • 已验证与 Pangle SDK 版本 4.5.2.5 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 9.6.0 版。
  • Pangle SDK 版本 4.5.2.5。

版本 4.5.2.4.0

  • 已验证与 Pangle SDK 版本 4.5.2.4 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 9.6.0 版。
  • Pangle SDK 版本 4.5.2.4。

版本 4.5.2.3.0

  • 已验证与 Pangle SDK 版本 4.5.2.3 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 9.6.0 版。
  • Pangle SDK 版本 4.5.2.3。

版本 4.5.1.3.0

  • 已验证与 Pangle SDK 版本 4.5.1.3 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 9.5.0 版。
  • Pangle SDK 版本 4.5.1.3。

版本 4.3.1.9.0

  • 已验证与 Pangle SDK 版本 4.3.1.9 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 9.3.0 版。
  • Pangle SDK 版本 4.3.1.9。

版本 4.3.0.5.0

  • 已验证与 Pangle SDK 版本 4.3.0.5 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 9.2.0 版。
  • Pangle SDK 版本 4.3.0.5。

版本 4.3.0.4.0

  • 初始版本！
  • 添加了对横幅广告（包括 MREC）、插页式广告和激励广告格式的出价支持。

构建和测试所需版本：

  • Google 移动广告 SDK 9.1.0 版。
  • Pangle SDK 版本 4.3.0.4。