คู่มือนี้แสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดงโฆษณาจาก Pangle โดยใช้สื่อกลาง ที่ครอบคลุม ทั้ง Waterfall และการเสนอราคา การเสนอราคา โดยจะครอบคลุมวิธีการเพิ่ม Pangle ในการกำหนดค่าสื่อกลางของหน่วยโฆษณาและวิธีผสานรวม Pangle SDK และอะแดปเตอร์เข้ากับแอป Unity
การผสานรวมที่รองรับและรูปแบบโฆษณา
AdMob อะแดปเตอร์สื่อกลางสำหรับ Pangle มีความสามารถดังต่อไปนี้
การผสานรวม | |
---|---|
การเสนอราคา | |
น้ำตก | |
รูปแบบ | |
แบนเนอร์ | |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว | |
โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล |
ข้อกำหนด
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุด
- Unity 5.6 ขึ้นไป
- เพื่อทำให้ใช้งานได้ใน Android
- Android API ระดับ 21 ขึ้นไป
- เพื่อทำให้ใช้งานได้ใน iOS
- เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
- โปรเจ็กต์ Unity ที่ใช้งานได้ซึ่งกำหนดค่าด้วย SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google โปรดดูรายละเอียดในเริ่มต้นใช้งาน
- ทำตามคู่มือเริ่มต้นใช้งานสื่อกลาง
ขั้นตอนที่ 1: ตั้งค่าการกำหนดค่าใน 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
ขั้นตอนที่ 2: ตั้งค่า Pangle ใน AdMob UI
กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา
Android
ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสําหรับ Android
iOS
โปรดดูวิธีการในขั้นตอนที่ 2 ในคู่มือสำหรับ iOS
ขั้นตอนที่ 3: นำเข้า Pangle SDK และอะแดปเตอร์
ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณา Google Mobile เวอร์ชันล่าสุดสำหรับ Pangle จากลิงก์ดาวน์โหลดในบันทึกการเปลี่ยนแปลงและดึงข้อมูล GoogleMobileAdsPangleMediation.unitypackage
จากไฟล์ ZIP
ในเครื่องมือแก้ไขโปรเจ็กต์ Unity ให้เลือกเนื้อหา > นำเข้าแพ็กเกจ > แพ็กเกจที่กำหนดเอง แล้วค้นหาไฟล์ GoogleMobileAdsPangleMediation.unitypackage
ที่คุณดาวน์โหลด ตรวจสอบว่าได้เลือกไฟล์ทั้งหมดแล้ว และคลิกนำเข้า
จากนั้นเลือกเนื้อหา > ตัวแก้ไขบริการ Google Play > ตัวแก้ไข Android > บังคับให้แก้ไข ไลบรารีของตัวแปลค่าบริการ Google Play ของ Unity จะดำเนินการแก้ปัญหา Dependency ตั้งแต่ต้นและคัดลอกทรัพยากร Dependency ที่ประกาศไว้ในไดเรกทอรี Assets/Plugins/Android
ของแอป Unity
ขั้นตอนที่ 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 |
บันทึกการเปลี่ยนแปลงปลั๊กอินของ Pangle Unity Mediation
เวอร์ชัน 2.7.0
- รองรับอะแดปเตอร์ Pangle Android เวอร์ชัน 5.9.0.2.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 5.8.0.8.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.1.0
เวอร์ชัน 2.6.0
- รองรับอะแดปเตอร์ Pangle Android เวอร์ชัน 5.8.0.9.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 5.8.0.8.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.0.0
เวอร์ชัน 2.5.0
- รองรับอะแดปเตอร์ Pangle Android เวอร์ชัน 5.7.0.1.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 5.7.0.7.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.6.0
เวอร์ชัน 2.4.0
- รองรับอะแดปเตอร์ Pangle Android เวอร์ชัน 5.5.0.9.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 5.5.0.9.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.6.0
เวอร์ชัน 2.3.0
- รองรับอะแดปเตอร์ Pangle Android เวอร์ชัน 5.3.0.6.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 5.3.1.2.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.4.1
เวอร์ชัน 2.2.0
- รองรับอะแดปเตอร์ Pangle Android เวอร์ชัน 5.2.0.6.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 5.2.0.9.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.3.0
เวอร์ชัน 2.1.0
- รองรับอะแดปเตอร์ Pangle Android เวอร์ชัน 5.1.0.9.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 5.1.1.0.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 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
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.4.1
เวอร์ชัน 1.5.1
- รองรับอะแดปเตอร์ Pangle Android เวอร์ชัน 4.9.0.7.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 4.9.0.8.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.4.0
เวอร์ชัน 1.5.0
- รองรับอะแดปเตอร์ Pangle Android เวอร์ชัน 4.9.0.6.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 4.9.0.7.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.3.1
เวอร์ชัน 1.4.0
- รองรับอะแดปเตอร์ Pangle Android เวอร์ชัน 4.8.1.0.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 4.8.1.0.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.3.1
เวอร์ชัน 1.3.1
- รองรับอะแดปเตอร์ Pangle Android เวอร์ชัน 4.7.0.6.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 4.7.0.6.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.2.0
เวอร์ชัน 1.3.0
- เปลี่ยนชื่อเมธอดต่อไปนี้ในคลาส
Pangle
SetGDPR()
->SetGDPRConsent()
SetCCPA()
->SetDoNotSell()
- รองรับอะแดปเตอร์ Pangle Android เวอร์ชัน 4.7.0.5.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 4.7.0.5.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.2.0
เวอร์ชัน 1.2.0
- รองรับอะแดปเตอร์ Pangle Android เวอร์ชัน 4.5.0.6.1
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 4.5.2.8.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.1.0
เวอร์ชัน 1.1.0
- รองรับอะแดปเตอร์ Pangle Android เวอร์ชัน 4.5.0.3.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 4.5.1.3.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.0.2
เวอร์ชัน 1.0.0
- การเผยแพร่ครั้งแรก
- รองรับอะแดปเตอร์ Pangle Android เวอร์ชัน 4.3.0.8.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 4.3.0.5.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.0.0