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

เลือกแพลตฟอร์ม: Android iOS Unity Flutter Android (เดิม)

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

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

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

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

ข้อกำหนดเบื้องต้น

โปรดตรวจสอบสิ่งต่อไปนี้ก่อนดำเนินการต่อ

  • เวอร์ชันล่าสุดของ 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
  • ตั้งค่าสื่อกลาง

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

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

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

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

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

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

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

Android

iOS

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

Android

iOS

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

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

Android

iOS

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

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

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

Android

iOS

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

Android

iOS

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

การเสนอราคา

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

Waterfall

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

อัปเดต app-ads.txt

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

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

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

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

Android

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

iOS

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

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

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

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

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

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

dependencies:
  gma_mediation_mintegral: ^2.1.1

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

ดาวน์โหลดปลั๊กอินสื่อกลาง 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: ทดสอบการติดตั้งใช้งาน

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

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

หากต้องการรับโฆษณาทดสอบของ Mintegral สำหรับรูปแบบโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า โฆษณาที่มีการให้รางวัล และโฆษณาเนทีฟ Mintegral ขอแนะนำให้ใช้คีย์แอป รหัสแอป รหัสตำแหน่งโฆษณา และรหัสหน่วยโฆษณาที่ระบุไว้ใน หน้า "รหัสทดสอบ" ของ 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

เวอร์ชัน 2.1.1

เวอร์ชัน 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