שילוב של Pangle עם תהליך בחירת הרשת (Mediation)

This guide shows you how to use the Google Mobile Ads SDK to load and display ads from Pangle using mediation, covering both waterfall and bidding integrations. It covers how to add Pangle to an ad unit's mediation configuration and how to integrate the Pangle SDK and adapter into a Flutter app.

Supported integrations and ad formats

The AdMob mediation adapter for Pangle has the following capabilities:

Integration
Bidding
Waterfall
Formats
Banner
Interstitial
Rewarded
Rewarded Interstitial

Requirements

  • Latest Google Mobile Ads SDK
  • Flutter 3.7.0 or higher
  • To deploy on Android
    • Android API level 21 or higher
  • To deploy on iOS
    • iOS deployment target of 12.0 or higher
  • A working Flutter project configured with the Google Mobile Ads SDK. See Get Started for details.
  • Complete the mediation Get started guide

Step 1: Set up configurations in Pangle UI

注册或登录您的 Pangle 帐号。

添加新应用

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

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

Android

iOS

记下您应用的应用 ID。

Android

iOS

创建广告展示位置

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

Android

iOS

出价

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

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

Android

iOS

瀑布

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

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

Android

iOS

找到 Pangle Reporting API 密钥

出价

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

瀑布

记下页面左下角的 User ID。

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

开启测试模式

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

Step 2: Set up Pangle demand in AdMob UI

קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות

Android

לקבלת הוראות, עיינו בשלב 2 במדריך עבור Android.

iOS

לקבלת הוראות, עיינו בשלב 2 במדריך iOS.

Step 3: Import the Pangle SDK and adapter

通过 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: ^1.0.0

手动集成

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

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

Step 4: Add required code

Android

No additional code required for Pangle integration.

iOS

SKAdNetwork integration

Follow Pangle's documentation to add the SKAdNetwork identifiers to your project's Info.plist file.

Step 5: Test your implementation

הפעלת מודעות בדיקה

חשוב לרשום את מכשיר הבדיקה ל- AdMob ולהפעיל את מצב הבדיקה ב Pangle ממשק המשתמש.

אימות מודעות בדיקה

כדי לוודא שמוצגות לך מודעות לבדיקה מ-Pangle, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות Pangle (Bidding) and Pangle (Waterfall) מקורות המודעות.

Error codes

If the adapter fails to receive an ad from Pangle, publishers can check the underlying error from the ad response using ResponseInfo under the following classes:

Android

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

iOS

GADMediationAdapterPangle

Here are the codes and accompanying messages thrown by the Pangle adapter when an ad fails to load:

Android

Error code Domain Reason
101 com.google.ads.mediation.pangle Invalid server parameters (e.g. Missing app ID or placement ID).
102 com.google.ads.mediation.pangle The requested ad size does not match a Pangle supported banner size.
103 com.google.ads.mediation.pangle Missing or invalid bid response.
-1-60000 com.pangle.ads Pangle SDK returned an error. See Pangle's documentation for more details.

iOS

Error code Domain Reason
101 com.google.ads.mediation.pangle Invalid server parameters (e.g. Missing app ID or placement ID).
102 com.google.ads.mediation.pangle The requested ad size does not match a Pangle supported banner size.
-1-60000 Sent by Pangle SDK Pangle SDK returned an error. See Pangle's documentation for more details.

Pangle Flutter Mediation Adapter Changelog

1.1.0

  • Verified compatibility with Pangle Android adapter version 5.9.0.4.0.
  • Verified compatibility with Pangle iOS adapter version 5.9.0.7.0.
  • Built and tested with the Google Mobile Ads Flutter Plugin version 5.1.0.

1.0.0

  • Initial release.
  • Verified compatibility with Pangle Android adapter version 5.8.0.9.0
  • Verified compatibility with Pangle iOS adapter version 5.8.0.8.0
  • Built and tested with the Google Mobile Ads Flutter Plugin version 5.0.0.