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
เพิ่มแอปพลิเคชันใหม่
ไปที่แท็บแอปพลิเคชัน และคลิกปุ่มเพิ่มแอป
เลือกระบบปฏิบัติการที่คุณต้องการสร้างแอปพลิเคชันและกรอกข้อมูลในแบบฟอร์มส่วนที่เหลือ จากนั้นคลิกส่ง
Android
iOS
จดรหัสแอปของแอปพลิเคชัน
Android
iOS
สร้างตำแหน่งโฆษณา
เมื่อสร้างแอปพลิเคชันแล้ว ให้คลิกปุ่มเพิ่มเพื่อสร้างตำแหน่งโฆษณา
Android
iOS
การเสนอราคา
เลือกรูปแบบโฆษณาและชื่อตำแหน่งโฆษณา และเลือกการเสนอราคาในแอปเป็นประเภทการกำหนดราคา กรอกข้อมูลในแบบฟอร์มส่วนที่เหลือ แล้วคลิกส่ง
เมื่อสร้างตำแหน่งโฆษณาแล้ว ให้จดรหัสตำแหน่งโฆษณา
Android
iOS
น้ำตก
เลือกรูปแบบโฆษณาและชื่อตำแหน่งโฆษณา และเลือก CPM ทั่วโลกเป็นประเภทการกำหนดราคา กรอกข้อมูลในแบบฟอร์มส่วนที่เหลือ แล้วคลิกส่ง
เมื่อสร้างตำแหน่งโฆษณาแล้ว ให้จดรหัสตำแหน่งโฆษณา
Android
iOS
ค้นหาคีย์ Pangle Reporting API
การเสนอราคา
ขั้นตอนนี้ไม่จำเป็นสำหรับการผสานรวมการเสนอราคา
น้ำตก
จดบันทึก User ID ที่มุมซ้ายล่างของหน้าเว็บ
คลิก Integrations > SDK และ API > Pangle Reporting API 2.0 จดรหัสบทบาทและคีย์ความปลอดภัย
เปิดโหมดทดสอบ
ทำตามวิธีการในคู่มือวิธีเพิ่มโฆษณาทดสอบของ Pangle เกี่ยวกับวิธีเปิดใช้โฆษณาทดสอบของ Pangle
Step 2: Set up Pangle demand in AdMob UI
กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา
Android
ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสําหรับ Android
iOS
โปรดดูวิธีการในขั้นตอนที่ 2 ในคู่มือสำหรับ iOS
Step 3: Import the Pangle SDK and adapter
การผสานรวมผ่าน pub.dev
(Android เท่านั้น) เพิ่มที่เก็บต่อไปนี้ลงในไฟล์ build.gradle
ภายใน
ไดเรกทอรี android
ของโปรเจ็กต์ของคุณ:
repositories {
google()
mavenCentral()
maven {
url = uri("https://artifact.bytedance.com/repository/pangle/")
}
}
เพิ่มการอ้างอิงต่อไปนี้ด้วยเวอร์ชันล่าสุดของ
Pangle SDK และอะแดปเตอร์ในแพ็กเกจ
ไฟล์ pubspec.yaml
:
dependencies:
gma_mediation_pangle: ^1.0.0
การผสานรวมด้วยตนเอง
ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุดสำหรับ
Pangle
แยกไฟล์ที่ดาวน์โหลด และเพิ่มโฟลเดอร์ปลั๊กอินที่ดึงมา
(และเนื้อหาภายใน) ลงในโปรเจ็กต์ Flutter ของคุณ จากนั้นให้อ้างอิงปลั๊กอินใน
pubspec.yaml
ด้วยการเพิ่มทรัพยากร Dependency ต่อไปนี้
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 UI
ยืนยันโฆษณาทดสอบ
ในการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก 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.