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

คู่มือนี้จะแสดงวิธีใช้ Google Mobile Ads SDK เพื่อโหลดและแสดงโฆษณาจาก Pangle โดยใช้สื่อกลาง ซึ่งครอบคลุม การเสนอราคา ตามลำดับขั้นและการเสนอราคา ซึ่งจะอธิบายวิธีเพิ่ม Pangle ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม SDK และอะแดปเตอร์ Pangle ลงใน Unity แอป

การผสานรวมและรูปแบบโฆษณาที่รองรับ

Ad Manager Mediation Adapter สําหรับ Pangle มีความสามารถต่อไปนี้

การผสานรวม
การเสนอราคา
น้ำตก  1
รูปแบบ
แบนเนอร์
โฆษณาคั่นระหว่างหน้า
ได้รับรางวัลแล้ว
โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล
1 การผสานรวม Waterfall อยู่ในรุ่นเบต้าแบบปิด

ข้อกำหนด

  • Google Mobile Ads SDK เวอร์ชันล่าสุด
  • Unity 5.6 ขึ้นไป
  • วิธีติดตั้งใช้งานใน 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 ใน Ad Manager 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

รายละเอียด OpenUPM

จากนั้นไปที่หน้าต่าง > เครื่องมือจัดการแพ็กเกจเพื่อเปิดเครื่องมือจัดการแพ็กเกจ Unity แล้วเลือกที่เก็บของฉันจากเมนูแบบเลื่อนลง

รีจิสทรี Unity

เลือกแพ็กเกจ Google Mobile Ads Pangle Mediation แล้วคลิกติดตั้ง

ติดตั้งจาก OpenUPM

แพ็กเกจ Unity

ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณา Google Mobile เวอร์ชันล่าสุดสําหรับ Pangle จากลิงก์ดาวน์โหลดในบันทึกการเปลี่ยนแปลง และแตกไฟล์ GoogleMobileAdsPangleMediation.unitypackage จากไฟล์ ZIP

ในเครื่องมือแก้ไขโปรเจ็กต์ Unity ให้เลือกเนื้อหา > นําเข้าแพ็กเกจ > แพ็กเกจที่กําหนดเอง แล้วค้นหาไฟล์ GoogleMobileAdsPangleMediation.unitypackage ที่ดาวน์โหลด ตรวจสอบว่าได้เลือกไฟล์ทั้งหมดแล้ว แล้วคลิกนําเข้า

นำเข้าจาก Unity

จากนั้นเลือกเนื้อหา > เครื่องมือจัดการทรัพยากร Dependency ภายนอก > ตัวแปลค่า 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.0

เวอร์ชัน 4.3.3

เวอร์ชัน 4.3.2

เวอร์ชัน 4.3.1

เวอร์ชัน 4.3.0

เวอร์ชัน 4.2.1

เวอร์ชัน 4.2.0

เวอร์ชัน 4.1.0

เวอร์ชัน 4.0.1

เวอร์ชัน 4.0.0

เวอร์ชัน 3.0.0

เวอร์ชัน 2.8.1

เวอร์ชัน 2.8.0

เวอร์ชัน 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