ผสานรวม Pangle กับสื่อกลาง

คู่มือนี้แสดงวิธีใช้ 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

เวอร์ชัน 2.6.0

เวอร์ชัน 2.5.0

เวอร์ชัน 2.4.0

เวอร์ชัน 2.3.0

เวอร์ชัน 2.2.0

เวอร์ชัน 2.1.0

เวอร์ชัน 2.0.0

เวอร์ชัน 1.5.1

เวอร์ชัน 1.5.0

เวอร์ชัน 1.4.0

เวอร์ชัน 1.3.1

เวอร์ชัน 1.3.0

เวอร์ชัน 1.2.0

เวอร์ชัน 1.1.0

เวอร์ชัน 1.0.0