คู่มือนี้แสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดงโฆษณาจาก maio โดยใช้สื่อกลางที่ครอบคลุมการผสานรวม Waterfall ซึ่งครอบคลุมถึงวิธีเพิ่ม maio ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม maio SDK และอะแดปเตอร์เข้ากับแอป Unity
อินเทอร์เฟซแดชบอร์ดสำหรับ maio จะใช้ข้อความภาษาญี่ปุ่นสำหรับป้ายกำกับ ปุ่ม และคำอธิบาย โดยระบบยังไม่ได้แปลภาพหน้าจอในคู่มือนี้ อย่างไรก็ตาม ในคำอธิบายและวิธีการในส่วนนี้ ป้ายกำกับและปุ่มจะอ้างอิงด้วยภาษาอังกฤษที่เทียบเท่ากัน เช่น "URL IDキーム" เป็น "รูปแบบ URL" เป็นต้น
การผสานรวมและรูปแบบโฆษณาที่รองรับ
อะแดปเตอร์สื่อกลางสำหรับ maio มีความสามารถต่อไปนี้
การผสานรวม | |
---|---|
การเสนอราคา | |
น้ำตก | |
รูปแบบ | |
แบนเนอร์ | |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว |
ข้อกำหนด
- Unity 4 ขึ้นไป
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุด
- เพื่อทำให้ใช้งานได้ใน Android
- API ของ Android ระดับ 21 ขึ้นไป
- เพื่อทำให้ใช้งานได้ใน iOS
- เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
- โปรเจ็กต์ Unity ที่ใช้งานได้ซึ่งกำหนดค่าด้วย SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ดูรายละเอียดได้ที่ เริ่มต้นใช้งาน
- ทําตามคู่มือเริ่มต้นใช้งานสื่อกลาง
ขั้นตอนที่ 1: ตั้งค่าการกำหนดค่าใน UI ของ maio
ก่อนอื่น ให้ลงชื่อสมัครใช้หรือลงชื่อเข้าสู่ระบบบัญชี maio ของคุณ คลิกปุ่ม การจัดการแอปพลิเคชันในแถบด้านซ้าย แล้วคลิกแอปใหม่
เลือกแท็บประเภทโฆษณาที่ต้องการ
โฆษณาคั่นระหว่างหน้า
ป้อนชื่อของแอป เลือกแพลตฟอร์ม และระบุ URL ของแอป เลือกประเภทโฆษณาเป็นโฆษณาวิดีโอคั่นระหว่างหน้า แล้วคลิกอัปเดต
Android
iOS
ได้รับรางวัลแล้ว
ป้อนชื่อของแอป เลือกแพลตฟอร์ม และระบุ URL ของแอป เลือกรางวัลวิดีโอเป็นประเภทโฆษณา แล้วคลิกอัปเดต
Android
iOS
ในหน้าการจัดการแอปพลิเคชัน ให้จดรหัสสื่อ แต่คุณต้องตั้งค่า AdMob หน่วยโฆษณาในส่วนถัดไป
Android
iOS
ในหน้า Zone Management ให้จดบันทึก Zone ID และยังเป็นสิ่งจำเป็นในการตั้งค่า AdMob หน่วยโฆษณาในส่วนถัดไปด้วย
Android
iOS
ขั้นตอนที่ 2: ตั้งค่าดีมานด์ maio ใน AdMob UI
กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา
Android
ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสําหรับ Android
iOS
โปรดดูวิธีการในขั้นตอนที่ 2 ในคู่มือสำหรับ iOS
ขั้นตอนที่ 3: นำเข้า maio SDK และอะแดปเตอร์
ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google สำหรับ maio เวอร์ชันล่าสุดจากลิงก์ดาวน์โหลดใน Changelog ของ maio และแยก GoogleMobileAdsMaioMediation.unitypackage
ออกจากไฟล์ ZIP
ในตัวแก้ไขโปรเจ็กต์ Unity ให้เลือกเนื้อหา > นำเข้าแพ็กเกจ > กำหนดเอง
แพ็กเกจ แล้วค้นหาไฟล์ GoogleMobileAdsMaioMediation.unitypackage
ที่คุณดาวน์โหลดไว้ ตรวจสอบว่าได้เลือกไฟล์ทั้งหมดแล้ว และคลิกนำเข้า
จากนั้นเลือกเนื้อหา > ตัวแก้ไขบริการ Google Play > ตัวแก้ไข Android >
บังคับแก้ไข ไลบรารีตัวแปลค่าบริการ Unity Play จะแก้ปัญหาการขึ้นต่อกันใหม่ตั้งแต่ต้นและคัดลอกทรัพยากร Dependency ที่ประกาศไว้ไปยังไดเรกทอรี 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
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.1.0
เวอร์ชัน 2.0.2
- รองรับอะแดปเตอร์ maio Android เวอร์ชัน 1.1.16.3
- รองรับอะแดปเตอร์ iOS ของ maio เวอร์ชัน 2.1.4.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.0.0
เวอร์ชัน 2.0.1
- รองรับอะแดปเตอร์ maio Android เวอร์ชัน 1.1.16.2
- รองรับอะแดปเตอร์ iOS ของ maio เวอร์ชัน 2.1.3.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.0.0
เวอร์ชัน 2.0.0
- รองรับอะแดปเตอร์ maio Android เวอร์ชัน 1.1.16.2
- รองรับอะแดปเตอร์ iOS ของ maio เวอร์ชัน 2.1.1.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.6.0
เวอร์ชัน 1.4.3
- ย้ายเนื้อหาของอะแดปเตอร์ไปยัง
GoogleMobileAds/Mediation/Maio/
แล้ว - รองรับอะแดปเตอร์ maio Android เวอร์ชัน 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
- รองรับอะแดปเตอร์ maio Android เวอร์ชัน 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