คู่มือนี้จะแสดงวิธีใช้ Google Mobile Ads SDK เพื่อโหลดและแสดงโฆษณาจาก Mintegral โดยใช้สื่อกลาง ซึ่งครอบคลุมทั้งการผสานรวม Waterfall และการเสนอราคา ซึ่งจะอธิบายวิธีเพิ่ม Mintegral ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม SDK และอะแดปเตอร์ Mintegral เข้ากับแอป Flutter
การผสานรวมและรูปแบบโฆษณาที่รองรับ
อะแดปเตอร์สื่อกลาง AdMob สําหรับ Mintegral มีความสามารถต่อไปนี้
| การผสานรวม | |
|---|---|
| การเสนอราคา | |
| น้ำตก | |
| รูปแบบ | |
| การเปิดแอป | |
| ป้ายประกาศ | |
| โฆษณาคั่นระหว่างหน้า | |
| ได้รับรางวัลแล้ว | |
| โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล | |
| เนทีฟ | |
ข้อกำหนด
- Google Mobile Ads SDK เวอร์ชันล่าสุด
- Flutter 3.7.0 ขึ้นไป
- [สําหรับการเสนอราคา]: หากต้องการผสานรวมรูปแบบโฆษณาที่รองรับทั้งหมดในการเสนอราคา ให้ใช้ปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google สําหรับ Mintegral 1.4.0 ขึ้นไป (แนะนําให้ใช้เวอร์ชันล่าสุด)
- วิธีติดตั้งใช้งานใน Android
- Android API ระดับ 21 ขึ้นไป
- วิธีติดตั้งใช้งานใน iOS
- เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
- โปรเจ็กต์ Flutter ที่ใช้งานได้ซึ่งกําหนดค่าด้วย Google Mobile Ads SDK ดูรายละเอียดได้ที่หัวข้อเริ่มต้นใช้งาน
- ดำเนินการสื่อกลางให้เสร็จสิ้น คู่มือเริ่มต้นใช้งาน
ขั้นตอนที่ 1: ตั้งค่าการกําหนดค่าใน UI ของ Mintegral
ลงชื่อสมัครใช้หรือเข้าสู่ระบบบัญชี Mintegral
ค้นหาคีย์แอป
ไปที่แท็บการตั้งค่าแอปและจดบันทึกคีย์แอป
เพิ่มแอปพลิเคชันใหม่
จากแท็บการตั้งค่าแอป ให้คลิกปุ่มเพิ่มแอป
เลือกแพลตฟอร์มและกรอกข้อมูลที่เหลือในแบบฟอร์ม จากนั้นคลิกบันทึก
จดบันทึกรหัสแอปของแอปพลิเคชัน
สร้างตําแหน่งโฆษณา
เมื่อสร้างแอปพลิเคชันแล้ว ให้ไปที่แท็บตําแหน่งโฆษณาและหน่วย แล้วคลิกปุ่มเพิ่มตําแหน่งโฆษณาตามที่แสดงด้านล่างเพื่อสร้างตําแหน่งโฆษณา
ป้อนชื่อตำแหน่งโฆษณาและรูปแบบโฆษณา
เลือกการเสนอราคาส่วนหัวเป็นประเภทการเสนอราคา กรอกข้อมูลที่เหลือในแบบฟอร์ม แล้วคลิกบันทึก
เลือกแบบดั้งเดิมเป็นประเภทการเสนอราคา กรอกข้อมูลที่เหลือในแบบฟอร์มแล้วคลิกบันทึก
เมื่อสร้างตําแหน่งโฆษณาแล้ว ให้จดบันทึกรหัสตําแหน่งโฆษณา
คลิกเมนูแบบเลื่อนลงหน่วยโฆษณา 1 รายการ แล้วจดรหัสหน่วยโฆษณา
ค้นหาคีย์ API การรายงานของ Mintegral
ขั้นตอนนี้ไม่จําเป็นสําหรับการผสานรวมการเสนอราคา
คุณจะต้องมีคีย์ Mintegral Reporting API เพื่อตั้งค่ารหัสหน่วยโฆษณา AdMob ไปที่บัญชี > เครื่องมือ API จดSkey และ Secret ไว้
ขั้นตอนที่ 2: ตั้งค่าดีมานด์จาก Mintegral ใน UI ของ AdMob
กำหนดการตั้งค่าสื่อกลางสําหรับหน่วยโฆษณา
โปรดดูวิธีการที่ขั้นตอนที่ 2 ในคู่มือสำหรับ Android
ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสำหรับ iOS
เพิ่ม Mobvista/Mintegral ลงในรายชื่อพาร์ทเนอร์โฆษณาตาม GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกา
ทําตามขั้นตอนในการตั้งค่ากฎระเบียบของยุโรป และการตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกาเพื่อเพิ่ม Mobvista/Mintegral ลงในรายชื่อพาร์ทเนอร์โฆษณาภายใต้กฎระเบียบของยุโรปและรัฐในสหรัฐอเมริกาใน UI ของ AdMob
ขั้นตอนที่ 3: นําเข้า SDK และอะแดปเตอร์ Mintegral
การผสานรวมผ่าน pub.dev
เพิ่ม Dependency ต่อไปนี้ด้วย Mintegral SDK และอะแดปเตอร์เวอร์ชันล่าสุดในไฟล์ pubspec.yaml ของแพ็กเกจ
dependencies:
gma_mediation_mintegral: ^
การผสานรวมด้วยตนเอง
ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณา Google Mobile เวอร์ชันล่าสุดสําหรับ Mintegral แตกไฟล์ที่ดาวน์โหลดมา และเพิ่มโฟลเดอร์ปลั๊กอินที่แตกไฟล์แล้ว (และเนื้อหาในโฟลเดอร์) ลงในโปรเจ็กต์ Flutter จากนั้นอ้างอิงปลั๊กอินในไฟล์ pubspec.yaml โดยเพิ่มข้อกําหนดต่อไปนี้
dependencies:
gma_mediation_mintegral:
path: path/to/local/package
ขั้นตอนที่ 4: เพิ่มโค้ดที่จำเป็น
ไม่จำเป็นต้องใช้โค้ดเพิ่มเติมสำหรับการผสานรวม Mintegral
การผสานรวม SKAdNetwork
ทําตามเอกสารประกอบของ Mintegral เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist ของโปรเจ็กต์
ขั้นตอนที่ 5: ทดสอบการใช้งาน
เปิดใช้โฆษณาทดสอบ
ตรวจสอบว่าคุณได้ลงทะเบียนอุปกรณ์ทดสอบสําหรับ AdMob แล้ว
หากต้องการแสดงโฆษณาทดสอบของ Mintegral สำหรับรูปแบบโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า โฆษณาที่มีการให้รางวัล และโฆษณาเนทีฟ Mintegral ขอแนะนำให้ใช้คีย์แอป รหัสแอป รหัสตําแหน่ง และรหัสหน่วยโฆษณาที่ระบุไว้ในหน้ารหัสทดสอบของ Mintegral
ยืนยันโฆษณาทดสอบ
หากต้องการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก Mintegral ให้เปิดใช้การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียวในเครื่องมือตรวจสอบโฆษณาโดยใช้แหล่งที่มาของโฆษณา Mintegral (การเสนอราคา) และ Mintegral (Waterfall)
รหัสข้อผิดพลาด
หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก Mintegral ผู้เผยแพร่โฆษณาสามารถตรวจสอบข้อผิดพลาดพื้นฐานจากการตอบกลับโฆษณาได้โดยใช้ ResponseInfo ในส่วนคลาสต่อไปนี้
com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter
GADMediationAdapterMintegral
รหัสและข้อความที่แสดงพร้อมกับข้อผิดพลาดที่อะแดปเตอร์ Mintegral แสดงเมื่อโหลดโฆษณาไม่สําเร็จมีดังนี้
| รหัสข้อผิดพลาด | โดเมน | เหตุผล |
|---|---|---|
| 101 | com.google.ads.mediation.mintegral | พารามิเตอร์เซิร์ฟเวอร์ไม่ถูกต้อง (เช่น ไม่มีรหัสแอปหรือรหัสตําแหน่ง) |
| 102 | com.google.ads.mediation.mintegral | ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ Mintegral รองรับ |
| 103 | com.google.ads.mediation.mintegral | การเสนอราคาตอบขาดหายไปหรือไม่ถูกต้อง |
| 104 | com.google.ads.mediation.mintegral | Mintegral SDK แสดงข้อผิดพลาด "ไม่มีการส่งโฆษณา" |
| รหัสข้อผิดพลาด | โดเมน | เหตุผล |
|---|---|---|
| 101 | com.google.mediation.mintegral | พารามิเตอร์เซิร์ฟเวอร์ไม่ถูกต้อง (เช่น ไม่มีรหัสแอปหรือรหัสตําแหน่ง) |
| 102 | com.google.mediation.mintegral | Mintegral SDK แสดงข้อผิดพลาด "ไม่มีการส่งโฆษณา" |
| 103 | com.google.mediation.mintegral | Mintegral SDK แสดงโฆษณาไม่สำเร็จ |
| 104 | com.google.mediation.mintegral | ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ Mintegral รองรับ |
บันทึกการเปลี่ยนแปลงของ Mintegral Flutter Mediation Adapter
1.1.0
- ตอนนี้ปลั๊กอิน iOS เป็นเฟรมเวิร์กแบบคงที่
- รองรับอะแดปเตอร์ Mintegral สำหรับ Android เวอร์ชัน 16.8.61.0
- รองรับอะแดปเตอร์ Mintegral สำหรับ iOS เวอร์ชัน 7.7.5.0
- สร้างและทดสอบด้วยปลั๊กอิน Flutter ของ Google Mobile Ads เวอร์ชัน 5.3.1
1.0.0
- การเผยแพร่ครั้งแรก
- รองรับอะแดปเตอร์ Mintegral สำหรับ Android เวอร์ชัน 16.7.21.0
- รองรับอะแดปเตอร์ Mintegral สำหรับ iOS เวอร์ชัน 7.6.3.0
- สร้างขึ้นและทดสอบด้วยปลั๊กอิน Flutter ของ Google Mobile Ads เวอร์ชัน 5.1.0