Questa pagina è stata tradotta dall'API Cloud Translation.

Integra Pangle con la mediazione

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

支持的集成和广告格式

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

集成
出价
瀑布	¹
表现形式
开屏广告	²
横幅
插页式广告
已奖励
插页式激励广告
原生

¹ 广告瀑布流集成功能目前处于公开 Beta 版阶段。

² 适用于此格式的出价集成功能目前处于封闭式 Beta 版测试阶段。

要求

Android API 级别 19 或更高级别

最新版 Google 移动广告 SDK
通读中介入门指南

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

注册或登录您的 Pangle 帐号。

添加新应用

导航到 Applications（应用程序）标签页，然后点击 Add App（添加应用）按钮。

选择 Android 作为操作系统，然后填写表单的其余部分。然后，点击提交。

记下应用的应用 ID。

创建广告展示位置

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

出价

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

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

瀑布

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

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

找到 Pangle Reporting API 密钥

出价

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

瀑布

记下页面左下角的 User ID。

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

开启测试模式

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

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

为广告单元配置中介设置

您需要将 Pangle 添加到广告单元的中介配置中。首先，登录您的 AdMob 帐号。

转到中介标签页。如果您想要修改现有的中介组，请点击该中介组的名称以进行修改，然后跳至将 Pangle 添加为广告来源。

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

中介详情

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

为中介组命名，然后选择要定位到的地理位置。接下来，将中介组状态设置为已启用。然后，点击添加广告单元，系统随即会打开广告单元选择叠加层。

将此中介组与您的现有 AdMob 广告单元相关联。然后，点击完成。

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

将 Pangle 添加为广告来源

出价

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

点击如何签署合作伙伴协议，然后与 Pangle 设置出价合作伙伴关系。

点击确认并同意，然后点击继续。

如果您已有 Pangle 的映射，只需选择它即可。否则，请点击添加映射。

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

瀑布

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

选择 Pangle 并启用 Optimize 开关。输入在上一部分中获取的 Reporting API 用户 ID、Reporting API 角色 ID 和 Secret Key。然后，为 Pangle 输入 eCPM 值，并点击继续。

如果您已有 Pangle 的映射，只需选择它即可。否则，请点击添加映射。

接下来，输入应用 ID 和广告展示位置 ID。然后，点击完成。

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

Android Studio 集成（推荐）

在应用级 build.gradle 文件中添加以下实现依赖项以及最新版 Pangle SDK 和适配器：

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

...
dependencies {
    implementation 'com.google.android.gms:play-services-ads:22.5.0'
    implementation 'com.google.ads.mediation:pangle:5.5.0.8.0'
}
...

手动集成

下载最新版本的 Pangle SDK for Android，然后从下载的归档文件夹中解压缩 open_ad_sdk.aar，并将其添加到您的项目。
转到 Google 的 Maven 制品库中的 Pangle 适配器工件。选择最新版本，下载 Pangle 适配器的 .aar 文件并将其添加到项目中。

第 4 步：添加所需的代码

ProGuard 混淆

如果您使用 ProGuard 混淆 Android 代码，请按照 Pangle 文档中的说明操作，以确保不对 Pangle SDK 代码进行混淆处理。

第 5 步：测试您的实现

Attiva annunci di prova

Assicurati di registrare il dispositivo di test per AdMob e di abilitare la modalità di test nell' Pangle interfaccia utente.

Verifica annunci di prova

Per verificare di ricevere annunci di prova daPangle, attiva il test di una singola origine annuncio nello strumento di controllo degli annunci utilizzando le Pangle (Bidding) and Pangle (Waterfall) origini annuncio.

可选步骤

原生广告

广告呈现

Pangle 适配器以 NativeAd 对象的形式返回其原生广告。它会为 NativeAd 填充以下字段。

字段	Pangle 适配器始终包含资源
标题
图片	1
Body
Icon
号召性用语
星级
存储
Price
广告客户

¹ Pangle 适配器不允许直接访问其原生广告的主图片素材资源。相反，适配器会使用视频或图片填充 MediaView 。

错误代码

如果适配器无法从 Pangle 接收广告，您可以使用以下类下的 ResponseInfo.getAdapterResponse() 检查广告响应中的底层错误：

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

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

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

Pangle Android 中介适配器更新日志

下一版本

将出价令牌收集功能更新为使用 BiddingTokenCallback。

版本 5.5.0.8.0

经验证与 Pangle SDK 版本 5.5.0.8 兼容。

构建和测试所需版本：

Google 移动广告 SDK 22.3.0 版。
Pangle SDK 版本 5.5.0.8。

版本 5.5.0.7.0

经验证与 Pangle SDK 版本 5.5.0.7 兼容。

构建和测试所需版本：

Google 移动广告 SDK 22.3.0 版。
Pangle SDK 版本 5.5.0.7。

版本 5.5.0.6.0

此版本不支持出价开屏广告格式，因为此适配器版本已还原为依赖于 Google 移动广告 SDK 22.3.0 版。
经验证与 Pangle SDK 版本 5.5.0.6 兼容。

构建和测试所需版本：

Google 移动广告 SDK 22.3.0 版。
Pangle SDK 版本 5.5.0.6。

版本 5.5.0.4.0

新增了对开屏广告格式的出价支持。
为出价广告添加了水印支持。
将所需的最低 Google 移动广告 SDK 版本更新为 22.4.0。
经验证与 Pangle SDK 版本 5.5.0.4 兼容。

构建和测试所需版本：

Google 移动广告 SDK 22.4.0 版。
Pangle SDK 版本 5.5.0.4。

版本 5.4.1.1.0

修复了适配器无法初始化的问题。
经验证与 Pangle SDK 版本 5.4.1.1 兼容。

构建和测试所需版本：

Google 移动广告 SDK 22.3.0 版。
Pangle SDK 版本 5.4.1.1。

版本 5.4.0.9.0

经验证与 Pangle SDK 版本 5.4.0.9 兼容。
将所需的最低 Google 移动广告 SDK 版本更新为 22.3.0。

构建和测试所需版本：

Google 移动广告 SDK 22.3.0 版。
Pangle SDK 版本 5.4.0.9。

版本 5.4.0.8.0

经验证与 Pangle SDK 版本 5.4.0.8 兼容。

构建和测试所需版本：

Google 移动广告 SDK 22.2.0 版。
Pangle SDK 版本 5.4.0.8。

版本 5.3.0.6.0

经验证与 Pangle SDK 版本 5.3.0.6 兼容。

构建和测试所需版本：

Google 移动广告 SDK 22.2.0 版。
Pangle SDK 版本 5.3.0.6。

版本 5.3.0.5.0

经验证与 Pangle SDK 版本 5.3.0.5 兼容。

构建和测试所需版本：

Google 移动广告 SDK 22.2.0 版。
Pangle SDK 版本 5.3.0.5。

版本 5.3.0.4.0

经验证与 Pangle SDK 版本 5.3.0.4 兼容。

构建和测试所需版本：

Google 移动广告 SDK 22.2.0 版。
Pangle SDK 版本 5.3.0.4。

版本 5.2.0.7.0

经验证与 Pangle SDK 版本 5.2.0.7 兼容。

构建和测试所需版本：

Google 移动广告 SDK 22.1.0 版
Pangle SDK 版本 5.2.0.7。

版本 5.2.0.6.0

经验证与 Pangle SDK 版本 5.2.0.6 兼容。

构建和测试所需版本：

Google 移动广告 SDK 22.1.0 版
Pangle SDK 版本 5.2.0.6。

版本 5.2.0.5.0

经验证与 Pangle SDK 版本 5.2.0.5 兼容。

构建和测试所需版本：

Google 移动广告 SDK 22.1.0 版
Pangle SDK 版本 5.2.0.5。

版本 5.2.0.3.0

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

构建和测试所需版本：

Google 移动广告 SDK 22.0.0 版。
Pangle SDK 版本 5.2.0.3。

版本 5.1.0.9.0

经验证与 Pangle SDK 版本 5.1.0.9 兼容。

构建和测试所需版本：

Google 移动广告 SDK 22.0.0 版。
Pangle SDK 版本 5.1.0.9。

版本 5.1.0.8.0

经验证与 Pangle SDK 版本 5.1.0.8 兼容。

构建和测试所需版本：

Google 移动广告 SDK 22.0.0 版。
Pangle SDK 版本 5.1.0.8。

版本 5.1.0.6.0

更新了适配器，以使用新的 VersionInfo 类。
将所需的最低 Google 移动广告 SDK 版本更新为 22.0.0。

构建和测试所需版本：

Google 移动广告 SDK 22.0.0 版。
Pangle SDK 版本 5.1.0.6。

版本 5.0.1.1.0

经验证与 Pangle SDK 版本 5.0.1.1 兼容。

构建和测试所需版本：

Google 移动广告 SDK 21.5.0 版。
Pangle SDK 版本 5.0.1.1。

版本 5.0.1.0.0

经验证与 Pangle SDK 版本 5.0.1.0 兼容。

构建和测试所需版本：

Google 移动广告 SDK 21.5.0 版。
Pangle SDK 版本 5.0.1.0。

版本 5.0.0.9.0

经验证与 Pangle SDK 版本 5.0.0.9 兼容。

构建和测试所需版本：

Google 移动广告 SDK 21.5.0 版。
Pangle SDK 版本 5.0.0.9。

版本 5.0.0.8.0

经验证与 Pangle SDK 版本 5.0.0.8 兼容。

构建和测试所需版本：

Google 移动广告 SDK 21.5.0 版。
Pangle SDK 版本 5.0.0.8。

版本 5.0.0.7.0

经验证与 Pangle SDK 版本 5.0.0.7 兼容。

构建和测试所需版本：

Google 移动广告 SDK 21.5.0 版。
Pangle SDK 版本 5.0.0.7。

版本 5.0.0.6.0

经验证与 Pangle SDK 版本 5.0.0.6 兼容。

构建和测试所需版本：

Google 移动广告 SDK 21.5.0 版。
Pangle SDK 版本 5.0.0.6。

版本 4.9.0.9.0

经验证与 Pangle SDK 版本 4.9.0.9 兼容。
将所需的最低 Google 移动广告 SDK 版本更新为 21.5.0。

构建和测试所需版本：

Google 移动广告 SDK 21.5.0 版。
Pangle SDK 版本 4.9.0.9。

版本 4.9.0.8.0

经验证与 Pangle SDK 版本 4.9.0.8 兼容。

构建和测试所需版本：

Google 移动广告 SDK 21.4.0 版。
Pangle SDK 版本 4.9.0.8。

版本 4.9.0.7.0

经验证与 Pangle SDK 版本 4.9.0.7 兼容。

构建和测试所需版本：

Google 移动广告 SDK 21.4.0 版。
Pangle SDK 版本 4.9.0.7。

版本 4.9.0.6.0

经验证与 Pangle SDK 版本 4.9.0.6 兼容。

构建和测试所需版本：

Google 移动广告 SDK 21.4.0 版。
Pangle SDK 版本 4.9.0.6。

版本 4.8.1.0.0

经验证与 Pangle SDK 版本 4.8.1.0 兼容。
将所需的最低 Google 移动广告 SDK 版本更新为 21.4.0。

构建和测试所需版本：

Google 移动广告 SDK 21.4.0 版。
Pangle SDK 版本 4.8.1.0。

版本 4.8.0.9.0

经验证与 Pangle SDK 版本 4.8.0.9 兼容。

构建和测试所需版本：

Google 移动广告 SDK 21.3.0 版。
Pangle SDK 版本 4.8.0.9。

版本 4.8.0.8.0

经验证与 Pangle SDK 版本 4.8.0.8 兼容。

构建和测试所需版本：

Google 移动广告 SDK 21.3.0 版。
Pangle SDK 版本 4.8.0.8。

版本 4.8.0.7.0

经验证与 Pangle SDK 版本 4.8.0.7 兼容。

构建和测试所需版本：

Google 移动广告 SDK 21.3.0 版。
Pangle SDK 版本 4.8.0.7。

版本 4.8.0.6.0

经验证与 Pangle SDK 版本 4.8.0.6 兼容。

构建和测试所需版本：

Google 移动广告 SDK 21.3.0 版。
Pangle SDK 版本 4.8.0.6。

版本 4.7.0.7.0

经验证与 Pangle SDK 版本 4.7.0.7 兼容。
将所需的最低 Google 移动广告 SDK 版本更新为 21.3.0。

构建和测试所需版本：

Google 移动广告 SDK 21.3.0 版。
Pangle SDK 版本 4.7.0.7。

版本 4.7.0.6.0

经验证与 Pangle SDK 版本 4.7.0.6 兼容。

构建和测试所需版本：

Google 移动广告 SDK 21.2.0 版。
Pangle SDK 版本 4.7.0.6。

版本 4.7.0.5.0

经验证与 Pangle SDK 版本 4.7.0.5 兼容。

构建和测试所需版本：

Google 移动广告 SDK 21.2.0 版。
Pangle SDK 版本 4.7.0.5。

版本 4.7.0.3.0

经验证与 Pangle SDK 版本 4.7.0.3 兼容。
适配器现在会在加载广告之前尝试初始化 Pangle SDK。

构建和测试所需版本：

Google 移动广告 SDK 21.2.0 版。
Pangle SDK 版本 4.7.0.3。

版本 4.6.0.9.0

经验证与 Pangle SDK 版本 4.6.0.9 兼容。
将所需的最低 Google 移动广告 SDK 版本更新为 21.2.0。

构建和测试所需版本：

Google 移动广告 SDK 21.2.0 版。
Pangle SDK 版本 4.6.0.9。

版本 4.5.0.6.1

新增了对原生广告格式的出价支持。
将所需的最低 Google 移动广告 SDK 版本更新为 21.1.0。

构建和测试所需版本：

Google 移动广告 SDK 21.1.0 版。
Pangle SDK 版本 4.5.0.6。

版本 4.5.0.6.0

经验证与 Pangle SDK 版本 4.5.0.6 兼容。

构建和测试所需版本：

Google 移动广告 SDK 21.0.0 版。
Pangle SDK 版本 4.5.0.6。

版本 4.5.0.5.0

经验证与 Pangle SDK 版本 4.5.0.5 兼容。

构建和测试所需版本：

Google 移动广告 SDK 21.0.0 版。
Pangle SDK 版本 4.5.0.5。

版本 4.5.0.4.0

经验证与 Pangle SDK 版本 4.5.0.4 兼容。

构建和测试所需版本：

Google 移动广告 SDK 21.0.0 版。
Pangle SDK 版本 4.5.0.4。

版本 4.5.0.3.0

经验证与 Pangle SDK 版本 4.5.0.3 兼容。
将 compileSdkVersion 和 targetSdkVersion 更新为了 API 31。
将所需的最低 Google 移动广告 SDK 版本更新为 21.0.0。
将所需的最低 Android API 级别更新为 19。

构建和测试所需版本：

Google 移动广告 SDK 21.0.0 版。
Pangle SDK 版本 4.5.0.3。

版本 4.3.0.9.0

经验证与 Pangle SDK 版本 4.3.0.9 兼容。

构建和测试所需版本：

Google 移动广告 SDK 20.6.0 版。
Pangle SDK 版本 4.3.0.9。

版本 4.3.0.8.0

经验证与 Pangle SDK 版本 4.3.0.8 兼容。

构建和测试所需版本：

Google 移动广告 SDK 20.6.0 版。
Pangle SDK 版本 4.3.0.8。

版本 4.3.0.7.0

经验证与 Pangle SDK 版本 4.3.0.7 兼容。

构建和测试所需版本：

Google 移动广告 SDK 20.6.0 版。
Pangle SDK 版本 4.3.0.7。

版本 4.3.0.6.0

经验证与 Pangle SDK 版本 4.3.0.6 兼容。

构建和测试所需版本：

Google 移动广告 SDK 20.6.0 版。
Pangle SDK 版本 4.3.0.6。

版本 4.3.0.4.0

经验证与 Pangle SDK 版本 4.3.0.4 兼容。

构建和测试所需版本：

Google 移动广告 SDK 20.6.0 版。
Pangle SDK 版本 4.3.0.4。

版本 4.2.5.3.0

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

构建和测试所需版本：

Google 移动广告 SDK 20.6.0 版。
Pangle SDK 版本 4.2.5.3。