คู่มือนี้แสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดง โฆษณาจาก Mintegral โดยใช้สื่อกลาง ซึ่งครอบคลุมทั้งการผสานรวม Waterfall และการเสนอราคา ซึ่งครอบคลุมถึงวิธีเพิ่ม ผสานรวมเข้ากับการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม ผสานรวม SDK และอะแดปเตอร์ไว้ในแอป Unity
การผสานรวมและรูปแบบโฆษณาที่รองรับ
AdMob อะแดปเตอร์สื่อกลางสำหรับ Mintegral มีฟังก์ชัน ความสามารถต่อไปนี้
การผสานรวม | |
---|---|
การเสนอราคา | |
น้ำตก | |
รูปแบบ | |
การเปิดแอป | 1 |
แบนเนอร์ | |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว | |
โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล |
1 การเสนอราคาและการแสดงโฆษณาสื่อกลางตามลำดับขั้น การผสานรวมสำหรับรูปแบบโฆษณาเปิดแอปอยู่ในรุ่นเบต้าแบบปิด
วันที่ข้อกำหนด
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุด
- Unity 5.6 ขึ้นไป
- เพื่อทำให้ใช้งานได้ใน Android
- API ของ Android ระดับ 21 ขึ้นไป
- เพื่อทำให้ใช้งานได้บน iOS
- เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
- โปรเจ็กต์ที่ใช้งานอยู่ Unity ซึ่งกำหนดค่าด้วย SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google โปรดดู เริ่มต้นใช้งานเพื่อดูรายละเอียด
- ดำเนินการสื่อกลางให้เสร็จสิ้น คู่มือเริ่มต้นใช้งาน
ขั้นตอนที่ 1: กำหนดค่าใน Mintegral UI
ลงชื่อสมัครใช้หรือลงชื่อเข้าสู่ระบบบัญชี Mintegral
ค้นหาคีย์ของแอป
ไปที่แท็บการตั้งค่าแอป แล้วจดคีย์แอป
เพิ่มแอปพลิเคชันใหม่
จากแท็บการตั้งค่าแอป ให้คลิกปุ่มเพิ่มแอป
เลือกแพลตฟอร์มและกรอกข้อมูลในแบบฟอร์มส่วนที่เหลือ จากนั้นคลิกบันทึก
Android
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/new_application_Android.png?authuser=6&hl=th)
iOS
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/new_application_iOS.png?authuser=6&hl=th)
จดรหัสแอปของแอปพลิเคชัน
Android
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/app_id_Android.png?authuser=6&hl=th)
iOS
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/app_id_iOS.png?authuser=6&hl=th)
สร้างตำแหน่งโฆษณา
เมื่อสร้างแอปพลิเคชันแล้ว ให้ไปที่แท็บตำแหน่งและหน่วย แล้วคลิกปุ่มเพิ่มตำแหน่งดังที่แสดงด้านล่างเพื่อสร้างตำแหน่งโฆษณา
Android
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/create_placement_Android.png?authuser=6&hl=th)
iOS
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/create_placement_iOS.png?authuser=6&hl=th)
ป้อนชื่อตำแหน่งและรูปแบบโฆษณา
การเสนอราคา
เลือกการเสนอราคาส่วนหัวเป็นประเภทการเสนอราคา กรอกแบบฟอร์มที่เหลือ แล้วคลิกบันทึก
น้ำตก
เลือกรูปแบบการเสนอราคาเป็นประเภทการเสนอราคา กรอกแบบฟอร์มที่เหลือ แล้วคลิกบันทึก
เมื่อสร้างตำแหน่งโฆษณาแล้ว ให้จดรหัสตำแหน่งโฆษณาไว้
Android
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/ad_placement_id_Android.png?authuser=6&hl=th)
iOS
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/ad_placement_id_iOS.png?authuser=6&hl=th)
คลิกเมนูแบบเลื่อนลงหน่วยโฆษณา 1 หน่วย และจดรหัสหน่วยโฆษณา
Android
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/add_ad_unit_id_Android.png?authuser=6&hl=th)
iOS
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/add_ad_unit_id_iOS.png?authuser=6&hl=th)
ค้นหาคีย์ 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.7.0
- เปลี่ยนชื่อ
DummyClient
เป็นPlaceholderClient
แล้ว - รองรับอะแดปเตอร์ Mintegral Android เวอร์ชัน 16.8.11.0
- รองรับอะแดปเตอร์ Mintegral iOS เวอร์ชัน 7.6.9.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.2.0
เวอร์ชัน 1.6.5
- รองรับอะแดปเตอร์ Mintegral Android เวอร์ชัน 16.7.81.0
- รองรับอะแดปเตอร์ Mintegral iOS เวอร์ชัน 7.6.8.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.2.0
เวอร์ชัน 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