คู่มือนี้จะแสดงวิธีใช้ Google Mobile Ads SDK เพื่อโหลดและแสดงโฆษณาจาก MAIO โดยใช้สื่อกลาง ซึ่งครอบคลุมการผสานรวม Waterfall ซึ่งครอบคลุมถึงวิธีเพิ่ม maio ลงในหน่วยโฆษณา การกำหนดค่าสื่อกลาง และวิธีผสานรวม maio SDK และอะแดปเตอร์ แอป Unity
อินเทอร์เฟซแดชบอร์ดสำหรับ maio จะใช้ข้อความภาษาญี่ปุ่นสำหรับป้ายกำกับ ปุ่มต่างๆ และคำอธิบาย รวมทั้งภาพหน้าจอในคู่มือนี้ยังไม่ได้รับการแปล แต่ในคำอธิบายและวิธีการในส่วนนี้ ป้ายกำกับและปุ่มจะ ที่เรียกโดยภาษาอังกฤษที่เทียบเท่ากัน "URL ホキーム" ตัวอย่างเช่น คือ "รูปแบบ URL" เป็นต้น
การผสานรวมและรูปแบบโฆษณาที่รองรับ
อะแดปเตอร์สื่อกลางสำหรับ maio มีความสามารถต่อไปนี้
การผสานรวม | |
---|---|
การเสนอราคา | |
น้ำตก | |
รูปแบบ | |
แบนเนอร์ | |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว |
ข้อกำหนด
- Unity 4 ขึ้นไป
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุด
- เพื่อทำให้ใช้งานได้ใน Android
- API ของ Android ระดับ 21 ขึ้นไป
- เพื่อทำให้ใช้งานได้บน iOS
- เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
- โปรเจ็กต์ Unity ที่ใช้งานได้ซึ่งกำหนดค่าด้วย SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google โปรดดู เริ่มต้นใช้งานเพื่อดูรายละเอียด
- ดำเนินการสื่อกลางให้เสร็จสิ้น คู่มือเริ่มต้นใช้งาน
ขั้นตอนที่ 1: ตั้งค่าการกําหนดค่าใน UI ของ Maio
ขั้นตอนที่ 2: ตั้งค่าดีมานด์ maio ใน AdMob UI
กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา
Android
ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสําหรับ Android
iOS
โปรดดูวิธีการในขั้นตอนที่ 2 ในคู่มือสำหรับ iOS
ขั้นตอนที่ 3: นําเข้า SDK และอะแดปเตอร์ของ Maio
OpenUPM-CLI
หากคุณมี OpenUPM-CLI ติดตั้งแล้ว คุณสามารถติดตั้ง maio ของโฆษณา Google Mobile ปลั๊กอินสื่อกลางสำหรับ Unity ไปยังโปรเจ็กต์โดยเรียกใช้คำสั่งต่อไปนี้ จากไดเรกทอรีรากของโปรเจ็กต์:
openupm add com.google.ads.mobile.mediation.maio
OpenUPM
ในตัวแก้ไขโปรเจ็กต์ Unity ให้เลือกแก้ไข > การตั้งค่าโปรเจ็กต์ > เครื่องมือจัดการแพ็กเกจเพื่อเปิด การตั้งค่าเครื่องมือจัดการแพ็กเกจ Unity
ในแท็บ Scoped Registries ให้เพิ่ม OpenUPM เป็นรีจิสทรีที่กำหนดขอบเขตด้วยตัวเลือก รายละเอียดต่อไปนี้
- ชื่อ:
OpenUPM
- URL:
https://package.openupm.com
- ขอบเขต:
com.google
จากนั้นไปที่หน้าต่าง > เครื่องมือจัดการแพ็กเกจเพื่อเปิด ตัวจัดการแพ็กเกจ Unity และ เลือก My Registries จากเมนูแบบเลื่อนลง
เลือกแพ็กเกจสื่อกลาง maio ของโฆษณา Google Mobile และ ให้คลิกติดตั้ง
แพ็กเกจ Unity
ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุดสำหรับ
maio จากลิงก์ดาวน์โหลดใน
เวลา
บันทึกการเปลี่ยนแปลง
และดึงข้อมูล
GoogleMobileAdsMaioMediation.unitypackage
จากรหัสไปรษณีย์
ในเครื่องมือแก้ไขโปรเจ็กต์ Unity ให้เลือกเนื้อหา > นำเข้าแพ็กเกจ >
แพ็กเกจที่กำหนดเอง แล้วค้นหา
GoogleMobileAdsMaioMediation.unitypackage
ที่คุณดาวน์โหลดไว้ ตรวจสอบว่าได้เลือกไฟล์ทั้งหมดแล้ว แล้วคลิกนําเข้า
จากนั้นเลือกชิ้นงาน > ตัวแก้ไขบริการ Google Play >
ตัวแก้ไข Android > บังคับให้แก้ไข ไลบรารี Unity Play Services Resolver จะทำการแก้ไขข้อกำหนดตั้งแต่ต้นและคัดลอกข้อกำหนดที่ประกาศไว้ไปยังไดเรกทอรี Assets/Plugins/Android
ของแอป Unity
ขั้นตอนที่ 4: เพิ่มโค้ดที่จําเป็น
Android
ไม่ต้องมีรหัสเพิ่มเติมสำหรับการผสานรวม maio เลย
iOS
การผสานรวม SKAdNetwork
ทำตามเอกสารประกอบของ maiO เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist
ของโปรเจ็กต์
ขั้นตอนที่ 5: ทดสอบการใช้งาน
เปิดใช้โฆษณาทดสอบ
อย่าลืม ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ AdMob
ผู้เผยแพร่โฆษณาที่ใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 7.26.0 ขึ้นไปจะได้รับโฆษณาทดสอบจาก maio โดยอัตโนมัติในโทรศัพท์และแท็บเล็ตที่ลงทะเบียนเป็นอุปกรณ์ทดสอบเมื่อส่งคําขอ
ยืนยันโฆษณาทดสอบ
ในการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก maio ให้เปิดใช้ การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้ maio (Waterfall) แหล่งที่มาของโฆษณา
รหัสข้อผิดพลาด
หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก maio ผู้เผยแพร่โฆษณาสามารถตรวจสอบ
ข้อผิดพลาดสำคัญจากการตอบกลับโฆษณาโดยใช้
ResponseInfo
ภายใต้
ชั้นเรียนต่อไปนี้
Android
รูปแบบ | ชื่อชั้นเรียน |
---|---|
โฆษณาคั่นระหว่างหน้า | jp.maio.sdk.android.mediation.admob.adapter.Interstitial |
ได้รับรางวัลแล้ว | jp.maio.sdk.android.mediation.admob.adapter.Rewarded |
iOS
รูปแบบ | ชื่อชั้นเรียน |
---|---|
โฆษณาคั่นระหว่างหน้า | GADMMaioInterstitialAdapter |
ได้รับรางวัลแล้ว | GADMMaioRewardedAdapter |
นี่คือรหัสและข้อความประกอบที่ส่งมาจากอะแดปเตอร์ maio เมื่อโฆษณาไม่โหลด
Android
รหัสข้อผิดพลาด | เหตุผล |
---|---|
0-10 | maio แสดงข้อผิดพลาดเฉพาะ SDK ดูรหัส และเอกสารของ maio เพื่อดูรายละเอียดเพิ่มเติม |
101 | Maio ไม่มีโฆษณา |
102 | พารามิเตอร์เซิร์ฟเวอร์ไม่ถูกต้อง (เช่น ไม่มีรหัสตำแหน่ง) |
103 | บริบทที่ใช้ในการโหลดโฆษณาไม่ใช่อินสแตนซ์ "กิจกรรม" |
iOS
รหัสข้อผิดพลาด | เหตุผล |
---|---|
0-10 | maio แสดงข้อผิดพลาดเฉพาะ SDK โปรดดู รหัสของ maio เพื่อดูรายละเอียดเพิ่มเติม |
101 | maio ยังไม่มีโฆษณา |
102 | พารามิเตอร์เซิร์ฟเวอร์ไม่ถูกต้อง (เช่น ไม่มีรหัสตำแหน่ง) |
103 | อะแดปเตอร์ maio ไม่รองรับรูปแบบโฆษณาที่ขอ |
104 | โหลดโฆษณาสำหรับการกำหนดค่าเครือข่ายนี้แล้ว |
บันทึกการเปลี่ยนแปลงปลั๊กอิน maio Unity Mediation
เวอร์ชัน 2.0.3
- รองรับอะแดปเตอร์ maio Android เวอร์ชัน 1.1.16.3
- รองรับอะแดปเตอร์ iOS ของ maio เวอร์ชัน 2.1.5.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 9.1.0
เวอร์ชัน 2.0.2
- รองรับอะแดปเตอร์ maio Android เวอร์ชัน 1.1.16.3
- รองรับอะแดปเตอร์ iOS ของ maio เวอร์ชัน 2.1.4.0
- สร้างขึ้นและทดสอบด้วยปลั๊กอิน Google Mobile Ads Unity เวอร์ชัน 9.0.0
เวอร์ชัน 2.0.1
- รองรับอะแดปเตอร์ Android ของ maiO เวอร์ชัน 1.1.16.2
- รองรับอะแดปเตอร์ iOS ของ maio เวอร์ชัน 2.1.3.0
- สร้างขึ้นและทดสอบด้วยปลั๊กอิน Google Mobile Ads Unity เวอร์ชัน 9.0.0
เวอร์ชัน 2.0.0
- รองรับอะแดปเตอร์ Android ของ maiO เวอร์ชัน 1.1.16.2
- รองรับอะแดปเตอร์ iOS ของ maio เวอร์ชัน 2.1.1.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 8.6.0
เวอร์ชัน 1.4.3
- ย้ายเนื้อหาของอะแดปเตอร์ไปยัง
GoogleMobileAds/Mediation/Maio/
แล้ว - รองรับอะแดปเตอร์ Android ของ maiO เวอร์ชัน 1.1.16.2
- รองรับอะแดปเตอร์ iOS ของ maio เวอร์ชัน 1.6.3.1
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.1.0
เวอร์ชัน 1.4.2
- รองรับอะแดปเตอร์ maio Android เวอร์ชัน 1.1.16.1
- รองรับอะแดปเตอร์ iOS ของ maio เวอร์ชัน 1.6.3.0
- สร้างและทดสอบโดยใช้ Google Mobile Ads Unity Plugin เวอร์ชัน 7.4.0
เวอร์ชัน 1.4.1
- รองรับอะแดปเตอร์ Android ของ maio เวอร์ชัน 1.1.16.1
- รองรับอะแดปเตอร์ iOS ของ maio เวอร์ชัน 1.6.2.0
- สร้างและทดสอบโดยใช้ Google Mobile Ads Unity Plugin เวอร์ชัน 7.1.0
เวอร์ชัน 1.4.0
- รองรับอะแดปเตอร์ maio Android เวอร์ชัน 1.1.16.0
- รองรับอะแดปเตอร์ iOS ของ maiO เวอร์ชัน 1.6.0.1
- สร้างและทดสอบโดยใช้ Google Mobile Ads Unity Plugin เวอร์ชัน 7.0.0
เวอร์ชัน 1.3.6
เวอร์ชัน 1.3.5
เวอร์ชัน 1.3.4
เวอร์ชัน 1.3.3
เวอร์ชัน 1.3.2
เวอร์ชัน 1.3.1
เวอร์ชัน 1.3.0
เวอร์ชัน 1.2.3
- อัปเดตปลั๊กอินให้รองรับ มีการให้รางวัล API ใหม่
- รองรับอะแดปเตอร์ Android ของ maio เวอร์ชัน 1.1.7.0
- รองรับอะแดปเตอร์ iOS ของ maio เวอร์ชัน 1.4.6.0
เวอร์ชัน 1.2.2
- รองรับอะแดปเตอร์ Android ของ maio เวอร์ชัน 1.1.6.0
- รองรับอะแดปเตอร์ iOS ของ Maio เวอร์ชัน 1.4.2.0
เวอร์ชัน 1.2.1
- รองรับอะแดปเตอร์ Android ของ maio เวอร์ชัน 1.1.6.0
- รองรับอะแดปเตอร์ iOS ของ maio เวอร์ชัน 1.4.1.0
เวอร์ชัน 1.2.0
- รองรับอะแดปเตอร์ Android ของ maio เวอร์ชัน 1.1.4.1
- รองรับอะแดปเตอร์ iOS ของ maio เวอร์ชัน 1.4.0.0
เวอร์ชัน 1.1.3
- รองรับอะแดปเตอร์ Android ของ maio เวอร์ชัน 1.1.3.1
- รองรับอะแดปเตอร์ iOS ของ maio เวอร์ชัน 1.3.2.0
เวอร์ชัน 1.1.2
- รองรับอะแดปเตอร์ Android ของ maio เวอร์ชัน 1.1.3.0
- รองรับอะแดปเตอร์ iOS ของ maio เวอร์ชัน 1.3.2.0
เวอร์ชัน 1.1.1
- รองรับอะแดปเตอร์ Android ของ Maio เวอร์ชัน 1.1.1.0
- รองรับอะแดปเตอร์ iOS ของ maio เวอร์ชัน 1.3.1.1
เวอร์ชัน 1.1.0
- รองรับอะแดปเตอร์ Android ของ maio เวอร์ชัน 1.1.0.0
- รองรับอะแดปเตอร์ iOS ของ Maio เวอร์ชัน 1.3.0.0
เวอร์ชัน 1.0.2
- รองรับ maio Android SDK เวอร์ชัน 1.0.8
- รองรับ maio iOS SDK เวอร์ชัน 1.2.19
เวอร์ชัน 1.0.1
- รองรับ maio Android SDK เวอร์ชัน 1.0.7
- รองรับ maio iOS SDK เวอร์ชัน 1.2.19
เวอร์ชัน 1.0.0
- เปิดตัวครั้งแรก
- รองรับ Maio Android SDK เวอร์ชัน 1.0.6
- รองรับ maio iOS SDK เวอร์ชัน 1.2.18