คู่มือนี้จะแสดงวิธีใช้ Google Mobile Ads SDK เพื่อโหลดและแสดงโฆษณาจาก Pangle โดยใช้สื่อกลาง ซึ่งครอบคลุม ทั้งการผสานรวม ตามลำดับขั้นและการเสนอราคา ซึ่งจะอธิบายวิธีเพิ่ม Pangle ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม SDK และอะแดปเตอร์ Pangle ลงใน Unity แอป
การผสานรวมและรูปแบบโฆษณาที่รองรับ
AdMob อะแดปเตอร์สื่อกลางสําหรับ Pangle มีคุณสมบัติต่อไปนี้
| การผสานรวม | |
|---|---|
| การเสนอราคา | |
| น้ำตก | |
| รูปแบบ | |
| แบนเนอร์ | |
| โฆษณาคั่นระหว่างหน้า | |
| ได้รับรางวัลแล้ว | |
| โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล | |
ข้อกำหนด
- Google Mobile Ads SDK เวอร์ชันล่าสุด
- Unity 5.6 ขึ้นไป
- [สําหรับการเสนอราคา]: หากต้องการผสานรวมรูปแบบโฆษณาที่รองรับทั้งหมดในการเสนอราคา ให้ใช้ปลั๊กอินสื่อกลาง Google Ads สําหรับ Pangle 2.4.0 ขึ้นไป (แนะนําให้ใช้เวอร์ชันล่าสุด)
- วิธีติดตั้งใช้งานใน Android
- Android API ระดับ 21 ขึ้นไป
- วิธีติดตั้งใช้งานใน iOS
- เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
- Unity โปรเจ็กต์ที่ทํางานได้ซึ่งกําหนดค่าด้วย Google Mobile Ads SDK ดูรายละเอียดได้ที่เริ่มต้นใช้งาน
- สื่อกลางเสร็จสมบูรณ์ คู่มือเริ่มต้นใช้งาน
ขั้นตอนที่ 1: ตั้งค่าการกําหนดค่าใน Pangle UI
ลงชื่อสมัครใช้หรือเข้าสู่ระบบบัญชี Pangle
เพิ่มแอปพลิเคชันใหม่
ไปที่แท็บแอปพลิเคชัน แล้วคลิกปุ่มเพิ่มแอป
เลือกระบบปฏิบัติการที่ต้องการสร้างแอปพลิเคชัน แล้วกรอกข้อมูลที่เหลือในแบบฟอร์ม จากนั้นคลิกส่ง
Android
iOS
จดบันทึกรหัสแอปของแอปพลิเคชัน
Android
iOS
สร้างตําแหน่งโฆษณา
เมื่อสร้างแอปพลิเคชันแล้ว ให้คลิกปุ่มเพิ่มเพื่อสร้างตําแหน่งโฆษณา
Android
iOS
การเสนอราคา
เลือกรูปแบบโฆษณาและชื่อตําแหน่งโฆษณา แล้วเลือกการเสนอราคาในแอปเป็นประเภทราคา กรอกข้อมูลที่เหลือในแบบฟอร์ม แล้วคลิกส่ง
เมื่อสร้างตําแหน่งโฆษณาแล้ว ให้จดบันทึกรหัสตําแหน่งโฆษณา
Android
iOS
น้ำตก
เลือกรูปแบบโฆษณาและชื่อตําแหน่งโฆษณา รวมถึง CPM ทั่วโลกเป็นประเภทราคา กรอกข้อมูลที่เหลือในแบบฟอร์ม แล้วคลิกส่ง
เมื่อสร้างตําแหน่งโฆษณาแล้ว ให้จดบันทึกรหัสตําแหน่งโฆษณา
Android
iOS
ค้นหาคีย์ Pangle Reporting API
การเสนอราคา
ขั้นตอนนี้ไม่จําเป็นสำหรับการผสานรวมการเสนอราคา
น้ำตก
จดรหัสผู้ใช้ไว้ที่มุมซ้ายล่างของหน้า
คลิกการผสานรวม > SDK และ API > Pangle Reporting API 2.0 จดรหัสบทบาทและคีย์ความปลอดภัยไว้
เปิดโหมดทดสอบ
ทําตามวิธีการในคู่มือวิธีเพิ่มโฆษณาทดสอบของ Pangle เพื่อเปิดใช้โฆษณาทดสอบของ Pangle
ขั้นตอนที่ 2: ตั้งค่าดีมานด์ Pangle ใน AdMob UI
กำหนดการตั้งค่าสื่อกลางสําหรับหน่วยโฆษณา
Android
โปรดดูวิธีการที่ขั้นตอนที่ 2 ในคู่มือสำหรับ Android
iOS
ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสำหรับ iOS
ขั้นตอนที่ 3: นําเข้า SDK และอะแดปเตอร์ Pangle
OpenUPM-CLI
หากติดตั้ง OpenUPM-CLI แล้ว คุณจะติดตั้งปลั๊กอินสื่อกลาง Pangle ของ Google Mobile Ads สําหรับ Unity ลงในโปรเจ็กต์ได้โดยเรียกใช้คําสั่งต่อไปนี้จากไดเรกทอรีรูทของโปรเจ็กต์
openupm add com.google.ads.mobile.mediation.pangle
OpenUPM
ในเครื่องมือแก้ไขโปรเจ็กต์ Unity ให้เลือกแก้ไข > การตั้งค่าโปรเจ็กต์ > เครื่องมือจัดการแพ็กเกจเพื่อเปิดการตั้งค่าเครื่องมือจัดการแพ็กเกจ Unity
ในแท็บรีจิสทรีที่มีขอบเขต ให้เพิ่ม OpenUPM เป็นรีจิสทรีที่มีขอบเขตพร้อมรายละเอียดต่อไปนี้
- ชื่อ:
OpenUPM - URL:
https://package.openupm.com - ขอบเขต:
com.google
จากนั้นไปที่หน้าต่าง > เครื่องมือจัดการแพ็กเกจเพื่อเปิดเครื่องมือจัดการแพ็กเกจ Unity แล้วเลือกที่เก็บของฉันจากเมนูแบบเลื่อนลง
เลือกแพ็กเกจ Google Mobile Ads Pangle Mediation แล้วคลิกติดตั้ง
แพ็กเกจ Unity
ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณา Google Mobile เวอร์ชันล่าสุดสําหรับ Pangle จากลิงก์ดาวน์โหลดในบันทึกการเปลี่ยนแปลง และแตกไฟล์ GoogleMobileAdsPangleMediation.unitypackage จากไฟล์ ZIP
ในเครื่องมือแก้ไขโปรเจ็กต์ Unity ให้เลือกเนื้อหา > นําเข้าแพ็กเกจ >
แพ็กเกจที่กําหนดเอง แล้วค้นหาไฟล์ GoogleMobileAdsPangleMediation.unitypackage ที่ดาวน์โหลด ตรวจสอบว่าได้เลือกไฟล์ทั้งหมดแล้ว แล้วคลิกนําเข้า
จากนั้นเลือกชิ้นงาน > เครื่องมือจัดการทรัพยากรภายนอก >
เครื่องมือแก้ไขของ Android > บังคับแก้ไข ไลบรารีเครื่องมือจัดการทรัพยากร Dependency ภายนอกจะทำการแก้ไข Dependency ตั้งแต่ต้นและคัดลอก Dependency ที่ประกาศไว้ไปยังไดเรกทอรี Assets/Plugins/Android ของแอป Unity
ขั้นตอนที่ 4: เพิ่มโค้ดที่จำเป็น
Android
ไม่ต้องใช้โค้ดเพิ่มเติมสำหรับการผสานรวม Pangle
iOS
การผสานรวม SKAdNetwork
ทําตามเอกสารประกอบของ Pangle เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist ของโปรเจ็กต์
ขั้นตอนที่ 5: ทดสอบการใช้งาน
เปิดใช้โฆษณาทดสอบ
ตรวจสอบว่าคุณได้ลงทะเบียนอุปกรณ์ทดสอบสำหรับ AdMob และเปิดใช้โหมดทดสอบใน UI ของ Pangle แล้ว
ยืนยันโฆษณาทดสอบ
หากต้องการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก Pangle ให้เปิดใช้การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียวในเครื่องมือตรวจสอบโฆษณาโดยใช้แหล่งที่มาของโฆษณา Pangle (การเสนอราคา) และ Pangle (การแสดงวิดีโอตามลำดับขั้น)
รหัสข้อผิดพลาด
หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก 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 |
บันทึกการเปลี่ยนแปลงของปลั๊กอินสื่อกลาง Unity ของ Pangle
เวอร์ชัน 4.4.1
- รองรับ Pangle Android Adapter เวอร์ชัน 6.3.0.4.0
- รองรับอะแดปเตอร์ Pangle สำหรับ iOS เวอร์ชัน 6.3.0.8.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 9.3.0
เวอร์ชัน 4.4.0
- รองรับอะแดปเตอร์ Pangle สำหรับ Android เวอร์ชัน 6.3.0.2.0
- รองรับ Pangle iOS adapter เวอร์ชัน 6.3.0.6.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 9.3.0
เวอร์ชัน 4.3.3
- รองรับอะแดปเตอร์ Pangle สำหรับ Android เวอร์ชัน 6.2.0.7.0
- รองรับอะแดปเตอร์ Pangle สำหรับ iOS เวอร์ชัน 6.2.0.9.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 9.2.1
เวอร์ชัน 4.3.2
- รองรับ Pangle Android Adapter เวอร์ชัน 6.2.0.6.0
- รองรับอะแดปเตอร์ Pangle สำหรับ iOS เวอร์ชัน 6.2.0.8.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 9.2.0
เวอร์ชัน 4.3.1
- รองรับอะแดปเตอร์ Pangle สำหรับ Android เวอร์ชัน 6.2.0.5.0
- รองรับอะแดปเตอร์ Pangle สำหรับ iOS เวอร์ชัน 6.2.0.7.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 9.2.0
เวอร์ชัน 4.3.0
- รองรับ Pangle Android Adapter เวอร์ชัน 6.2.0.4.0
- รองรับอะแดปเตอร์ Pangle สำหรับ iOS เวอร์ชัน 6.2.0.5.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 9.2.0
เวอร์ชัน 4.2.1
- รองรับ Pangle Android Adapter เวอร์ชัน 6.1.0.7.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 6.1.0.6.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 9.2.0
เวอร์ชัน 4.2.0
- เปลี่ยนชื่อ
DummyClientเป็นPlaceholderClientแล้ว - รองรับอะแดปเตอร์ Pangle สำหรับ Android เวอร์ชัน 6.1.0.6.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 6.1.0.5.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 9.2.0
เวอร์ชัน 4.1.0
- รองรับ Pangle Android Adapter เวอร์ชัน 6.0.0.8.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 6.1.0.5.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 9.1.1
เวอร์ชัน 4.0.1
- รองรับ Pangle Android Adapter เวอร์ชัน 6.0.0.5.0
- รองรับอะแดปเตอร์ Pangle สำหรับ iOS เวอร์ชัน 6.0.0.6.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 9.1.0
เวอร์ชัน 4.0.0
- รองรับ Pangle Android Adapter เวอร์ชัน 6.0.0.5.0
- รองรับอะแดปเตอร์ Pangle สำหรับ iOS เวอร์ชัน 6.0.0.5.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 9.1.0
เวอร์ชัน 3.0.0
- รองรับอะแดปเตอร์ Pangle สำหรับ Android เวอร์ชัน 6.0.0.3.0
- รองรับอะแดปเตอร์ Pangle สำหรับ iOS เวอร์ชัน 5.9.0.9.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 9.1.0
เวอร์ชัน 2.8.1
- รองรับอะแดปเตอร์ Pangle สำหรับ Android เวอร์ชัน 5.9.0.6.0
- รองรับอะแดปเตอร์ Pangle สำหรับ iOS เวอร์ชัน 5.9.0.8.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 9.1.0
เวอร์ชัน 2.8.0
- รองรับอะแดปเตอร์ Pangle สำหรับ Android เวอร์ชัน 5.9.0.4.0
- รองรับอะแดปเตอร์ Pangle สำหรับ iOS เวอร์ชัน 5.9.0.7.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 9.1.0
เวอร์ชัน 2.7.0
- รองรับอะแดปเตอร์ Pangle สำหรับ Android เวอร์ชัน 5.9.0.2.0
- รองรับอะแดปเตอร์ Pangle สำหรับ iOS เวอร์ชัน 5.8.0.8.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 9.1.0
เวอร์ชัน 2.6.0
- รองรับ Pangle Android Adapter เวอร์ชัน 5.8.0.9.0
- รองรับอะแดปเตอร์ Pangle สำหรับ iOS เวอร์ชัน 5.8.0.8.0
- สร้างขึ้นและทดสอบด้วยปลั๊กอิน Google Mobile Ads Unity เวอร์ชัน 9.0.0
เวอร์ชัน 2.5.0
- รองรับอะแดปเตอร์ Pangle สำหรับ Android เวอร์ชัน 5.7.0.1.0
- รองรับอะแดปเตอร์ Pangle สำหรับ iOS เวอร์ชัน 5.7.0.7.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 8.6.0
เวอร์ชัน 2.4.0
- รองรับ Pangle Android Adapter เวอร์ชัน 5.5.0.9.0
- รองรับอะแดปเตอร์ Pangle สำหรับ iOS เวอร์ชัน 5.5.0.9.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 8.6.0
เวอร์ชัน 2.3.0
- รองรับอะแดปเตอร์ Pangle สำหรับ Android เวอร์ชัน 5.3.0.6.0
- รองรับอะแดปเตอร์ Pangle สำหรับ iOS เวอร์ชัน 5.3.1.2.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 8.4.1
เวอร์ชัน 2.2.0
- รองรับอะแดปเตอร์ Pangle สำหรับ Android เวอร์ชัน 5.2.0.6.0
- รองรับอะแดปเตอร์ Pangle สำหรับ iOS เวอร์ชัน 5.2.0.9.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 8.3.0
เวอร์ชัน 2.1.0
- รองรับอะแดปเตอร์ Pangle สำหรับ Android เวอร์ชัน 5.1.0.9.0
- รองรับอะแดปเตอร์ Pangle สำหรับ iOS เวอร์ชัน 5.1.1.0.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 8.1.0
เวอร์ชัน 2.0.0
- ย้ายเนื้อหาอะแดปเตอร์ไปยัง
GoogleMobileAds/Mediation/Pangle/แล้ว - ปรับโครงสร้างเนมสเปซอะแดปเตอร์ให้ใช้
GoogleMobileAds.Mediation.Pangle - รองรับอะแดปเตอร์ Pangle สำหรับ Android เวอร์ชัน 5.0.0.7.0
- รองรับอะแดปเตอร์ Pangle สำหรับ iOS เวอร์ชัน 5.0.0.6.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 7.4.1
เวอร์ชัน 1.5.1
- รองรับ Pangle Android Adapter เวอร์ชัน 4.9.0.7.0
- รองรับอะแดปเตอร์ Pangle สำหรับ iOS เวอร์ชัน 4.9.0.8.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 7.4.0
เวอร์ชัน 1.5.0
- รองรับอะแดปเตอร์ Pangle สำหรับ Android เวอร์ชัน 4.9.0.6.0
- รองรับอะแดปเตอร์ Pangle สำหรับ iOS เวอร์ชัน 4.9.0.7.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 7.3.1
เวอร์ชัน 1.4.0
- รองรับอะแดปเตอร์ Pangle สำหรับ Android เวอร์ชัน 4.8.1.0.0
- รองรับอะแดปเตอร์ Pangle สำหรับ iOS เวอร์ชัน 4.8.1.0.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 7.3.1
เวอร์ชัน 1.3.1
- รองรับ Pangle Android Adapter เวอร์ชัน 4.7.0.6.0
- รองรับอะแดปเตอร์ Pangle สำหรับ iOS เวอร์ชัน 4.7.0.6.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 7.2.0
เวอร์ชัน 1.3.0
- เปลี่ยนชื่อเมธอดต่อไปนี้ในคลาส
PangleSetGDPR()->SetGDPRConsent()SetCCPA()->SetDoNotSell()
- รองรับอะแดปเตอร์ Pangle สำหรับ Android เวอร์ชัน 4.7.0.5.0
- รองรับอะแดปเตอร์ Pangle สำหรับ iOS เวอร์ชัน 4.7.0.5.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 7.2.0
เวอร์ชัน 1.2.0
- รองรับอะแดปเตอร์ Pangle สำหรับ Android เวอร์ชัน 4.5.0.6.1
- รองรับอะแดปเตอร์ Pangle สำหรับ iOS เวอร์ชัน 4.5.2.8.0
- สร้างขึ้นและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 7.1.0
เวอร์ชัน 1.1.0
- รองรับ Pangle Android Adapter เวอร์ชัน 4.5.0.3.0
- รองรับอะแดปเตอร์ Pangle สำหรับ iOS เวอร์ชัน 4.5.1.3.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 7.0.2
เวอร์ชัน 1.0.0
- การเผยแพร่ครั้งแรก
- รองรับอะแดปเตอร์ Pangle สำหรับ Android เวอร์ชัน 4.3.0.8.0
- รองรับอะแดปเตอร์ Pangle สำหรับ iOS เวอร์ชัน 4.3.0.5.0
- สร้างขึ้นและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 7.0.0