คู่มือนี้แสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดงโฆษณาจาก Mintegral โดยใช้สื่อกลาง ซึ่งครอบคลุมทั้งการผสานรวม Waterfall และการเสนอราคา ซึ่งครอบคลุมถึงวิธีเพิ่ม Mintegral ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม Mintegral SDK และอะแดปเตอร์เข้ากับ Unity แอป
การผสานรวมและรูปแบบโฆษณาที่รองรับ
AdMob อะแดปเตอร์สื่อกลางสำหรับ Mintegral มีความสามารถต่อไปนี้
การผสานรวม | ||
---|---|---|
การเสนอราคา | 1 | |
น้ำตก | 2 | |
รูปแบบ | ||
การเปิดแอป | 1 2 | |
แบนเนอร์ | ||
โฆษณาคั่นระหว่างหน้า | ||
ได้รับรางวัลแล้ว | ||
โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล | ||
เนทีฟ | 1 3 |
1 การผสานรวมการเสนอราคาสำหรับรูปแบบนี้อยู่ในรุ่นเบต้าแบบปิด
2 การผสานรวม Waterfall สำหรับรูปแบบนี้อยู่ในเวอร์ชันเบต้าแบบปิด
ข้อกำหนด
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุด
- Unity 5.6 ขึ้นไป
- เพื่อทำให้ใช้งานได้ใน Android
- API ของ Android ระดับ 21 ขึ้นไป
- เพื่อทำให้ใช้งานได้ใน 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 จากลิงก์ดาวน์โหลดใน Changelog และดึงข้อมูล 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
เวอร์ชัน 1.6.4
- รองรับอะแดปเตอร์ Mintegral Android เวอร์ชัน 16.7.61.0
- รองรับอะแดปเตอร์ Mintegral iOS เวอร์ชัน 7.6.7.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.1.0
เวอร์ชัน 1.6.3
- รองรับอะแดปเตอร์ Mintegral Android เวอร์ชัน 16.7.41.0
- รองรับอะแดปเตอร์ Mintegral iOS เวอร์ชัน 7.6.6.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.1.0
เวอร์ชัน 1.6.2
- รองรับอะแดปเตอร์ Mintegral Android เวอร์ชัน 16.7.41.0
- รองรับอะแดปเตอร์ Mintegral iOS เวอร์ชัน 7.6.4.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.1.0
เวอร์ชัน 1.6.1
- รองรับอะแดปเตอร์ Mintegral Android เวอร์ชัน 16.7.21.0
- รองรับอะแดปเตอร์ Mintegral iOS เวอร์ชัน 7.6.3.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.1.0
เวอร์ชัน 1.6.0
- รองรับอะแดปเตอร์ Mintegral Android เวอร์ชัน 16.7.11.0
- รองรับอะแดปเตอร์ Mintegral iOS เวอร์ชัน 7.6.2.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.0.0
เวอร์ชัน 1.5.0
- รองรับอะแดปเตอร์ Mintegral Android เวอร์ชัน 16.6.71.0
- รองรับอะแดปเตอร์ Mintegral iOS เวอร์ชัน 7.6.0.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.0.0
เวอร์ชัน 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