将 Pangle 与中介集成

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

支持的集成和广告格式

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

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

要求

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

  • [出价]:如需在出价中集成所有受支持的广告格式,请使用 Pangle 适配器 5.4.1.1.0 或更高版本(建议使用最新版本

  • 最新版 Google 移动广告 SDK

  • 完成中介入门指南

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

注册登录您的 Pangle 账号。

添加新应用

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

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

记下应用的应用 ID

创建广告展示位置

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

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

创建展示位置后,记下展示位置 ID

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

创建展示位置后,记下展示位置 ID

找到 Pangle Reporting API 密钥

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

记下页面左下角的用户 ID

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

开启测试模式

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

第 2 步:在 AdMob 界面中设置 Pangle 需求来源

为广告单元配置中介设置

您需要将 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.4.1.0.0

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

构建和测试所需版本:

  • Google 移动广告 SDK 11.13.0 版。
  • Pangle SDK 版本 6.4.1.0。

版本 6.4.0.9.0

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

构建和测试所需版本:

  • Google 移动广告 SDK 11.13.0 版。
  • Pangle SDK 版本 6.4.0.9。

版本 6.4.0.8.0

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

构建和测试所需版本:

  • Google 移动广告 SDK 11.13.0 版。
  • Pangle SDK 版本 6.4.0.8。

版本 6.4.0.7.0

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

构建和测试所需版本:

  • Google 移动广告 SDK 11.13.0 版。
  • Pangle SDK 版本 6.4.0.7。

版本 6.4.0.6.0

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

构建和测试所需版本:

  • Google 移动广告 SDK 11.13.0 版。
  • Pangle SDK 版本 6.4.0.6。

版本 6.3.1.0.0

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

构建和测试所需版本:

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

版本 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。