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

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

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

AdMob อะแดปเตอร์สื่อกลางสําหรับ Pangle มีคุณสมบัติต่อไปนี้

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

ข้อกำหนด

  • Google Mobile Ads SDK เวอร์ชันล่าสุด
  • Flutter 3.7.0 ขึ้นไป
  • [สําหรับการเสนอราคา]: หากต้องการผสานรวมรูปแบบโฆษณาที่รองรับทั้งหมดในการเสนอราคา ให้ใช้ปลั๊กอินสื่อกลาง Google Ads สําหรับ Pangle 2.4.0 ขึ้นไป (แนะนําให้ใช้เวอร์ชันล่าสุด)
  • วิธีติดตั้งใช้งานใน Android
    • Android API ระดับ 21 ขึ้นไป
  • วิธีติดตั้งใช้งานใน iOS
    • เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
  • Flutter โปรเจ็กต์ที่ทํางานได้ซึ่งกําหนดค่าด้วย 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

ขั้นตอนที่ 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

บันทึกการเปลี่ยนแปลงของ Pangle Flutter Mediation Adapter

เวอร์ชันถัดไป

  • สร้างและทดสอบด้วยปลั๊กอิน Flutter ของ Google Mobile Ads เวอร์ชัน 5.2.0

2.0.0

  • ยืนยันความเข้ากันได้กับอะแดปเตอร์ Pangle Android เวอร์ชัน 6.1.0.9.0
  • ยืนยันความเข้ากันได้กับ Pangle iOS Adapter เวอร์ชัน 6.2.0.5.0
  • สร้างขึ้นและทดสอบด้วยปลั๊กอิน Flutter ของ Google Mobile Ads เวอร์ชัน 5.1.0

1.1.0

  • ยืนยันความเข้ากันได้กับอะแดปเตอร์ Pangle Android เวอร์ชัน 5.9.0.4.0
  • ยืนยันความเข้ากันได้กับอะแดปเตอร์ Pangle iOS เวอร์ชัน 5.9.0.7.0
  • สร้างขึ้นและทดสอบด้วยปลั๊กอิน Flutter ของ Google Mobile Ads เวอร์ชัน 5.1.0

1.0.0

  • การเผยแพร่ครั้งแรก
  • ยืนยันความเข้ากันได้กับอะแดปเตอร์ Pangle Android เวอร์ชัน 5.8.0.9.0
  • ยืนยันความเข้ากันได้กับอะแดปเตอร์ Pangle iOS เวอร์ชัน 5.8.0.8.0
  • สร้างและทดสอบด้วยปลั๊กอิน Flutter ของ Google Mobile Ads เวอร์ชัน 5.0.0