คู่มือนี้แสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดง โฆษณาจาก Mintegral โดยใช้สื่อกลาง ซึ่งครอบคลุมทั้งการผสานรวม Waterfall และการเสนอราคา ซึ่งครอบคลุมถึงวิธีเพิ่ม ผสานรวมเข้ากับการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม ผสานรวม SDK และอะแดปเตอร์ไว้ในแอป Flutter
การผสานรวมและรูปแบบโฆษณาที่รองรับ
AdMob อะแดปเตอร์สื่อกลางสำหรับ Mintegral มีฟังก์ชัน ความสามารถต่อไปนี้
การผสานรวม | |
---|---|
การเสนอราคา | |
น้ำตก | |
รูปแบบ | |
การเปิดแอป | 1 |
แบนเนอร์ | |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว | |
โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล | |
เนทีฟ | 2 |
1 การเสนอราคาและการแสดงโฆษณาสื่อกลางตามลำดับขั้น การผสานรวมสำหรับรูปแบบโฆษณาเปิดแอปอยู่ในรุ่นเบต้าแบบปิด
2 การเสนอราคาและการแสดงโฆษณาสื่อกลางตามลำดับขั้น ของรูปแบบโฆษณาเนทีฟรวมกันอยู่ในรุ่นเบต้าแบบเปิด
วันที่ข้อกำหนด
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุด
- Flutter 3.7.0 ขึ้นไป
- เพื่อทำให้ใช้งานได้ใน Android
- API ของ Android ระดับ 21 ขึ้นไป
- เพื่อทำให้ใช้งานได้บน iOS
- เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
- โปรเจ็กต์ที่ใช้งานอยู่ Flutter ซึ่งกำหนดค่าด้วย SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google โปรดดู เริ่มต้นใช้งานเพื่อดูรายละเอียด
- ดำเนินการสื่อกลางให้เสร็จสิ้น คู่มือเริ่มต้นใช้งาน
ขั้นตอนที่ 1: กำหนดค่าใน Mintegral UI
ลงชื่อสมัครใช้หรือลงชื่อเข้าสู่ระบบบัญชี Mintegral
ค้นหาคีย์ของแอป
ไปที่แท็บการตั้งค่าแอป แล้วจดคีย์แอป
เพิ่มแอปพลิเคชันใหม่
จากแท็บการตั้งค่าแอป ให้คลิกปุ่มเพิ่มแอป
เลือกแพลตฟอร์มและกรอกข้อมูลในแบบฟอร์มส่วนที่เหลือ จากนั้นคลิกบันทึก
Android
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/new_application_Android.png?authuser=6&hl=th)
iOS
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/new_application_iOS.png?authuser=6&hl=th)
จดรหัสแอปของแอปพลิเคชัน
Android
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/app_id_Android.png?authuser=6&hl=th)
iOS
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/app_id_iOS.png?authuser=6&hl=th)
สร้างตำแหน่งโฆษณา
เมื่อสร้างแอปพลิเคชันแล้ว ให้ไปที่แท็บตำแหน่งและหน่วย แล้วคลิกปุ่มเพิ่มตำแหน่งดังที่แสดงด้านล่างเพื่อสร้างตำแหน่งโฆษณา
Android
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/create_placement_Android.png?authuser=6&hl=th)
iOS
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/create_placement_iOS.png?authuser=6&hl=th)
ป้อนชื่อตำแหน่งและรูปแบบโฆษณา
การเสนอราคา
เลือกการเสนอราคาส่วนหัวเป็นประเภทการเสนอราคา กรอกแบบฟอร์มที่เหลือ แล้วคลิกบันทึก
น้ำตก
เลือกรูปแบบการเสนอราคาเป็นประเภทการเสนอราคา กรอกแบบฟอร์มที่เหลือ แล้วคลิกบันทึก
เมื่อสร้างตำแหน่งโฆษณาแล้ว ให้จดรหัสตำแหน่งโฆษณาไว้
Android
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/ad_placement_id_Android.png?authuser=6&hl=th)
iOS
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/ad_placement_id_iOS.png?authuser=6&hl=th)
คลิกเมนูแบบเลื่อนลงหน่วยโฆษณา 1 หน่วย และจดรหัสหน่วยโฆษณา
Android
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/add_ad_unit_id_Android.png?authuser=6&hl=th)
iOS
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/add_ad_unit_id_iOS.png?authuser=6&hl=th)
ค้นหาคีย์ Mintegral Reporting API
การเสนอราคา
ขั้นตอนนี้ไม่จำเป็นสำหรับการผสานรวมการเสนอราคา
น้ำตก
คุณจะต้องใช้คีย์ Mintegral Reporting API ในการตั้งค่าAdMob รหัสหน่วยโฆษณา ไปที่ Account > API Tools จดบันทึก Skey และ Secret ของคุณ
ขั้นตอนที่ 2: ตั้งค่าความต้องการ Mintegral ใน AdMob UI
กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา
Android
ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสําหรับ Android
iOS
โปรดดูวิธีการในขั้นตอนที่ 2 ในคู่มือสำหรับ iOS
เพิ่ม Mintegral ลงในรายชื่อพาร์ทเนอร์โฆษณาตาม GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกา
ทำตามขั้นตอนใน การตั้งค่า GDPR และ การตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกา เพื่อเพิ่ม Mintegral ลงในรายชื่อพาร์ทเนอร์โฆษณาตามกฎระเบียบ GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกาใน AdMob
ขั้นตอนที่ 3: นำเข้า Mintegral SDK และอะแดปเตอร์
การผสานรวมผ่าน pub.dev
เพิ่มการอ้างอิงต่อไปนี้ด้วยเวอร์ชันล่าสุดของ
Mintegral SDK และอะแดปเตอร์ในแพ็กเกจ
ไฟล์ pubspec.yaml
:
dependencies:
gma_mediation_mintegral: ^1.0.0
การผสานรวมด้วยตนเอง
ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุดสำหรับ
Mintegral
แยกไฟล์ที่ดาวน์โหลด และเพิ่มโฟลเดอร์ปลั๊กอินที่ดึงมา
(และเนื้อหาภายใน) ลงในโปรเจ็กต์ Flutter ของคุณ จากนั้นให้อ้างอิงปลั๊กอินใน
pubspec.yaml
ด้วยการเพิ่มทรัพยากร Dependency ต่อไปนี้
dependencies:
gma_mediation_mintegral:
path: path/to/local/package
ขั้นตอนที่ 4: เพิ่มโค้ดที่จําเป็น
Android
ไม่ต้องใช้โค้ดเพิ่มเติมสำหรับการผสานรวม Mintegral
iOS
การผสานรวม SKAdNetwork
ทำตามเอกสารประกอบของ Mintegral
เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist
ของโปรเจ็กต์
ขั้นตอนที่ 5: ทดสอบการใช้งาน
เปิดใช้โฆษณาทดสอบ
อย่าลืม ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ AdMob
หากต้องการใช้โฆษณาทดสอบของ Mintegral สำหรับโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า รูปแบบโฆษณาที่มีการให้รางวัล และโฆษณาเนทีฟ ทาง Mintegral แนะนำให้ใช้คีย์แอป รหัสแอป รหัสตำแหน่งโฆษณา และรหัสหน่วยโฆษณาที่ให้ไว้ในหน้ารหัสการทดสอบของ Mintegral หน้ารหัสการทดสอบ Mintegral
ยืนยันโฆษณาทดสอบ
ในการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก Mintegral ให้เปิดใช้ การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้ Mintegral (Bidding) and Mintegral (Waterfall) แหล่งที่มาของโฆษณา
รหัสข้อผิดพลาด
หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก Mintegral ผู้เผยแพร่โฆษณาสามารถตรวจสอบ
ข้อผิดพลาดสำคัญจากการตอบกลับโฆษณาโดยใช้
ResponseInfo
ภายใต้ชั้นเรียนต่อไปนี้
Android
com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter
iOS
GADMediationAdapterMintegral
นี่คือรหัสและข้อความประกอบที่ส่งมาจากอะแดปเตอร์ Mintegral เมื่อโฆษณาไม่โหลด
Android
รหัสข้อผิดพลาด | โดเมน | เหตุผล |
---|---|---|
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 แสดงข้อผิดพลาดการไม่มีการเติม |
iOS
รหัสข้อผิดพลาด | โดเมน | เหตุผล |
---|---|---|
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
1.0.0
- การเผยแพร่ครั้งแรก
- ยืนยันความเข้ากันได้กับอะแดปเตอร์ Android ของ Mintegral เวอร์ชัน 16.7.21.0
- ตรวจสอบความเข้ากันได้กับอะแดปเตอร์ iOS ของ Mintegral เวอร์ชัน 7.6.3.0
- สร้างและทดสอบด้วย Google Mobile Ads Flutter Plugin เวอร์ชัน 5.1.0