คู่มือนี้จะแสดงวิธีใช้ 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 (อยู่ระหว่างดำเนินการ)
เวอร์ชัน 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
- รองรับอแดปเตอร์ iOS ของ Moloco เวอร์ชัน 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