ผสานรวม Mintegral กับสื่อกลาง

คู่มือนี้จะแสดงวิธีใช้ Google Mobile Ads SDK เพื่อโหลดและแสดงโฆษณาจาก Mintegral โดยใช้สื่อกลาง ซึ่งครอบคลุมทั้งการผสานรวม Waterfall และการเสนอราคา ซึ่งจะอธิบายวิธีเพิ่ม Mintegral ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม SDK และอะแดปเตอร์ Mintegral ลงใน Flutter แอป

การผสานรวมและรูปแบบโฆษณาที่รองรับ

Ad Manager อะแดปเตอร์สื่อกลางสําหรับ Mintegral มีความสามารถต่อไปนี้

การผสานรวม
การเสนอราคา	^1
น้ำตก	^2
รูปแบบ
การเปิดแอป
แบนเนอร์
โฆษณาคั่นระหว่างหน้า
ได้รับรางวัลแล้ว
โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล
เนทีฟ

การผสานรวมการเสนอราคา¹อยู่ในเบต้าแบบปิด (ยกเว้นรูปแบบโฆษณาเนทีฟในเบต้าแบบเปิด)

² การผสานรวม Waterfall อยู่ในรุ่นเบต้าแบบจำกัด

ข้อกำหนด

• Google Mobile Ads SDK เวอร์ชันล่าสุด
• Flutter 3.7.0 ขึ้นไป
• วิธีติดตั้งใช้งานใน Android
  • Android API ระดับ 21 ขึ้นไป
• วิธีติดตั้งใช้งานใน iOS
  • เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
• Flutter โปรเจ็กต์ที่ทํางานได้ซึ่งกําหนดค่าด้วย Google Mobile Ads SDK ดูรายละเอียดได้ที่หัวข้อเริ่มต้นใช้งาน
• สื่อกลางเสร็จสมบูรณ์ คู่มือเริ่มต้นใช้งาน

ขั้นตอนที่ 1: ตั้งค่าการกําหนดค่าใน UI ของ Mintegral

ลงชื่อสมัครใช้หรือเข้าสู่ระบบบัญชี Mintegral

ค้นหาคีย์แอป

ไปที่แท็บการตั้งค่าแอปและจดบันทึกคีย์แอป

เพิ่มแอปพลิเคชันใหม่

จากแท็บการตั้งค่าแอป ให้คลิกปุ่มเพิ่มแอป

เลือกแพลตฟอร์มและกรอกข้อมูลที่เหลือในแบบฟอร์ม จากนั้นคลิกบันทึก

Android

iOS

จดบันทึกรหัสแอปของแอปพลิเคชัน

Android

iOS

สร้างตําแหน่งโฆษณา

เมื่อสร้างแอปพลิเคชันแล้ว ให้ไปที่แท็บตําแหน่งโฆษณาและหน่วย แล้วคลิกปุ่มเพิ่มตําแหน่งโฆษณาตามที่แสดงด้านล่างเพื่อสร้างตําแหน่งโฆษณา

Android

iOS

ป้อนชื่อตำแหน่งโฆษณาและรูปแบบโฆษณา

สำคัญ: สำหรับรูปแบบโฆษณาเนทีฟ ให้เลือกเนทีฟ (การแสดงผลที่กำหนดเอง) เป็นรูปแบบโฆษณา

การเสนอราคา

เลือกการเสนอราคาส่วนหัวเป็นประเภทการเสนอราคา กรอกข้อมูลที่เหลือในแบบฟอร์ม แล้วคลิกบันทึก

น้ำตก

เลือกแบบดั้งเดิมเป็นประเภทการเสนอราคา กรอกข้อมูลที่เหลือในแบบฟอร์มแล้วคลิกบันทึก

เมื่อสร้างตําแหน่งโฆษณาแล้ว ให้จดบันทึกรหัสตําแหน่งโฆษณา

Android

iOS

คลิกเมนูแบบเลื่อนลงหน่วยโฆษณา 1 รายการ แล้วจดรหัสหน่วยโฆษณา

Android

iOS

ค้นหาคีย์ API การรายงานของ Mintegral

การเสนอราคา

ขั้นตอนนี้ไม่จําเป็นสำหรับการผสานรวมการเสนอราคา

น้ำตก

คุณจะต้องมีคีย์ Mintegral Reporting API เพื่อตั้งค่ารหัสหน่วยโฆษณา AdMob ไปที่บัญชี > เครื่องมือ API จดSkey และ Secret ไว้

ขั้นตอนที่ 2: ตั้งค่าดีมานด์ของ Mintegral ใน Ad Manager UI

กำหนดการตั้งค่าสื่อกลางสําหรับหน่วยโฆษณา

Android

โปรดดูวิธีการที่ขั้นตอนที่ 2 ในคู่มือสำหรับ Android

iOS

ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสำหรับ iOS

เพิ่ม Mintegral ลงในรายการพาร์ทเนอร์โฆษณาตาม GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกา

ทําตามขั้นตอนในการตั้งค่า GDPR และการตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกาเพื่อเพิ่ม Mobvista/Mintegral ลงในรายชื่อพาร์ทเนอร์โฆษณา GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกาใน UI ของ AdMob

ขั้นตอนที่ 3: นําเข้า SDK และอะแดปเตอร์ Mintegral

หมายเหตุ: การผสานรวม Mintegral กับ Google Mobile Ads SDK เวอร์ชันที่เข้ากันได้ไม่สำเร็จอาจทําให้เกิดปัญหาการสร้าง

การผสานรวมผ่าน pub.dev

เพิ่ม Dependency ต่อไปนี้ด้วยMintegral SDK และอะแดปเตอร์เวอร์ชันล่าสุดในไฟล์pubspec.yamlของแพ็กเกจ

dependencies:
  gma_mediation_mintegral: ^1.0.0

การผสานรวมด้วยตนเอง

ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณา Google Mobile เวอร์ชันล่าสุดสําหรับ Mintegral แตกไฟล์ที่ดาวน์โหลดมา และเพิ่มโฟลเดอร์ปลั๊กอินที่แตกไฟล์แล้ว (และเนื้อหาในโฟลเดอร์) ลงในโปรเจ็กต์ Flutter จากนั้นอ้างอิงปลั๊กอินในไฟล์ pubspec.yaml โดยเพิ่มข้อกําหนดต่อไปนี้

dependencies:
  gma_mediation_mintegral:
    path: path/to/local/package

ขั้นตอนที่ 4: เพิ่มโค้ดที่จำเป็น

Android

ไม่จำเป็นต้องใช้โค้ดเพิ่มเติมสำหรับการผสานรวม Mintegral

iOS

การผสานรวม SKAdNetwork

ทำตามเอกสารประกอบของ Mintegral เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist ของโปรเจ็กต์

ขั้นตอนที่ 5: ทดสอบการใช้งาน

เปิดใช้โฆษณาทดสอบ

ตรวจสอบว่าคุณได้ลงทะเบียนอุปกรณ์ทดสอบสำหรับ AdMob แล้ว

หากต้องการแสดงโฆษณาทดสอบของ Mintegral สำหรับรูปแบบโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า โฆษณาที่มีการให้รางวัล และโฆษณาเนทีฟ Mintegral ขอแนะนำให้ใช้คีย์แอป รหัสแอป รหัสตําแหน่ง และรหัสหน่วยโฆษณาที่ระบุไว้ในหน้ารหัสทดสอบของ Mintegral

สำคัญ: ปิดใช้โหมดทดสอบสําหรับ AdMob และ Mintegral ก่อนเผยแพร่แอป

ยืนยันโฆษณาทดสอบ

หากต้องการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก Mintegral ให้เปิดใช้การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียวในเครื่องมือตรวจสอบโฆษณาโดยใช้แหล่งที่มาของโฆษณา Mintegral (การเสนอราคา) และ 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 Mediation Adapter

เวอร์ชันถัดไป

• สร้างและทดสอบด้วยปลั๊กอิน Flutter ของ Google Mobile Ads เวอร์ชัน 5.2.0

1.1.0

• ยืนยันความเข้ากันได้กับอะแดปเตอร์ Mintegral สำหรับ Android เวอร์ชัน 16.8.31.0
• ยืนยันความเข้ากันได้กับ Mintegral iOS Adapter เวอร์ชัน 7.7.1.0
• สร้างขึ้นและทดสอบด้วยปลั๊กอิน Flutter ของ Google Mobile Ads เวอร์ชัน 5.1.0

1.0.0

• การเผยแพร่ครั้งแรก
• ยืนยันความเข้ากันได้กับอะแดปเตอร์ Mintegral สำหรับ Android เวอร์ชัน 16.7.21.0
• ยืนยันความเข้ากันได้กับ Mintegral iOS Adapter เวอร์ชัน 7.6.3.0
• สร้างขึ้นและทดสอบด้วยปลั๊กอิน Flutter ของ Google Mobile Ads เวอร์ชัน 5.1.0