คู่มือนี้จะแสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดงโฆษณาจาก Mintegral โดยใช้สื่อกลาง ซึ่งครอบคลุมทั้งการผสานรวม Waterfall และการเสนอราคา โดยจะครอบคลุมวิธีการเพิ่ม Mintegral ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม อะแดปเตอร์และ SDK ของ Mintegral เข้ากับแอป Unity
การผสานรวมที่รองรับและรูปแบบโฆษณา
AdMob อะแดปเตอร์สื่อกลางสำหรับ Mintegral มีความสามารถดังต่อไปนี้
การผสานรวม | ||
---|---|---|
การเสนอราคา | 1 | |
น้ำตก | 2 | |
รูปแบบ | ||
การเปิดแอป | 1 2 | |
แบนเนอร์ | ||
โฆษณาคั่นระหว่างหน้า | ||
ได้รับรางวัลแล้ว | ||
โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล |
2 การผสานรวมการเสนอราคาสำหรับรูปแบบนี้อยู่ในเวอร์ชันเบต้าแบบปิด
ข้อกำหนด
- Unity 5.6 ขึ้นไป
- SDK โฆษณาบนอุปกรณ์เคลื่อนที่ของ Google ล่าสุด
- เพื่อทำให้ใช้งานได้ใน Android
- Android API ระดับ 19 ขึ้นไป
- เพื่อทำให้ใช้งานได้ใน iOS
- เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
- โปรเจ็กต์ Unity ที่ใช้งานได้ซึ่งกำหนดค่าด้วย SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google โปรดดูรายละเอียดในเริ่มต้นใช้งาน
- ทำตามคู่มือเริ่มต้นใช้งานสื่อกลาง
ขั้นตอนที่ 1: ตั้งการกำหนดค่าใน Mintegral UI
ลงชื่อสมัครใช้หรือลงชื่อเข้าสู่ระบบบัญชี Mintegral
ค้นหาคีย์ของแอป
ไปที่แท็บการตั้งค่าแอป แล้วจดคีย์แอป
เพิ่มแอปพลิเคชันใหม่
จากแท็บการตั้งค่าแอป ให้คลิกปุ่มเพิ่มแอป
เลือกแพลตฟอร์มและกรอกข้อมูลในแบบฟอร์มส่วนที่เหลือ จากนั้นคลิกบันทึก
Android
iOS
จดรหัสแอปของแอปพลิเคชัน
Android
iOS
สร้างตำแหน่งโฆษณา
เมื่อสร้างแอปพลิเคชันแล้ว ให้ไปที่แท็บตำแหน่งและหน่วย แล้วคลิกปุ่มเพิ่มตำแหน่งดังที่แสดงด้านล่างเพื่อสร้างตำแหน่งโฆษณา
Android
iOS
ป้อนชื่อตำแหน่งและรูปแบบโฆษณา
การเสนอราคา
เลือกการเสนอราคาส่วนหัวเป็นประเภทการเสนอราคา กรอกแบบฟอร์มที่เหลือ แล้วคลิกบันทึก
น้ำตก
เลือกรูปแบบการเสนอราคาเป็นประเภทการเสนอราคา กรอกแบบฟอร์มที่เหลือ แล้วคลิกบันทึก
เมื่อสร้างตำแหน่งโฆษณาแล้ว ให้จดรหัสตำแหน่งโฆษณาไว้
Android
iOS
คลิกเมนูแบบเลื่อนลงหน่วยโฆษณา 1 หน่วย และจดรหัสหน่วยโฆษณา
Android
iOS
ค้นหาคีย์ Mintegral Reporting API
การเสนอราคา
ขั้นตอนนี้ไม่จำเป็นสำหรับการผสานรวมการเสนอราคา
น้ำตก
คุณจะต้องใช้คีย์ Mintegral Reporting API ในการตั้งค่าAdMob รหัสหน่วยโฆษณา ไปที่ Account > API Tools จดบันทึก Skey และ Secret ของคุณ
ขั้นตอนที่ 2: ตั้งค่าดีมานด์ Mintegral ใน AdMob UI
กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา
Android
ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสําหรับ Android
iOS
โปรดดูวิธีการในขั้นตอนที่ 2 ในคู่มือสำหรับ iOS
เพิ่ม Mintegral ลงในรายชื่อพาร์ทเนอร์โฆษณาเกี่ยวกับกฎระเบียบของรัฐในสหรัฐอเมริกาและ GDPR
ทำตามขั้นตอนใน การตั้งค่า GDPR และ การตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกา เพื่อเพิ่ม Mintegral ลงในรายชื่อพาร์ทเนอร์โฆษณาตามกฎระเบียบ GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกาใน AdMob
ขั้นตอนที่ 3: นำเข้า Mintegral SDK และอะแดปเตอร์
ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุดสำหรับ Mintegral
จากลิงก์ดาวน์โหลดใน
บันทึกการเปลี่ยนแปลง และแยก
GoogleMobileAdsMintegralMediation.unitypackage
ออกจากไฟล์ ZIP
ในเครื่องมือแก้ไขโปรเจ็กต์ Unity ให้เลือกเนื้อหา > นำเข้าแพ็กเกจ > แพ็กเกจที่กำหนดเอง แล้วค้นหาไฟล์ GoogleMobileAdsMintegralMediation.unitypackage
ที่คุณดาวน์โหลด ตรวจสอบว่าได้เลือกไฟล์ทั้งหมดแล้ว และคลิกนำเข้า
จากนั้นเลือกเนื้อหา > ตัวแก้ไขบริการ Google Play > ตัวแก้ไข Android > บังคับให้แก้ไข ไลบรารีของตัวแปลค่าบริการของ Unity Play จะดำเนินการแก้ปัญหาทรัพยากร Dependency ตั้งแต่ต้นและคัดลอกทรัพยากร Dependency ที่ประกาศไว้ในไดเรกทอรี Assets/Plugins/Android
ของแอป Unity
ขั้นตอนที่ 4: เพิ่มโค้ดที่จำเป็น
Android
ไม่ต้องใช้โค้ดเพิ่มเติมสำหรับการผสานรวม Mintegral
iOS
การผสานรวม SKAdNetwork
ทำตามเอกสารประกอบของ Mintegral เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist
ของโปรเจ็กต์
ขั้นตอนที่ 5: ทดสอบการใช้งาน
เปิดใช้โฆษณาทดสอบ
อย่าลืม ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ AdMob
หากต้องการใช้โฆษณาทดสอบของ Mintegral สำหรับโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า รูปแบบโฆษณาที่มีการให้รางวัล และโฆษณาเนทีฟ ทาง Mintegral แนะนำให้ใช้คีย์แอป รหัสแอป รหัสตำแหน่งโฆษณา และรหัสหน่วยโฆษณาที่ให้ไว้ในหน้ารหัสการทดสอบของ Mintegral หน้ารหัสการทดสอบ Mintegral
ยืนยันโฆษณาทดสอบ
ในการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก Mintegral ให้เปิดใช้ การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้ Mintegral (Bidding) and 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 Unity Mediation
เวอร์ชัน 1.4.0
- รองรับอะแดปเตอร์ Mintegral Android เวอร์ชัน 16.6.34.0
- รองรับอะแดปเตอร์ Mintegral iOS เวอร์ชัน 7.5.6.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.7.0
เวอร์ชัน 1.3.0
- รองรับอะแดปเตอร์ Mintegral Android เวอร์ชัน 16.5.91.0
- รองรับอะแดปเตอร์ Mintegral iOS เวอร์ชัน 7.5.3.0
- เพิ่มเมธอดต่อไปนี้ไปยังคลาส
Mintegral
SetConsentStatus(bool)
SetDoNotTrackStatus(bool)
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.6.0
เวอร์ชัน 1.2.1
- รองรับอะแดปเตอร์ Mintegral Android เวอร์ชัน 16.4.61.0
- รองรับอะแดปเตอร์ Mintegral iOS เวอร์ชัน 7.3.8.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.3.0
เวอร์ชัน 1.2.0
- ย้ายเนื้อหาของอะแดปเตอร์ไปที่
GoogleMobileAds/Mediation/Mintegral/
แล้ว - รองรับอะแดปเตอร์ Mintegral Android เวอร์ชัน 16.4.41.0
- รองรับอะแดปเตอร์ Mintegral iOS เวอร์ชัน 7.3.6.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.3.0
เวอร์ชัน 1.1.0
- รองรับอะแดปเตอร์ Mintegral Android เวอร์ชัน 16.3.61.0
- รองรับอะแดปเตอร์ Mintegral iOS เวอร์ชัน 7.2.9.1
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.4.1
เวอร์ชัน 1.0.0
- การเผยแพร่ครั้งแรก
- รองรับอะแดปเตอร์ Mintegral Android เวอร์ชัน 16.2.61.0
- รองรับอะแดปเตอร์ Mintegral iOS เวอร์ชัน 7.2.6.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.3.1