คู่มือนี้จะแสดงวิธีใช้ Google Mobile Ads Flutter Plugin เพื่อโหลดและแสดงโฆษณาจาก Moloco Ads SDK โดยใช้สื่อกลาง ซึ่งครอบคลุมการผสานรวมการเสนอราคา โดยจะครอบคลุมวิธีเพิ่ม Moloco Ads SDK ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม Moloco Ads SDK SDK และอะแดปเตอร์เข้ากับแอป Flutter
การผสานรวมและรูปแบบโฆษณาที่รองรับ
อะแดปเตอร์สื่อกลาง AdMob สำหรับ Moloco Ads SDK มีความสามารถต่อไปนี้
| การผสานรวม | |
|---|---|
| การเสนอราคา | |
| การแสดงวิดีโอตามลำดับขั้น | |
| รูปแบบ | |
| โฆษณาเปิดแอป | |
| แบนเนอร์ | |
| โฆษณาคั่นระหว่างหน้า | |
| ได้รับรางวัลแล้ว | |
| โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล | |
| เนทีฟ | |
ข้อกำหนดเบื้องต้น
ก่อนดำเนินการต่อ โปรดตรวจสอบสิ่งต่อไปนี้
- Google Mobile Ads Flutter Plugin เวอร์ชันล่าสุด
- เฟรมเวิร์ก Flutter เวอร์ชัน 3.7.0 ขึ้นไป
- หากต้องการติดตั้งใช้งานใน Android
- ระดับ API 23 ขึ้นไปของ Android
- หากต้องการติดตั้งใช้งานใน iOS
- เป้าหมายการติดตั้งใช้งาน iOS 13.0 ขึ้นไป
- โปรเจ็กต์ Flutter ที่ใช้งานได้ซึ่งกำหนดค่าด้วย Google Mobile Ads Flutter Plugin ดูรายละเอียดได้ที่ตั้งค่า Google Mobile Ads Flutter Plugin
- ตั้งค่าสื่อกลาง AdMob
ขั้นตอนที่ 1: ตั้งค่าการกำหนดค่าใน UI ของ Moloco Ads SDK
เข้าสู่ระบบพอร์ทัลผู้เผยแพร่โฆษณาของ Moloco
ไปที่แท็บภาพรวม > แอป แล้วคลิกปุ่มเพิ่มแอปเพื่อ สร้างแอปใหม่
เลือกการตั้งค่าระบบปฏิบัติการและการตั้งค่าความเป็นส่วนตัวสำหรับแอป กรอกข้อมูลในส่วนที่เหลือของ แบบฟอร์ม แล้วคลิกสร้าง
Android
iOS
เมื่อสร้างแอปแล้ว ให้เลือกแอปจากแท็บแอปเพื่อดูรายละเอียด และจดคีย์แอปไว้
Android
iOS
ไปที่แท็บภาพรวม > หน่วยโฆษณา เลือกแอปจากเมนู แบบเลื่อนลง แล้วคลิกหน่วยโฆษณาใหม่
เลือกการเสนอราคาในแอปเป็นวิธีการประมูล แล้วกรอกข้อมูลที่เหลือใน แบบฟอร์ม จากนั้นคลิกสร้าง
ไปที่หน่วยโฆษณาที่สร้างขึ้นใหม่ในแท็บหน่วยโฆษณาเพื่อดูรายละเอียด จดรหัสหน่วยโฆษณา
ขั้นตอนที่ 2: ตั้งค่าดีมานด์ Moloco Ads SDK ใน UI ของ AdMob
กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา
Android
ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคำแนะนำสำหรับ Android
iOS
ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคำแนะนำสำหรับ iOS
เพิ่ม Moloco Ads ลงในรายชื่อพาร์ทเนอร์โฆษณาตามกฎระเบียบ GDPR และกฎระเบียบระดับรัฐในสหรัฐอเมริกา
ทําตามขั้นตอนใน การตั้งค่ากฎระเบียบของยุโรป และ การตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกา เพื่อเพิ่ม Moloco Ads ลงใน รายชื่อพาร์ทเนอร์โฆษณาตามกฎระเบียบของยุโรปและรัฐในสหรัฐอเมริกาใน UI ของ AdMob
ขั้นตอนที่ 3: นำเข้า SDK และอะแดปเตอร์ของ Moloco Ads SDK
การผสานรวมผ่าน pub.dev
เพิ่มทรัพยากร Dependency ต่อไปนี้พร้อมกับ SDK และอะแดปเตอร์ Moloco Ads SDK เวอร์ชันล่าสุดในไฟล์ pubspec.yaml ของแพ็กเกจ
dependencies:
gma_mediation_moloco: ^3.7.0
การผสานรวมด้วยตนเอง
ดาวน์โหลดปลั๊กอินสื่อกลาง Google Mobile Ads สำหรับ
Moloco Ads SDK เวอร์ชันล่าสุด
แตกไฟล์ที่ดาวน์โหลดมา แล้วเพิ่มโฟลเดอร์ปลั๊กอินที่แตกออกมา
(และเนื้อหาของโฟลเดอร์) ลงในโปรเจ็กต์ Flutter จากนั้นอ้างอิงปลั๊กอินในไฟล์
pubspec.yaml โดยเพิ่มทรัพยากร Dependency ต่อไปนี้
dependencies:
gma_mediation_moloco:
path: path/to/local/package
ขั้นตอนที่ 4: เพิ่มโค้ดที่จำเป็น
ไม่จำเป็นต้องใช้โค้ดเพิ่มเติมสำหรับการผสานรวม Moloco Ads SDK
ขั้นตอนที่ 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 | Moloco SDK แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบของ Moloco |
iOS
| รหัสข้อผิดพลาด | โดเมน | เหตุผล |
|---|---|---|
| 101 | com.google.ads.mediation.moloco | Moloco SDK ไม่รองรับการแสดงโฆษณาใน 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 | Moloco SDK แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบของ Moloco |
บันทึกการเปลี่ยนแปลงของ Moloco Flutter Mediation Adapter
เวอร์ชัน 3.7.0
- รองรับอแดปเตอร์ Android ของ Moloco เวอร์ชัน 4.12.0.0
- รองรับอแดปเตอร์ Moloco iOS เวอร์ชัน 4.10.0.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 9.1.0
เวอร์ชัน 3.6.1
- อัปเดตเพื่อรองรับปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 9.1.0
- เพิ่มการรองรับ Swift Package Manager
- รองรับอะแดปเตอร์ Android ของ Moloco เวอร์ชัน 4.11.1.0
- รองรับอะแดปเตอร์ Moloco iOS เวอร์ชัน 4.9.0.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 9.1.0
เวอร์ชัน 3.6.0
- รองรับอะแดปเตอร์ Moloco Android เวอร์ชัน 4.11.0.0
- รองรับอะแดปเตอร์ Moloco iOS เวอร์ชัน 4.9.0.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 9.0.0
เวอร์ชัน 3.5.1
- รองรับอะแดปเตอร์ Moloco Android เวอร์ชัน 4.10.1.0
- รองรับอแดปเตอร์ Moloco iOS เวอร์ชัน 4.8.1.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 9.0.0
เวอร์ชัน 3.5.0
- รองรับอะแดปเตอร์ Moloco Android เวอร์ชัน 4.10.0.0
- รองรับอแดปเตอร์ Moloco iOS เวอร์ชัน 4.8.0.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 9.0.0
เวอร์ชัน 3.4.0
- อัปเดตเวอร์ชัน Flutter ขั้นต่ำเป็น 3.38.1
- อัปเดตเพื่อรองรับปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 8.0.0
- รองรับMoloco Android Adapter เวอร์ชัน 4.7.0.0
- รองรับอแดปเตอร์ Moloco iOS เวอร์ชัน 4.5.1.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 8.0.0
เวอร์ชัน 3.3.0
- รองรับอแดปเตอร์ Android ของ Moloco เวอร์ชัน 4.5.0.0
- รองรับอะแดปเตอร์ Moloco iOS เวอร์ชัน 4.3.0.2
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 7.0.0
เวอร์ชัน 3.2.0
- รองรับอะแดปเตอร์ Android ของ Moloco เวอร์ชัน 4.4.0.0
- รองรับอะแดปเตอร์ Moloco iOS เวอร์ชัน 4.2.0.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 7.0.0
เวอร์ชัน 3.1.0
- อัปเดตเวอร์ชัน Flutter ขั้นต่ำเป็น 3.35.1
- รองรับอะแดปเตอร์ Android ของ Moloco เวอร์ชัน 4.4.0.0
- รองรับอแดปเตอร์ Moloco iOS เวอร์ชัน 4.1.2.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 7.0.0
เวอร์ชัน 3.0.0
- รองรับMoloco Android Adapter เวอร์ชัน 4.3.1.0
- รองรับอะแดปเตอร์ Moloco iOS เวอร์ชัน 4.1.0.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 6.0.0
เวอร์ชัน 2.1.0
- รองรับMoloco Android Adapter เวอร์ชัน 4.2.0.0
- รองรับอะแดปเตอร์ Moloco iOS เวอร์ชัน 3.13.0.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 6.0.0
เวอร์ชัน 2.0.0
- รองรับMoloco Android Adapter เวอร์ชัน 4.0.0.0
- รองรับอะแดปเตอร์ Moloco iOS เวอร์ชัน 3.13.0.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 6.0.0
เวอร์ชัน 1.6.0
- รองรับอะแดปเตอร์ Android ของ Moloco เวอร์ชัน 3.12.0.0
- รองรับอะแดปเตอร์ Moloco iOS เวอร์ชัน 3.12.0.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 6.0.0
เวอร์ชัน 1.5.0
- รองรับอะแดปเตอร์ Android ของ Moloco เวอร์ชัน 3.11.0.0
- รองรับอะแดปเตอร์ Moloco iOS เวอร์ชัน 3.11.0.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 6.0.0
เวอร์ชัน 1.4.0
- รองรับอะแดปเตอร์ Moloco Android เวอร์ชัน 3.10.0.0
- รองรับอแดปเตอร์ Moloco iOS เวอร์ชัน 3.10.0.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 6.0.0
เวอร์ชัน 1.3.1
- รองรับอแดปเตอร์ Android ของ Moloco เวอร์ชัน 3.9.0.0
- รองรับอแดปเตอร์ Moloco iOS เวอร์ชัน 3.9.1.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 6.0.0
เวอร์ชัน 1.3.0
- รองรับอแดปเตอร์ Android ของ Moloco เวอร์ชัน 3.9.0.0
- รองรับอะแดปเตอร์ Moloco iOS เวอร์ชัน 3.9.0.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 6.0.0
เวอร์ชัน 1.2.0
- รองรับอะแดปเตอร์ Android ของ Moloco เวอร์ชัน 3.8.0.1
- รองรับอะแดปเตอร์ Moloco iOS เวอร์ชัน 3.8.0.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 6.0.0
เวอร์ชัน 1.1.0
- รองรับMoloco Android Adapter เวอร์ชัน 3.7.0.0
- รองรับอะแดปเตอร์ Moloco iOS เวอร์ชัน 3.6.0.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 5.3.1
เวอร์ชัน 1.0.0
- รุ่นแรก
- รองรับอแดปเตอร์ Android ของ Moloco เวอร์ชัน 3.6.1.0
- รองรับอะแดปเตอร์ Moloco iOS เวอร์ชัน 3.6.0.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 5.3.1