คู่มือนี้จะแสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดงโฆษณาจาก Mintegral โดยใช้สื่อกลาง ซึ่งครอบคลุมทั้งการผสานรวม Waterfall และการเสนอราคา โดยจะครอบคลุมวิธีการเพิ่ม Mintegral ลงในการกําหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม SDK และอะแดปเตอร์ Mintegral ลงในแอป Flutter
การผสานรวมที่รองรับและรูปแบบโฆษณา
AdMob อะแดปเตอร์สื่อกลางสำหรับ Mintegral มีความสามารถดังต่อไปนี้
การผสานรวม | ||
---|---|---|
การเสนอราคา | 1 | |
น้ำตก | 2 | |
รูปแบบ | ||
การเปิดแอป | 1 2 | |
แบนเนอร์ | ||
โฆษณาคั่นระหว่างหน้า | ||
ได้รับรางวัลแล้ว | ||
โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล | ||
เนทีฟ | 1 3 |
1 การผสานรวมการเสนอราคาสำหรับรูปแบบนี้อยู่ในเวอร์ชันเบต้าแบบปิด
2 การผสานรวม Waterfall สําหรับรูปแบบนี้อยู่ในเวอร์ชันเบต้าแบบปิด
3 การผสานรวม Waterfall สําหรับรูปแบบนี้อยู่ในเวอร์ชันเบต้าแบบเปิด
ข้อกำหนด
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุด
- Flutter 3.7.0 ขึ้นไป
- เพื่อทำให้ใช้งานได้ใน Android
- Android API ระดับ 21 ขึ้นไป
- เพื่อทำให้ใช้งานได้ใน iOS
- เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
- โปรเจ็กต์ Flutter ที่ใช้งานได้ซึ่งกำหนดค่าด้วย SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ดูรายละเอียดในเริ่มต้นใช้งาน
- ทำตามสื่อกลาง คู่มือเริ่มต้นใช้งาน
ขั้นตอนที่ 1: ตั้งการกำหนดค่าใน Mintegral UI
ลงชื่อสมัครใช้หรือลงชื่อเข้าสู่ระบบบัญชี Mintegral
ค้นหาคีย์ของแอป
ไปที่แท็บการตั้งค่าแอป แล้วจดคีย์แอป
เพิ่มแอปพลิเคชันใหม่
จากแท็บการตั้งค่าแอป ให้คลิกปุ่มเพิ่มแอป
เลือกแพลตฟอร์มและกรอกข้อมูลในแบบฟอร์มส่วนที่เหลือ จากนั้นคลิกบันทึก
Android
iOS
จดรหัสแอปของแอปพลิเคชัน
Android
iOS
สร้างตำแหน่งโฆษณา
เมื่อสร้างแอปพลิเคชันแล้ว ให้ไปที่แท็บตำแหน่งและหน่วย แล้วคลิกปุ่มเพิ่มตำแหน่งดังที่แสดงด้านล่างเพื่อสร้างตำแหน่งโฆษณา
Android
iOS
ป้อนชื่อตำแหน่งและรูปแบบโฆษณา
การเสนอราคา
เลือกการเสนอราคาส่วนหัวเป็นประเภทการเสนอราคา กรอกแบบฟอร์มที่เหลือ แล้วคลิกบันทึก
น้ำตก
เลือกรูปแบบการเสนอราคาเป็นประเภทการเสนอราคา กรอกแบบฟอร์มที่เหลือ แล้วคลิกบันทึก
เมื่อสร้างตำแหน่งโฆษณาแล้ว ให้จดรหัสตำแหน่งโฆษณาไว้
Android
iOS
คลิกเมนูแบบเลื่อนลงหน่วยโฆษณา 1 หน่วย และจดรหัสหน่วยโฆษณา
Android
iOS
ค้นหาคีย์ 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
เพิ่มทรัพยากร Dependency ต่อไปนี้ด้วย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 รองรับ |
บันทึกการเปลี่ยนแปลงของอะแดปเตอร์สื่อกลาง Flutter ของ Mintegral
1.0.0
- การเผยแพร่ครั้งแรก
- ยืนยันความเข้ากันได้กับอะแดปเตอร์ Mintegral Android เวอร์ชัน 16.7.21.0
- ตรวจสอบความเข้ากันได้กับอะแดปเตอร์ Mintegral iOS เวอร์ชัน 7.6.3.0
- สร้างและทดสอบด้วยปลั๊กอิน Google Mobile Ads Flutter เวอร์ชัน 5.1.0