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

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

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

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

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

2 การผสานรวม Waterfall อยู่ในรุ่นเบต้าแบบปิด

ข้อกำหนด

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

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

ลงชื่อสมัครใช้หรือเข้าสู่ระบบบัญชี 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

OpenUPM-CLI

หากติดตั้ง OpenUPM-CLI แล้ว คุณจะติดตั้งปลั๊กอินสื่อกลาง Mintegral ของ Google Mobile Ads สําหรับ Unity ลงในโปรเจ็กต์ได้โดยเรียกใช้คําสั่งต่อไปนี้จากไดเรกทอรีรูทของโปรเจ็กต์

openupm add com.google.ads.mobile.mediation.mintegral

OpenUPM

ในเครื่องมือแก้ไขโปรเจ็กต์ Unity ให้เลือกแก้ไข > การตั้งค่าโปรเจ็กต์ > เครื่องมือจัดการแพ็กเกจเพื่อเปิดการตั้งค่าเครื่องมือจัดการแพ็กเกจ Unity

ในแท็บ Scoped Registries ให้เพิ่ม OpenUPM เป็นรีจิสทรีที่กำหนดขอบเขตซึ่งมีรายละเอียดดังต่อไปนี้

  • ชื่อ: OpenUPM
  • URL: https://package.openupm.com
  • ขอบเขต: com.google

รายละเอียด OpenUPM

จากนั้นไปที่หน้าต่าง > ตัวจัดการแพ็กเกจเพื่อเปิดตัวจัดการแพ็กเกจ Unity แล้วเลือกรีจิสทรีของฉันจากเมนูแบบเลื่อนลง

รีจิสทรีของ Unity

เลือกแพ็กเกจ Google Mobile Ads Mintegral Mediation แล้วคลิกติดตั้ง

ติดตั้งจาก OpenUPM

แพ็กเกจ Unity

ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุดสำหรับ Mintegral จากลิงก์ดาวน์โหลดใน Changelog แล้วแยก GoogleMobileAdsMintegralMediation.unitypackage ออกจากไฟล์ ZIP

ในเครื่องมือแก้ไขโปรเจ็กต์ Unity ให้เลือกเนื้อหา > นําเข้าแพ็กเกจ > แพ็กเกจที่กําหนดเอง แล้วค้นหาไฟล์ GoogleMobileAdsMintegralMediation.unitypackage ที่ดาวน์โหลด ตรวจสอบว่าได้เลือกไฟล์ทั้งหมดแล้ว แล้วคลิกนําเข้า

นำเข้าจาก Unity

จากนั้นเลือกชิ้นงาน > เครื่องมือจัดการทรัพยากรภายนอก > เครื่องมือแก้ไขของ Android > บังคับแก้ไข ไลบรารีเครื่องมือจัดการทรัพยากร Dependency ภายนอกจะทำการแก้ไข Dependency ตั้งแต่ต้นและคัดลอก Dependency ที่ประกาศไว้ไปยังไดเรกทอรี Assets/Plugins/Android ของแอป Unity

บังคับแก้ไข

ขั้นตอนที่ 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 รองรับ

บันทึกการเปลี่ยนแปลงของปลั๊กอินสื่อกลาง Unity ของ Mintegral

เวอร์ชัน 1.8.2

เวอร์ชัน 1.8.1

เวอร์ชัน 1.8.0

เวอร์ชัน 1.7.0

เวอร์ชัน 1.6.5

เวอร์ชัน 1.6.4

เวอร์ชัน 1.6.3

เวอร์ชัน 1.6.2

เวอร์ชัน 1.6.1

เวอร์ชัน 1.6.0

เวอร์ชัน 1.5.0

เวอร์ชัน 1.4.0

เวอร์ชัน 1.3.0

เวอร์ชัน 1.2.1

เวอร์ชัน 1.2.0

เวอร์ชัน 1.1.0

เวอร์ชัน 1.0.0