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

เลือกแพลตฟอร์ม: Android ใหม่ Android iOS Unity Flutter

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

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

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

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

ข้อกำหนด

  • ล่าสุด Google Mobile Ads Flutter Plugin
  • Flutter 3.7.0 ขึ้นไป
  • [สำหรับการเสนอราคา]: หากต้องการผสานรวมรูปแบบโฆษณาที่รองรับทั้งหมดในการเสนอราคา ให้ใช้ ปลั๊กอินสื่อกลาง Google Mobile Ads สำหรับ Mintegral 1.4.0 ขึ้นไป (แนะนำให้ใช้เวอร์ชันล่าสุด)
  • หากต้องการติดตั้งใช้งานใน Android
    • Android API ระดับ 23 ขึ้นไป
  • หากต้องการติดตั้งใช้งานใน iOS
    • เป้าหมายการติดตั้งใช้งาน iOS 13.0 ขึ้นไป
  • โปรเจ็กต์ Flutter ที่ใช้งานได้ซึ่งกำหนดค่าด้วย Google Mobile Ads Flutter Plugin ดูรายละเอียดได้ที่ ตั้งค่า Google Mobile Ads Flutter Plugin
  • ตั้งค่าสื่อกลาง AdMob

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

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

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

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

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

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

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

Android

iOS

จดรหัสแอป ของแอปพลิเคชันไว้

Android

iOS

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

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

Android

iOS

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

การเสนอราคา

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

การแสดงวิดีโอตามลำดับขั้น

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

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

Android

iOS

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

Android

iOS

ค้นหาคีย์ API สำหรับการรายงานของ Mintegral

การเสนอราคา

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

การแสดงวิดีโอตามลำดับขั้น

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

อัปเดต app-ads.txt

ผู้ขายที่ได้รับอนุญาตสำหรับแอป app-ads.txt เป็นความคิดริเริ่มของ IAB Tech Lab ที่ช่วยตรวจสอบว่าคุณจะขายพื้นที่โฆษณาแอปผ่านช่องทางที่คุณระบุว่าได้รับอนุญาตเท่านั้น คุณจะต้องใช้ไฟล์ app-ads.txt เพื่อป้องกันไม่ให้เสียรายได้จากโฆษณาเป็นจำนวนมาก หากยังไม่ได้สร้างไฟล์ app-ads.txt ให้สร้างไฟล์ดังกล่าวสำหรับแอป

หากต้องการใช้ app-ads.txt สำหรับ Mintegral โปรดดู How app-Ads.txt Can Help Fight Ad Fraud

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

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

Android

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

iOS

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

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

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

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

Google Mobile Ads Flutter Plugin

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

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

dependencies:
  gma_mediation_mintegral: ^2.1.0

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

ดาวน์โหลดปลั๊กอินสื่อกลาง Google Mobile Ads สำหรับ 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 (การแสดงวิดีโอตามลำดับขั้น) แหล่งที่มาของโฆษณา

รหัสข้อผิดพลาด

หากอะแดปเตอร์รับโฆษณาจาก 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

เวอร์ชัน 2.1.0

เวอร์ชัน 2.0.3

เวอร์ชัน 2.0.2

เวอร์ชัน 2.0.1

เวอร์ชัน 2.0.0

เวอร์ชัน 1.2.6

เวอร์ชัน 1.2.5

เวอร์ชัน 1.2.4

เวอร์ชัน 1.2.3

เวอร์ชัน 1.2.2

เวอร์ชัน 1.2.1

เวอร์ชัน 1.2.0

เวอร์ชัน 1.1.0

เวอร์ชัน 1.0.0