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

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

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

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

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

1 การผสานรวมการเสนอราคาและการแสดงโฆษณาสื่อกลางตามลำดับขั้นสําหรับรูปแบบโฆษณาเปิดแอปอยู่ในเวอร์ชันเบต้าแบบจำกัดผู้ใช้งาน

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

ข้อกำหนด

  • Google Mobile Ads SDK เวอร์ชันล่าสุด
  • Flutter 3.7.0 ขึ้นไป
  • [สําหรับการเสนอราคา]: หากต้องการผสานรวมรูปแบบโฆษณาที่รองรับทั้งหมดในการเสนอราคา ให้ใช้ปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google สําหรับ Mintegral 1.4.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 ใน UI ของ AdMob

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

Android

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

iOS

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

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

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

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

การผสานรวมผ่าน 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

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

หากต้องการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก 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