คู่มือนี้จะแสดงวิธีใช้ Google Mobile Ads Unity Plugin เพื่อโหลดและแสดงโฆษณาจาก maio โดยใช้สื่อกลาง ซึ่งครอบคลุมการผสานรวม Waterfall โดยจะครอบคลุมวิธีเพิ่ม maio ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม maio SDK และอะแดปเตอร์เข้ากับแอป Unity
อินเทอร์เฟซแดชบอร์ดของ maio ใช้ข้อความภาษาญี่ปุ่นสำหรับป้ายกำกับ ปุ่ม และคำอธิบาย และภาพหน้าจอในคู่มือนี้ยังไม่ได้แปล อย่างไรก็ตาม ในคำอธิบายและวิธีการที่นี่ ป้ายกำกับและปุ่มจะ อ้างอิงตามคำที่เทียบเท่าในภาษาอังกฤษ "URL スキーム," for example, is "URL Scheme,".
การผสานรวมและรูปแบบโฆษณาที่รองรับ
อะแดปเตอร์สื่อกลางสำหรับ maio มีความสามารถดังต่อไปนี้
| การผสานรวม | |
|---|---|
| การเสนอราคา | |
| การแสดงวิดีโอตามลำดับขั้น | |
| รูปแบบ | |
| โฆษณาเปิดแอป | |
| แบนเนอร์ | |
| โฆษณาคั่นระหว่างหน้า | |
| ได้รับรางวัลแล้ว | |
| โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล | |
| เนทีฟ | |
ข้อกำหนดเบื้องต้น
ก่อนดำเนินการต่อ ให้ตรวจสอบสิ่งต่อไปนี้
- Google Mobile Ads Unity Plugin เวอร์ชันล่าสุด
- Unity Editor เวอร์ชัน 4 ขึ้นไป
- วิธีติดตั้งใช้งานใน Android
- Android API ระดับ 24 ขึ้นไป
- วิธีติดตั้งใช้งานใน iOS
- เป้าหมายการติดตั้งใช้งาน iOS เวอร์ชัน 15.0 ขึ้นไป
- โปรเจ็กต์ Unity ที่ใช้งานได้ซึ่งกำหนดค่าด้วย Google Mobile Ads Unity Plugin ดูรายละเอียดได้ที่หัวข้อตั้งค่า Google Mobile Ads Unity Plugin
ขั้นตอนที่ 1: ตั้งค่าใน UI ของ maio
ขั้นแรก ให้ลงชื่อสมัครใช้หรือเข้าสู่ระบบบัญชี maio คลิกปุ่มการจัดการแอปพลิเคชันในแถบด้านข้างทางซ้าย แล้วคลิกแอปใหม่

เลือกแท็บที่สอดคล้องกับประเภทโฆษณาที่ต้องการ
โฆษณาคั่นระหว่างหน้า
ป้อนชื่อแอป เลือกแพลตฟอร์ม และระบุ URL ของแอป เลือกโฆษณาคั่นระหว่างหน้าแบบวิดีโอเป็นประเภทโฆษณา แล้วคลิกอัปเดต
Android

iOS

ได้รับรางวัลแล้ว
ป้อนชื่อแอป เลือกแพลตฟอร์ม และระบุ URL ของแอป เลือกโฆษณาวิดีโอที่มีการให้รางวัลเป็นประเภทโฆษณา แล้วคลิกอัปเดต
Android

iOS

ในหน้าการจัดการแอปพลิเคชัน ให้จดบันทึกรหัสสื่อไว้ คุณต้องใช้รหัสนี้เพื่อตั้งค่าหน่วยโฆษณา Ad Manager ในส่วนถัดไป
Android

iOS

ในหน้าการจัดการโซน ให้จดรหัสโซนไว้ นอกจากนี้ คุณยังต้องใช้รหัสนี้เพื่อตั้งค่าหน่วยโฆษณา Ad Manager ในส่วนถัดไปด้วย
Android

iOS


ขั้นตอนที่ 2: ตั้งค่าดีมานด์ maio ใน UI ของ Ad Manager
กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา
Android
ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสำหรับ Android
iOS
ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสำหรับ iOS
ขั้นตอนที่ 3: นำเข้า SDK และอะแดปเตอร์ maio
OpenUPM-CLI
หากติดตั้ง OpenUPM-CLI แล้ว คุณจะติดตั้งปลั๊กอินสื่อกลาง Google Mobile Ads maio สำหรับ Unity ลงในโปรเจ็กต์ได้โดยเรียกใช้คำสั่งต่อไปนี้จาก ไดเรกทอรีรากของโปรเจ็กต์
openupm add com.google.ads.mobile.mediation.maioOpenUPM
ในเครื่องมือแก้ไขโปรเจ็กต์ Unity ให้เลือกแก้ไข > การตั้งค่าโปรเจ็กต์ > เครื่องมือจัดการแพ็กเกจเพื่อเปิดการตั้งค่าเครื่องมือจัดการแพ็กเกจ Unity
ในแท็บ Scoped Registries ให้เพิ่ม OpenUPM เป็น Scoped Registry โดยระบุรายละเอียดต่อไปนี้
- ชื่อ:
OpenUPM - URL:
https://package.openupm.com - ขอบเขต:
com.google
จากนั้นไปที่ Window > Package Manager เพื่อเปิดเครื่องมือจัดการแพ็กเกจ Unity แล้วเลือกMy Registries จากเมนูแบบเลื่อนลง
เลือกแพ็กเกจ Google Mobile Ads Maio Mediation แล้วคลิกติดตั้ง
แพ็กเกจ Unity
ดาวน์โหลดปลั๊กอินสื่อกลาง Google Mobile Ads สำหรับ
maio เวอร์ชันล่าสุดจากลิงก์ดาวน์โหลดใน
บันทึกการเปลี่ยนแปลง
และแตกไฟล์
GoogleMobileAdsMaioMediation.unitypackage จากไฟล์ zip
ในโปรแกรมแก้ไขโปรเจ็กต์ Unity ให้เลือก Assets > Import Package >
Custom Package แล้วค้นหา
GoogleMobileAdsMaioMediation.unitypackage
ไฟล์ที่คุณดาวน์โหลด ตรวจสอบว่าได้เลือกไฟล์ทั้งหมดแล้ว แล้วคลิกนำเข้า
จากนั้นเลือก Assets > External Dependency Manager >
Android Resolver > Force Resolve ไลบรารี External Dependency Manager จะทำการแก้ไขทรัพยากร Dependency ตั้งแต่ต้นและคัดลอกทรัพยากร Dependency ที่ประกาศไว้ไปยังไดเรกทอรี Assets/Plugins/Android ของแอป Unity
ขั้นตอนที่ 4: เพิ่มโค้ดที่จำเป็น
Android
ไม่จำเป็นต้องใช้โค้ดเพิ่มเติมสำหรับการผสานรวม maio
iOS
การผสานรวม SKAdNetwork
ทำตามเอกสารประกอบของ maio เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist ของโปรเจ็กต์
ขั้นตอนที่ 5: ทดสอบการติดตั้งใช้งาน
เปิดใช้โฆษณาทดสอบ
ตรวจสอบว่าคุณได้ลงทะเบียนอุปกรณ์ทดสอบสำหรับ Ad Manager แล้ว
ผู้เผยแพร่โฆษณาที่ใช้ Google Mobile Ads Unity Plugin เวอร์ชัน 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 | บริบทที่ใช้โหลดโฆษณาไม่ใช่อินสแตนซ์ `Activity` |
iOS
| รหัสข้อผิดพลาด | เหตุผล |
|---|---|
| 0-10 | maio แสดงข้อผิดพลาดเฉพาะ SDK ดูรายละเอียดเพิ่มเติมได้ที่โค้ดของ maio |
| 101 | maio ยังไม่มีโฆษณาที่พร้อมใช้งาน |
| 102 | พารามิเตอร์เซิร์ฟเวอร์ไม่ถูกต้อง (เช่น ไม่มีรหัสตําแหน่ง) |
| 103 | อะแดปเตอร์ maio ไม่รองรับรูปแบบโฆษณาที่ขอ |
| 104 | มีการโหลดโฆษณาสำหรับการกำหนดค่าเครือข่ายนี้แล้ว |
บันทึกการเปลี่ยนแปลงของปลั๊กอินสื่อกลาง maio สำหรับ Unity
เวอร์ชัน 3.1.11
- รองรับ maio Android Adapter เวอร์ชัน 2.0.9.1
- รองรับอะแดปเตอร์ iOS ของ maio เวอร์ชัน 2.2.3.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity สำหรับ Google Mobile Ads เวอร์ชัน 11.5.0
เวอร์ชัน 3.1.10
- รองรับอะแดปเตอร์ Android ของ maio เวอร์ชัน 2.0.9.0
- รองรับอะแดปเตอร์ iOS ของ maio เวอร์ชัน 2.2.2.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity สำหรับ Google Mobile Ads เวอร์ชัน 11.4.0
เวอร์ชัน 3.1.9
- รองรับอะแดปเตอร์ Android ของ maio เวอร์ชัน 2.0.9.0
- รองรับ iOS Adapter ของ maio เวอร์ชัน 2.2.1.2.1
- สร้างและทดสอบด้วยปลั๊กอิน Unity สำหรับ Google Mobile Ads เวอร์ชัน 11.3.0
เวอร์ชัน 3.1.8
- รองรับmaio Android adapter เวอร์ชัน 2.0.8.2
- รองรับ maio iOS Adapter เวอร์ชัน 2.2.1.2
- สร้างและทดสอบด้วยปลั๊กอิน Unity สำหรับ Google Mobile Ads เวอร์ชัน 11.1.0
เวอร์ชัน 3.1.7
- รองรับmaio Android adapter เวอร์ชัน 2.0.8.2
- รองรับ maio iOS Adapter เวอร์ชัน 2.2.1.1
- สร้างและทดสอบด้วยปลั๊กอิน Unity สำหรับ Google Mobile Ads เวอร์ชัน 11.0.0
เวอร์ชัน 3.1.6
- รองรับmaio Android adapter เวอร์ชัน 2.0.8.1
- รองรับอะแดปเตอร์ iOS ของ maio เวอร์ชัน 2.2.1.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity สำหรับ Google Mobile Ads เวอร์ชัน 11.0.0
เวอร์ชัน 3.1.5
- รองรับอะแดปเตอร์ Android ของ maio เวอร์ชัน 2.0.8.0
- รองรับอะแดปเตอร์ iOS ของ maio เวอร์ชัน 2.2.0.3
- สร้างและทดสอบด้วยปลั๊กอิน Unity สำหรับ Google Mobile Ads เวอร์ชัน 11.0.0
เวอร์ชัน 3.1.4
- รองรับอะแดปเตอร์ Android ของ maio เวอร์ชัน 2.0.8.0
- รองรับอะแดปเตอร์ maio iOS เวอร์ชัน 2.2.0.1
- สร้างและทดสอบด้วยปลั๊กอิน Unity สำหรับ Google Mobile Ads เวอร์ชัน 10.6.0
เวอร์ชัน 3.1.3
- รองรับอะแดปเตอร์ Android ของ maio เวอร์ชัน 2.0.7.0
- รองรับอะแดปเตอร์ maio เวอร์ชัน 2.2.0.1 สำหรับ iOS
- สร้างและทดสอบด้วยปลั๊กอิน Unity สำหรับ Google Mobile Ads เวอร์ชัน 10.6.0
เวอร์ชัน 3.1.2
- รองรับอะแดปเตอร์ Android ของ MAIO เวอร์ชัน 2.0.7.0
- รองรับอะแดปเตอร์ maio เวอร์ชัน 2.2.0.0 สำหรับ iOS
- สร้างและทดสอบด้วยปลั๊กอิน Unity สำหรับ Google Mobile Ads เวอร์ชัน 10.6.0
เวอร์ชัน 3.1.1
- รองรับอะแดปเตอร์ Android ของ maio เวอร์ชัน 2.0.6.0
- รองรับอะแดปเตอร์ maio สำหรับ iOS เวอร์ชัน 2.2.0.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity สำหรับ Google Mobile Ads เวอร์ชัน 10.5.0
เวอร์ชัน 3.1.0
- รองรับอะแดปเตอร์ Android ของ MAIO เวอร์ชัน 2.0.5.0
- รองรับอะแดปเตอร์ maio เวอร์ชัน 2.2.0.0 สำหรับ iOS
- สร้างและทดสอบด้วยปลั๊กอิน Unity สำหรับ Google Mobile Ads เวอร์ชัน 10.5.0
เวอร์ชัน 3.0.2
- รองรับ maio Android Adapter เวอร์ชัน 2.0.5.0
- รองรับอแดปเตอร์ iOS ของ maio เวอร์ชัน 2.1.6.1
- สร้างและทดสอบด้วยปลั๊กอิน Unity สำหรับ Google Mobile Ads เวอร์ชัน 10.2.0
เวอร์ชัน 3.0.1
- รองรับอะแดปเตอร์ Android ของ maio เวอร์ชัน 2.0.4.0
- รองรับ maio iOS Adapter เวอร์ชัน 2.1.6.1
- สร้างและทดสอบด้วยปลั๊กอิน Unity สำหรับ Google Mobile Ads เวอร์ชัน 10.2.0
เวอร์ชัน 3.0.0
- อัปเดตปลั๊กอินให้มี
MaioSDK-v2เฟรมเวิร์กแบบไดนามิกสำหรับเป้าหมาย iOS ทั้งหมด - รองรับอะแดปเตอร์ maio สำหรับ Android เวอร์ชัน 2.0.3.1
- รองรับ maio iOS Adapter เวอร์ชัน 2.1.6.1
- สร้างและทดสอบด้วยปลั๊กอิน Unity สำหรับ Google Mobile Ads เวอร์ชัน 10.0.0
เวอร์ชัน 2.0.4
- รองรับอแดปเตอร์ Android ของ maio เวอร์ชัน 1.1.16.3
- รองรับ maio iOS Adapter เวอร์ชัน 2.1.5.1
- สร้างและทดสอบด้วยปลั๊กอิน Unity สำหรับ Google Mobile Ads เวอร์ชัน 9.3.0
เวอร์ชัน 2.0.3
- รองรับ maio Android Adapter เวอร์ชัน 1.1.16.3
- รองรับอะแดปเตอร์ maio iOS เวอร์ชัน 2.1.5.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity สำหรับ Google Mobile Ads เวอร์ชัน 9.1.0
เวอร์ชัน 2.0.2
- รองรับอแดปเตอร์ Android ของ maio เวอร์ชัน 1.1.16.3
- รองรับอะแดปเตอร์ iOS ของ maio เวอร์ชัน 2.1.4.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity สำหรับ Google Mobile Ads เวอร์ชัน 9.0.0
เวอร์ชัน 2.0.1
- รองรับอแดปเตอร์ Android ของ maio เวอร์ชัน 1.1.16.2
- รองรับ maio iOS Adapter เวอร์ชัน 2.1.3.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity สำหรับ Google Mobile Ads เวอร์ชัน 9.0.0
เวอร์ชัน 2.0.0
- รองรับอแดปเตอร์ Android ของ maio เวอร์ชัน 1.1.16.2
- รองรับ maio iOS Adapter เวอร์ชัน 2.1.1.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity สำหรับ Google Mobile Ads เวอร์ชัน 8.6.0
เวอร์ชัน 1.4.3
- ย้ายเนื้อหาของอะแดปเตอร์ไปยัง
GoogleMobileAds/Mediation/Maio/แล้ว - รองรับ maio Android Adapter เวอร์ชัน 1.1.16.2
- รองรับอแดปเตอร์ iOS ของ maio เวอร์ชัน 1.6.3.1
- สร้างและทดสอบด้วยปลั๊กอิน Unity สำหรับ Google Mobile Ads เวอร์ชัน 8.1.0
เวอร์ชัน 1.4.2
- รองรับอะแดปเตอร์ Android ของ maio เวอร์ชัน 1.1.16.1
- รองรับอะแดปเตอร์ maio iOS เวอร์ชัน 1.6.3.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity สำหรับ Google Mobile Ads เวอร์ชัน 7.4.0
เวอร์ชัน 1.4.1
- รองรับอะแดปเตอร์ maio สำหรับ Android เวอร์ชัน 1.1.16.1
- รองรับอะแดปเตอร์ iOS ของ maio เวอร์ชัน 1.6.2.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity สำหรับ Google Mobile Ads เวอร์ชัน 7.1.0
เวอร์ชัน 1.4.0
- รองรับ maio Android Adapter เวอร์ชัน 1.1.16.0
- รองรับอะแดปเตอร์ iOS ของ maio เวอร์ชัน 1.6.0.1
- สร้างและทดสอบด้วยปลั๊กอิน Unity สำหรับ Google Mobile Ads เวอร์ชัน 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
- อัปเดตปลั๊กอินเพื่อรองรับ Rewarded API ใหม่
- รองรับอะแดปเตอร์ maio สำหรับ Android เวอร์ชัน 1.1.7.0
- รองรับอะแดปเตอร์ maio iOS เวอร์ชัน 1.4.6.0
เวอร์ชัน 1.2.2
- รองรับอะแดปเตอร์ Android ของ maio เวอร์ชัน 1.1.6.0
- รองรับอะแดปเตอร์ maio iOS เวอร์ชัน 1.4.2.0
เวอร์ชัน 1.2.1
- รองรับอะแดปเตอร์ Android ของ maio เวอร์ชัน 1.1.6.0
- รองรับอะแดปเตอร์ maio iOS เวอร์ชัน 1.4.1.0
เวอร์ชัน 1.2.0
- รองรับอะแดปเตอร์ Android ของ maio เวอร์ชัน 1.1.4.1
- รองรับอะแดปเตอร์ maio iOS เวอร์ชัน 1.4.0.0
เวอร์ชัน 1.1.3
- รองรับอะแดปเตอร์ Android ของ maio เวอร์ชัน 1.1.3.1
- รองรับอะแดปเตอร์ iOS ของ maio เวอร์ชัน 1.3.2.0
เวอร์ชัน 1.1.2
- รองรับอะแดปเตอร์ maio สำหรับ Android เวอร์ชัน 1.1.3.0
- รองรับอะแดปเตอร์ maio iOS เวอร์ชัน 1.3.2.0
เวอร์ชัน 1.1.1
- รองรับ maio Android Adapter เวอร์ชัน 1.1.1.0
- รองรับอะแดปเตอร์ maio iOS เวอร์ชัน 1.3.1.1
เวอร์ชัน 1.1.0
- รองรับมาดัดแปลง Android ของ maio เวอร์ชัน 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
- รองรับ iOS SDK ของ maio เวอร์ชัน 1.2.18