คู่มือนี้จะแสดงวิธีใช้ 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 Framework เวอร์ชัน 3.7.0 ขึ้นไป
- หากต้องการติดตั้งใช้งานใน Android
- Android API ระดับ 23 ขึ้นไป
- หากต้องการติดตั้งใช้งานใน 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: นำเข้า Moloco Ads SDK SDK และอะแดปเตอร์
การผสานรวมผ่าน pub.dev
เพิ่มทรัพยากร Dependency ต่อไปนี้ด้วย Moloco Ads SDK SDK และอะแดปเตอร์เวอร์ชันล่าสุดในไฟล์ pubspec.yaml ของแพ็กเกจ
dependencies:
gma_mediation_moloco: ^3.5.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 หรือรหัสหน่วยโฆษณา 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 หรือรหัสหน่วยโฆษณา 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 |
การยืนยันฝั่งเซิร์ฟเวอร์สำหรับโฆษณาที่มีการให้รางวัล
หากคุณ
ตรวจสอบการเรียกกลับการยืนยันฝั่งเซิร์ฟเวอร์ (SSV),
ตัวระบุแหล่งที่มาของโฆษณาสำหรับ Moloco คือ 8267622065755668722
บันทึกการเปลี่ยนแปลงของอะแดปเตอร์สื่อกลาง Moloco Flutter
เวอร์ชัน 3.5.1 (อยู่ระหว่างดำเนินการ)
เวอร์ชัน 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 เวอร์ชัน 4.7.0.0
- รองรับอะแดปเตอร์ Moloco iOS เวอร์ชัน 4.5.1.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 8.0.0
เวอร์ชัน 3.3.0
- รองรับอะแดปเตอร์ Moloco Android เวอร์ชัน 4.5.0.0
- รองรับอะแดปเตอร์ Moloco iOS เวอร์ชัน 4.3.0.2
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 7.0.0
เวอร์ชัน 3.2.0
- รองรับอะแดปเตอร์ Moloco Android เวอร์ชัน 4.4.0.0
- รองรับอะแดปเตอร์ Moloco iOS เวอร์ชัน 4.2.0.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 7.0.0
เวอร์ชัน 3.1.0
- อัปเดต Flutter เวอร์ชันขั้นต่ำเป็น 3.35.1
- รองรับอะแดปเตอร์ Moloco Android เวอร์ชัน 4.4.0.0
- รองรับอะแดปเตอร์ Moloco iOS เวอร์ชัน 4.1.2.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 7.0.0
เวอร์ชัน 3.0.0
- รองรับอะแดปเตอร์ Moloco Android เวอร์ชัน 4.3.1.0
- รองรับอะแดปเตอร์ Moloco iOS เวอร์ชัน 4.1.0.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 6.0.0
เวอร์ชัน 2.1.0
- รองรับอะแดปเตอร์ Moloco Android เวอร์ชัน 4.2.0.0
- รองรับอะแดปเตอร์ Moloco iOS เวอร์ชัน 3.13.0.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 6.0.0
เวอร์ชัน 2.0.0
- รองรับอะแดปเตอร์ Moloco Android เวอร์ชัน 4.0.0.0
- รองรับอะแดปเตอร์ Moloco iOS เวอร์ชัน 3.13.0.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 6.0.0
เวอร์ชัน 1.6.0
- รองรับอะแดปเตอร์ Moloco Android เวอร์ชัน 3.12.0.0
- รองรับอะแดปเตอร์ Moloco iOS เวอร์ชัน 3.12.0.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 6.0.0
เวอร์ชัน 1.5.0
- รองรับอะแดปเตอร์ Moloco Android เวอร์ชัน 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
- รองรับอะแดปเตอร์ Moloco Android เวอร์ชัน 3.9.0.0
- รองรับ อะแดปเตอร์ Moloco iOS เวอร์ชัน 3.9.1.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 6.0.0
เวอร์ชัน 1.3.0
- รองรับอะแดปเตอร์ Moloco Android เวอร์ชัน 3.9.0.0
- รองรับ อะแดปเตอร์ Moloco iOS เวอร์ชัน 3.9.0.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 6.0.0
เวอร์ชัน 1.2.0
- รองรับอะแดปเตอร์ Moloco Android เวอร์ชัน 3.8.0.1
- รองรับอะแดปเตอร์ Moloco iOS เวอร์ชัน 3.8.0.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 6.0.0
เวอร์ชัน 1.1.0
- รองรับอะแดปเตอร์ Moloco Android เวอร์ชัน 3.7.0.0
- รองรับอะแดปเตอร์ Moloco iOS เวอร์ชัน 3.6.0.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 5.3.1
เวอร์ชัน 1.0.0
- รุ่นแรก
- รองรับอะแดปเตอร์ Moloco Android เวอร์ชัน 3.6.1.0
- รองรับอะแดปเตอร์ Moloco iOS เวอร์ชัน 3.6.0.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 5.3.1