คู่มือนี้แสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดง โฆษณาจาก Pangle โดยใช้สื่อกลาง ครอบคลุม ทั้ง Waterfall และการเสนอราคา ซึ่งครอบคลุมถึงวิธีการ เพิ่ม Pangle ในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม Pangle SDK และอะแดปเตอร์ลงใน Flutter แอป
การผสานรวมและรูปแบบโฆษณาที่รองรับ
AdMob อะแดปเตอร์สื่อกลางสำหรับ Pangle มี ความสามารถต่อไปนี้
การผสานรวม | |
---|---|
การเสนอราคา | |
น้ำตก | |
รูปแบบ | |
แบนเนอร์ | |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว | |
โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล |
ข้อกำหนด
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุด
- Flutter 3.7.0 ขึ้นไป
- เพื่อทำให้ใช้งานได้ใน Android
- API ของ Android ระดับ 21 ขึ้นไป
- เพื่อทำให้ใช้งานได้บน iOS
- เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
- โปรเจ็กต์ที่ใช้งานอยู่ Flutter ซึ่งกำหนดค่าด้วย SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google โปรดดู เริ่มต้นใช้งานเพื่อดูรายละเอียด
- ดำเนินการสื่อกลางให้เสร็จสิ้น คู่มือเริ่มต้นใช้งาน
ขั้นตอนที่ 1: กำหนดค่าใน Pangle UI
ขั้นตอนที่ 2: ตั้งค่าความต้องการ Pangle ใน AdMob UI
กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา
Android
ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสําหรับ Android
iOS
โปรดดูวิธีการในขั้นตอนที่ 2 ในคู่มือสำหรับ iOS
ขั้นตอนที่ 3: นำเข้า Pangle SDK และอะแดปเตอร์
การผสานรวมผ่าน 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
ขั้นตอนที่ 4: เพิ่มโค้ดที่จําเป็น
Android
ไม่ต้องใช้โค้ดเพิ่มเติมสำหรับการผสานรวม Pangle
iOS
การผสานรวม SKAdNetwork
ทำตามเอกสารประกอบของ Pangle
เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist
ของโปรเจ็กต์
ขั้นตอนที่ 5: ทดสอบการใช้งาน
เปิดใช้โฆษณาทดสอบ
อย่าลืม ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ AdMob และเปิดใช้โหมดทดสอบใน Pangle UI
ยืนยันโฆษณาทดสอบ
ในการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก Pangle ให้เปิดใช้ การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้ Pangle (Bidding) and Pangle (Waterfall) แหล่งที่มาของโฆษณา
รหัสข้อผิดพลาด
หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก Pangle ผู้เผยแพร่โฆษณาสามารถตรวจสอบ
ข้อผิดพลาดสำคัญจากการตอบกลับโฆษณาโดยใช้
ResponseInfo
ภายใต้
ชั้นเรียนต่อไปนี้
Android
com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter
iOS
GADMediationAdapterPangle
ต่อไปนี้เป็นรหัสและข้อความประกอบที่อะแดปเตอร์ Pangle โฆษณาไม่โหลด:
Android
รหัสข้อผิดพลาด | โดเมน | เหตุผล |
---|---|---|
101 | com.google.ads.mediation.pangle | พารามิเตอร์เซิร์ฟเวอร์ไม่ถูกต้อง (เช่น ไม่มีรหัสแอปหรือรหัสตำแหน่ง) |
102 | com.google.ads.mediation.pangle | ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ Pangle รองรับ |
103 | com.google.ads.mediation.pangle | ไม่มีการเสนอราคาตอบหรือไม่ถูกต้อง |
-1-60000 | com.pangle.ads | Pangle SDK แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมในเอกสารประกอบของ Pangle |
iOS
รหัสข้อผิดพลาด | โดเมน | เหตุผล |
---|---|---|
101 | com.google.ads.mediation.pangle | พารามิเตอร์เซิร์ฟเวอร์ไม่ถูกต้อง (เช่น ไม่มีรหัสแอปหรือรหัสตำแหน่ง) |
102 | com.google.ads.mediation.pangle | ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ Pangle รองรับ |
-1-60000 | ส่งโดย Pangle SDK | Pangle SDK แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมในเอกสารประกอบของ Pangle |
บันทึกการเปลี่ยนแปลงอะแดปเตอร์สื่อกลาง Flutter ของ Pangle
1.1.0
- ตรวจสอบความเข้ากันได้กับอะแดปเตอร์ Android ของ Pangle เวอร์ชัน 5.9.0.4.0
- ยืนยันความเข้ากันได้กับอะแดปเตอร์ iOS ของ Pangle เวอร์ชัน 5.9.0.7.0
- สร้างและทดสอบด้วย Google Mobile Ads Flutter Plugin เวอร์ชัน 5.1.0
1.0.0
- การเผยแพร่ครั้งแรก
- ตรวจสอบความเข้ากันได้กับอะแดปเตอร์ Android ของ Pangle เวอร์ชัน 5.8.0.9.0
- ตรวจสอบความเข้ากันได้กับอะแดปเตอร์ iOS ของ Pangle เวอร์ชัน 5.8.0.8.0
- สร้างและทดสอบด้วย Google Mobile Ads Flutter Plugin เวอร์ชัน 5.0.0