คู่มือนี้จะแสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดงโฆษณาจาก maio โดยใช้สื่อกลางที่ครอบคลุมการผสานรวม Waterfall โดยจะครอบคลุมวิธีการเพิ่ม Maio ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม SDK และอะแดปเตอร์ Maio เข้ากับแอป Unity
อินเทอร์เฟซแดชบอร์ดสำหรับ maio จะใช้ข้อความภาษาญี่ปุ่นสำหรับป้ายกำกับ ปุ่ม และคำอธิบาย และภาพหน้าจอในคู่มือนี้ยังไม่ได้รับการแปล อย่างไรก็ตาม ในคำอธิบายและคำแนะนำในที่นี้ ป้ายกำกับและปุ่มจะหมายถึงคำที่เทียบเท่าภาษาอังกฤษ เช่น "URL YOURキーム" เป็น "รูปแบบ URL" เป็นต้น
การผสานรวมที่รองรับและรูปแบบโฆษณา
อะแดปเตอร์สื่อกลางสำหรับ maio มีความสามารถดังต่อไปนี้
การผสานรวม | |
---|---|
การเสนอราคา | |
น้ำตก | |
รูปแบบ | |
แบนเนอร์ | |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว |
ข้อกำหนด
- Unity 4 ขึ้นไป
- SDK โฆษณาบนอุปกรณ์เคลื่อนที่ของ Google ล่าสุด
- เพื่อทำให้ใช้งานได้ใน Android
- Android API ระดับ 19 ขึ้นไป
- เพื่อทำให้ใช้งานได้ใน 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: ตั้งค่าดีมานด์ Macio ใน AdMob UI
กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา
Android
ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสําหรับ Android
iOS
โปรดดูวิธีการในขั้นตอนที่ 2 ในคู่มือสำหรับ iOS
ขั้นตอนที่ 3: นำเข้า SDK และอะแดปเตอร์ Maio
ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google สำหรับ maio เวอร์ชันล่าสุดจากลิงก์ดาวน์โหลดใน Changelog สำหรับ maio และแยก GoogleMobileAdsMaioMediation.unitypackage
ออกจากไฟล์ ZIP
ในเครื่องมือแก้ไขโปรเจ็กต์ Unity ให้เลือกเนื้อหา > นำเข้าแพ็กเกจ > กำหนดเอง
แพ็กเกจ แล้วค้นหาไฟล์ GoogleMobileAdsMaioMediation.unitypackage
ที่คุณดาวน์โหลด ตรวจสอบว่าได้เลือกไฟล์ทั้งหมดแล้ว จากนั้นคลิกนำเข้า
จากนั้นเลือกเนื้อหา > ตัวแก้ไขบริการ Google Play > ตัวแก้ไข Android > บังคับให้แก้ไข ไลบรารีของตัวแปลค่าบริการ Google Play ของ Unity จะดำเนินการแก้ปัญหา Dependency ตั้งแต่ต้นและคัดลอกทรัพยากร Dependency ที่ประกาศไว้ในไดเรกทอรี Assets/Plugins/Android
ของแอป Unity
ขั้นตอนที่ 4: เพิ่มโค้ดที่จำเป็น
Android
ไม่ต้องใช้รหัสเพิ่มเติมสำหรับการผสานการทำงาน maio
iOS
การผสานรวม SKAdNetwork
ทำตามเอกสารประกอบของ maio เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist
ของโปรเจ็กต์
ขั้นตอนที่ 5: ทดสอบการใช้งาน
เปิดใช้โฆษณาทดสอบ
อย่าลืม ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ AdMob
ผู้เผยแพร่โฆษณาที่ใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 7.26.0 ขึ้นไปจะได้รับโฆษณาทดสอบจาก maio โดยอัตโนมัติในโทรศัพท์และแท็บเล็ตที่ลงทะเบียนเป็นอุปกรณ์ทดสอบเมื่อส่งคําขอ
ยืนยันโฆษณาทดสอบ
ในการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก maio ให้เปิดใช้ การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้ maio (Bidding) and 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 | มีการโหลดโฆษณาสำหรับการกำหนดค่าเครือข่ายนี้แล้ว |
บันทึกการเปลี่ยนแปลงปลั๊กอิน Unity Mediation ของ maio
เวอร์ชัน 2.0.0
- รองรับอะแดปเตอร์ maio Android เวอร์ชัน 1.1.16.2
- รองรับอะแดปเตอร์ maio iOS เวอร์ชัน 2.1.1.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.6.0
เวอร์ชัน 1.4.3
- ย้ายเนื้อหาของอะแดปเตอร์ไปที่
GoogleMobileAds/Mediation/Maio/
แล้ว - รองรับอะแดปเตอร์ maio Android เวอร์ชัน 1.1.16.2
- รองรับอะแดปเตอร์ maio iOS เวอร์ชัน 1.6.3.1
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.1.0
เวอร์ชัน 1.4.2
- รองรับอะแดปเตอร์ maio Android เวอร์ชัน 1.1.16.1
- รองรับอะแดปเตอร์ maio iOS เวอร์ชัน 1.6.3.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.4.0
เวอร์ชัน 1.4.1
- รองรับอะแดปเตอร์ maio Android เวอร์ชัน 1.1.16.1
- รองรับอะแดปเตอร์ maio iOS เวอร์ชัน 1.6.2.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.1.0
เวอร์ชัน 1.4.0
- รองรับอะแดปเตอร์ maio Android เวอร์ชัน 1.1.16.0
- รองรับอะแดปเตอร์ maio iOS เวอร์ชัน 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 ที่มีการให้รางวัลใหม่
- รองรับอะแดปเตอร์ maio Android เวอร์ชัน 1.1.7.0
- รองรับอะแดปเตอร์ maio iOS เวอร์ชัน 1.4.6.0
เวอร์ชัน 1.2.2
- รองรับอะแดปเตอร์ maio Android เวอร์ชัน 1.1.6.0
- รองรับอะแดปเตอร์ maio iOS เวอร์ชัน 1.4.2.0
เวอร์ชัน 1.2.1
- รองรับอะแดปเตอร์ maio Android เวอร์ชัน 1.1.6.0
- รองรับอะแดปเตอร์ maio iOS เวอร์ชัน 1.4.1.0
เวอร์ชัน 1.2.0
- รองรับอะแดปเตอร์ maio Android เวอร์ชัน 1.1.4.1
- รองรับอะแดปเตอร์ maio iOS เวอร์ชัน 1.4.0.0
เวอร์ชัน 1.1.3
- รองรับอะแดปเตอร์ maio Android เวอร์ชัน 1.1.3.1
- รองรับอะแดปเตอร์ maio iOS เวอร์ชัน 1.3.2.0
เวอร์ชัน 1.1.2
- รองรับอะแดปเตอร์ maio Android เวอร์ชัน 1.1.3.0
- รองรับอะแดปเตอร์ maio iOS เวอร์ชัน 1.3.2.0
เวอร์ชัน 1.1.1
- รองรับอะแดปเตอร์ maio Android เวอร์ชัน 1.1.1.0
- รองรับอะแดปเตอร์ maio iOS เวอร์ชัน 1.3.1.1
เวอร์ชัน 1.1.0
- รองรับอะแดปเตอร์ maio Android เวอร์ชัน 1.1.0.0
- รองรับอะแดปเตอร์ maio iOS เวอร์ชัน 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