คู่มือนี้จะแสดงวิธีใช้ Google Mobile Ads SDK เพื่อโหลดและแสดงโฆษณาจาก Moloco โดยใช้สื่อกลาง ซึ่งครอบคลุมการผสานรวมการเสนอราคา โดยจะครอบคลุมวิธีเพิ่ม Moloco ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม Moloco SDK และอะแดปเตอร์เข้ากับแอป Flutter
การผสานรวมและรูปแบบโฆษณาที่รองรับ
อแดปเตอร์สื่อกลาง AdMob สำหรับ Moloco มีความสามารถต่อไปนี้
| การผสานรวม | |
|---|---|
| การเสนอราคา | |
| น้ำตก | |
| รูปแบบ | |
| การเปิดแอป | |
| แบนเนอร์ | |
| โฆษณาคั่นระหว่างหน้า | |
| ได้รับรางวัลแล้ว | |
| โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล | |
| เนทีฟ | |
ข้อกำหนด
- Google Mobile Ads SDK เวอร์ชันล่าสุด
- Flutter 3.7.0 ขึ้นไป
- หากต้องการติดตั้งใช้งานใน Android
- API ระดับ 23 ขึ้นไป ของ Android
- หากต้องการติดตั้งใช้งานใน iOS
- เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
- โปรเจ็กต์ Flutter ที่ใช้งานได้ซึ่งกำหนดค่าด้วย Google Mobile Ads SDK ดูรายละเอียดได้ที่เริ่มต้นใช้งาน
- ทําตามคู่มือเริ่มต้นใช้งานสื่อกลางให้เสร็จสมบูรณ์
ขั้นตอนที่ 1: ตั้งค่าการกำหนดค่าใน UI ของ Moloco
เข้าสู่ระบบพอร์ทัลผู้เผยแพร่โฆษณาของ Moloco
ไปที่แท็บภาพรวม > แอป แล้วคลิกปุ่มเพิ่มแอปเพื่อ สร้างแอปใหม่
เลือกการตั้งค่าระบบปฏิบัติการและการตั้งค่าความเป็นส่วนตัวสำหรับแอป กรอกข้อมูลที่เหลือใน แบบฟอร์ม แล้วคลิกสร้าง
Android
iOS
เมื่อสร้างแอปแล้ว ให้เลือกแอปจากแท็บแอปเพื่อดูรายละเอียด และจดคีย์แอปไว้
Android
iOS
ไปที่แท็บภาพรวม > หน่วยโฆษณา เลือกแอปจากเมนูแบบเลื่อนลง แล้วคลิกหน่วยโฆษณาใหม่
เลือกการเสนอราคาในแอปเป็นวิธีการประมูล แล้วกรอกข้อมูลที่เหลือใน แบบฟอร์ม จากนั้นคลิกสร้าง
ไปที่หน่วยโฆษณาที่สร้างขึ้นใหม่ในแท็บหน่วยโฆษณาเพื่อดูรายละเอียด จดรหัสหน่วยโฆษณา
ขั้นตอนที่ 2: ตั้งค่าดีมานด์ของ Moloco ใน UI ของ AdMob
กำหนดค่าการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา
Android
ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคำแนะนำสำหรับ Android
iOS
ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคำแนะนำสำหรับ iOS
เพิ่ม Moloco Ads ลงในรายการพาร์ทเนอร์โฆษณา GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกา
ทําตามขั้นตอนใน การตั้งค่ากฎระเบียบของยุโรป และ การตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกา เพื่อเพิ่ม Moloco Ads ลงใน รายชื่อพาร์ทเนอร์โฆษณาตามกฎระเบียบของยุโรปและรัฐในสหรัฐอเมริกาใน UI ของ AdMob
ขั้นตอนที่ 3: นำเข้า SDK และอะแดปเตอร์ของ Moloco
การผสานรวมผ่าน pub.dev
เพิ่มทรัพยากร Dependency ต่อไปนี้พร้อมกับ SDK และอะแดปเตอร์ Moloco Ads SDK เวอร์ชันล่าสุดในไฟล์ pubspec.yaml ของแพ็กเกจ
dependencies:
gma_mediation_moloco: ^
การผสานรวมด้วยตนเอง
ดาวน์โหลดปลั๊กอินสื่อกลางของ Google Mobile Ads เวอร์ชันล่าสุดสำหรับ
Moloco Ads SDK
แตกไฟล์ที่ดาวน์โหลด แล้วเพิ่มโฟลเดอร์ปลั๊กอินที่แตกออกมา
(และเนื้อหาของโฟลเดอร์) ลงในโปรเจ็กต์ Flutter จากนั้นอ้างอิงปลั๊กอินในไฟล์
pubspec.yaml โดยเพิ่มทรัพยากร Dependency ต่อไปนี้
dependencies:
gma_mediation_moloco:
path: path/to/local/package
ขั้นตอนที่ 4: เพิ่มโค้ดที่จำเป็น
ไม่จำเป็นต้องใช้โค้ดเพิ่มเติมสำหรับการผสานรวม Moloco
ขั้นตอนที่ 5: ทดสอบการติดตั้งใช้งาน
เปิดใช้โฆษณาทดสอบ
ตรวจสอบว่าคุณได้ ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ AdMob แล้ว
ยืนยันโฆษณาทดสอบ
หากต้องการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก Moloco Ads SDK ให้เปิดใช้การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้แหล่งที่มาของโฆษณา Moloco (การเสนอราคา)
รหัสข้อผิดพลาด
หากอแดปเตอร์ไม่ได้รับโฆษณาจาก Moloco ผู้เผยแพร่โฆษณาสามารถตรวจสอบ
ข้อผิดพลาดพื้นฐานจากคำตอบของโฆษณาได้โดยใช้
ResponseInfo ในคลาสต่อไปนี้
Android
com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter
iOS
MolocoSDK.MolocoError
GADMediationAdapterMoloco
ต่อไปนี้คือรหัสและข้อความที่มาพร้อมกันซึ่งอแดปเตอร์ Moloco แสดง เมื่อโหลดโฆษณาไม่สำเร็จ
Android
| รหัสข้อผิดพลาด | โดเมน | เหตุผล |
|---|---|---|
| 101 | com.google.ads.mediation.moloco | ไม่มีคีย์แอป Moloco หรือคีย์แอป Moloco ไม่ถูกต้อง |
| 102 | com.google.ads.mediation.moloco | ไม่มีรหัสหน่วยโฆษณา Moloco หรือรหัสไม่ถูกต้อง |
| 103 | com.google.ads.mediation.moloco | ออบเจ็กต์โฆษณา Moloco ที่แสดงผลเป็น Null |
| -1 ถึง 5000 | com.moloco.sdk | SDK ของ Moloco แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบของ Moloco |
iOS
| รหัสข้อผิดพลาด | โดเมน | เหตุผล |
|---|---|---|
| 101 | com.google.ads.mediation.moloco | SDK ของ Moloco ไม่รองรับการแสดงโฆษณาใน iOS 12 และเวอร์ชันที่ต่ำกว่า |
| 102 | com.google.ads.mediation.moloco | ไม่มีคีย์แอป Moloco หรือคีย์แอป Moloco ไม่ถูกต้อง |
| 103 | com.google.ads.mediation.moloco | ไม่มีรหัสหน่วยโฆษณา Moloco หรือรหัสไม่ถูกต้อง |
| 104 | com.google.ads.mediation.moloco | โฆษณายังไม่พร้อมแสดง |
| 105 | com.google.ads.mediation.moloco | โฆษณาแสดงไม่สำเร็จ |
| 106 | com.google.ads.mediation.moloco | ไม่มีข้อมูลการแสดงผลที่จะแสดงโฆษณา |
| -1 ถึง 5000 | ส่งโดย Moloco SDK | SDK ของ Moloco แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบของ Moloco |
การยืนยันฝั่งเซิร์ฟเวอร์สำหรับโฆษณาที่มีการให้รางวัล
หากคุณตรวจสอบการเรียกกลับของการยืนยันฝั่งเซิร์ฟเวอร์ (SSV)
ตัวระบุแหล่งที่มาของโฆษณาสำหรับ Moloco คือ 8267622065755668722
บันทึกการเปลี่ยนแปลงของ Moloco Flutter Mediation Adapter
เวอร์ชัน 1.6.1 (อยู่ระหว่างดำเนินการ)
เวอร์ชัน 1.6.0
- รองรับอะแดปเตอร์ Android ของ Moloco เวอร์ชัน 3.12.0.0
- รองรับอะแดปเตอร์ Moloco iOS เวอร์ชัน 3.12.0.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับโฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 6.0.0
เวอร์ชัน 1.5.0
- รองรับอะแดปเตอร์ Android ของ Moloco เวอร์ชัน 3.11.0.0
- รองรับอแดปเตอร์ Moloco iOS เวอร์ชัน 3.11.0.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับโฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 6.0.0
เวอร์ชัน 1.4.0
- รองรับอแดปเตอร์ Android ของ Moloco เวอร์ชัน 3.10.0.0
- รองรับอแดปเตอร์ Moloco iOS เวอร์ชัน 3.10.0.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับโฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 6.0.0
เวอร์ชัน 1.3.1
- รองรับอะแดปเตอร์ Android ของ Moloco เวอร์ชัน 3.9.0.0
- รองรับอแดปเตอร์ Moloco iOS เวอร์ชัน 3.9.1.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับโฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 6.0.0
เวอร์ชัน 1.3.0
- รองรับอะแดปเตอร์ Android ของ Moloco เวอร์ชัน 3.9.0.0
- รองรับอแดปเตอร์ Moloco iOS เวอร์ชัน 3.9.0.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับโฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 6.0.0
เวอร์ชัน 1.2.0
- รองรับอะแดปเตอร์ Android ของ Moloco เวอร์ชัน 3.8.0.1
- รองรับอะแดปเตอร์ Moloco iOS เวอร์ชัน 3.8.0.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับโฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 6.0.0
เวอร์ชัน 1.1.0
- รองรับอะแดปเตอร์ Android ของ Moloco เวอร์ชัน 3.7.0.0
- รองรับอะแดปเตอร์ Moloco iOS เวอร์ชัน 3.6.0.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับโฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 5.3.1
เวอร์ชัน 1.0.0
- รุ่นแรก
- รองรับอะแดปเตอร์ Android ของ Moloco เวอร์ชัน 3.6.1.0
- รองรับอะแดปเตอร์ Moloco iOS เวอร์ชัน 3.6.0.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับโฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 5.3.1