คู่มือนี้แสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดง โฆษณาจาก Pangle โดยใช้สื่อกลาง ครอบคลุม ทั้ง Waterfall และการเสนอราคา ซึ่งครอบคลุมถึงวิธีการ เพิ่ม Pangle ในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม Pangle SDK และอะแดปเตอร์ลงใน Unity แอป
การผสานรวมและรูปแบบโฆษณาที่รองรับ
AdMob อะแดปเตอร์สื่อกลางสำหรับ Pangle มี ความสามารถต่อไปนี้
การผสานรวม | |
---|---|
การเสนอราคา | |
น้ำตก | |
รูปแบบ | |
แบนเนอร์ | |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว | |
โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล |
ข้อกำหนด
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุด
- Unity 5.6 ขึ้นไป
- เพื่อทำให้ใช้งานได้ใน Android
- API ของ Android ระดับ 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 สำหรับ Pangle เวอร์ชันล่าสุด
จากลิงก์ดาวน์โหลดในบันทึกการเปลี่ยนแปลง
และแตกไฟล์ GoogleMobileAdsPangleMediation.unitypackage
ออกจากไฟล์ ZIP
ในเครื่องมือแก้ไขโปรเจ็กต์ Unity ให้เลือกเนื้อหา > นำเข้าแพ็กเกจ > กำหนดเอง
แพ็กเกจแล้วค้นหา GoogleMobileAdsPangleMediation.unitypackage
ที่คุณดาวน์โหลดไว้ ตรวจสอบว่าได้เลือกไฟล์ทั้งหมดแล้ว และคลิก
นำเข้า
จากนั้นเลือกชิ้นงาน > ตัวแก้ไขบริการ Google Play > รีโซลเวอร์ Android >
บังคับให้แก้ไข ไลบรารีตัวแปลค่าบริการ Unity Play จะทำงาน
การแก้ไขทรัพยากร 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
เวอร์ชัน 4.2.1
- รองรับอะแดปเตอร์ Android ของ Pangle เวอร์ชัน 6.1.0.7.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 6.1.0.6.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.2.0
เวอร์ชัน 4.2.0
- เปลี่ยนชื่อ
DummyClient
เป็นPlaceholderClient
แล้ว - รองรับอะแดปเตอร์ Android ของ Pangle เวอร์ชัน 6.1.0.6.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 6.1.0.5.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.2.0
เวอร์ชัน 4.1.0
- รองรับอะแดปเตอร์ Android ของ Pangle เวอร์ชัน 6.0.0.8.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 6.1.0.5.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.1.1
เวอร์ชัน 4.0.1
- รองรับอะแดปเตอร์ Android ของ Pangle เวอร์ชัน 6.0.0.5.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 6.0.0.6.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.1.0
เวอร์ชัน 4.0.0
- รองรับอะแดปเตอร์ Android ของ Pangle เวอร์ชัน 6.0.0.5.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 6.0.0.5.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.1.0
เวอร์ชัน 3.0.0
- รองรับอะแดปเตอร์ Android ของ Pangle เวอร์ชัน 6.0.0.3.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 5.9.0.9.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.1.0
เวอร์ชัน 2.8.1
- รองรับอะแดปเตอร์ Android ของ Pangle เวอร์ชัน 5.9.0.6.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 5.9.0.8.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.1.0
เวอร์ชัน 2.8.0
- รองรับอะแดปเตอร์ Android ของ Pangle เวอร์ชัน 5.9.0.4.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 5.9.0.7.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.1.0
เวอร์ชัน 2.7.0
- รองรับอะแดปเตอร์ Android ของ Pangle เวอร์ชัน 5.9.0.2.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 5.8.0.8.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.1.0
เวอร์ชัน 2.6.0
- รองรับอะแดปเตอร์ Android ของ Pangle เวอร์ชัน 5.8.0.9.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 5.8.0.8.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.0.0
เวอร์ชัน 2.5.0
- รองรับอะแดปเตอร์ Android ของ Pangle เวอร์ชัน 5.7.0.1.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 5.7.0.7.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.6.0
เวอร์ชัน 2.4.0
- รองรับอะแดปเตอร์ Android ของ Pangle เวอร์ชัน 5.5.0.9.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 5.5.0.9.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.6.0
เวอร์ชัน 2.3.0
- รองรับอะแดปเตอร์ Android ของ Pangle เวอร์ชัน 5.3.0.6.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 5.3.1.2.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.4.1
เวอร์ชัน 2.2.0
- รองรับอะแดปเตอร์ Android ของ Pangle เวอร์ชัน 5.2.0.6.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 5.2.0.9.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.3.0
เวอร์ชัน 2.1.0
- รองรับอะแดปเตอร์ Android ของ Pangle เวอร์ชัน 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
- รองรับอะแดปเตอร์ Android ของ Pangle เวอร์ชัน 5.0.0.7.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 5.0.0.6.0
- สร้างและทดสอบโดยใช้ Google Mobile Ads Unity Plugin เวอร์ชัน 7.4.1
เวอร์ชัน 1.5.1
- รองรับอะแดปเตอร์ Android ของ Pangle เวอร์ชัน 4.9.0.7.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 4.9.0.8.0
- สร้างและทดสอบโดยใช้ Google Mobile Ads Unity Plugin เวอร์ชัน 7.4.0
เวอร์ชัน 1.5.0
- รองรับอะแดปเตอร์ Android ของ Pangle เวอร์ชัน 4.9.0.6.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 4.9.0.7.0
- สร้างและทดสอบโดยใช้ Google Mobile Ads Unity Plugin เวอร์ชัน 7.3.1
เวอร์ชัน 1.4.0
- รองรับอะแดปเตอร์ Android ของ Pangle เวอร์ชัน 4.8.1.0.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 4.8.1.0.0
- สร้างและทดสอบโดยใช้ Google Mobile Ads Unity Plugin เวอร์ชัน 7.3.1
เวอร์ชัน 1.3.1
- รองรับอะแดปเตอร์ Android ของ Pangle เวอร์ชัน 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()
- รองรับอะแดปเตอร์ Android ของ Pangle เวอร์ชัน 4.7.0.5.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 4.7.0.5.0
- สร้างและทดสอบโดยใช้ Google Mobile Ads Unity Plugin เวอร์ชัน 7.2.0
เวอร์ชัน 1.2.0
- รองรับอะแดปเตอร์ Android ของ Pangle เวอร์ชัน 4.5.0.6.1
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 4.5.2.8.0
- สร้างและทดสอบโดยใช้ Google Mobile Ads Unity Plugin เวอร์ชัน 7.1.0
เวอร์ชัน 1.1.0
- รองรับอะแดปเตอร์ Android ของ Pangle เวอร์ชัน 4.5.0.3.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 4.5.1.3.0
- สร้างและทดสอบโดยใช้ Google Mobile Ads Unity Plugin เวอร์ชัน 7.0.2
เวอร์ชัน 1.0.0
- การเผยแพร่ครั้งแรก
- รองรับอะแดปเตอร์ Android ของ Pangle เวอร์ชัน 4.3.0.8.0
- รองรับอะแดปเตอร์ Pangle iOS เวอร์ชัน 4.3.0.5.0
- สร้างและทดสอบโดยใช้ Google Mobile Ads Unity Plugin เวอร์ชัน 7.0.0