คู่มือนี้แสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดง โฆษณาจาก maio ที่ใช้ สื่อกลาง ซึ่งครอบคลุมการผสานรวม Waterfall ซึ่งครอบคลุมถึงวิธีเพิ่ม maio ลงในหน่วยโฆษณา การกำหนดค่าสื่อกลาง และวิธีผสานรวม maio SDK และอะแดปเตอร์ แอป
อินเทอร์เฟซแดชบอร์ดสำหรับ maio จะใช้ข้อความภาษาญี่ปุ่นสำหรับป้ายกำกับ ปุ่มต่างๆ และคำอธิบาย รวมทั้งภาพหน้าจอในคู่มือนี้ยังไม่ได้รับการแปล แต่ในคำอธิบายและวิธีการของคู่มือนี้ ป้ายกำกับและปุ่ม อ้างอิงด้วยภาษาอังกฤษที่เทียบเท่ากัน "URL 東キーム" ตัวอย่างเช่น คือ "รูปแบบ URL"
การผสานรวมและรูปแบบโฆษณาที่รองรับ
อะแดปเตอร์สื่อกลางสำหรับ maio มีความสามารถต่อไปนี้
การผสานรวม | |
---|---|
การเสนอราคา | |
น้ำตก | |
รูปแบบ | |
แบนเนอร์ | |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว | |
เนทีฟ |
ข้อกำหนด
- เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุด
ดำเนินการสื่อกลางให้เสร็จสิ้น คู่มือเริ่มต้นใช้งาน
ขั้นตอนที่ 1: ตั้งค่าการกำหนดค่าใน UI ของ maio
ขั้นตอนที่ 2: ตั้งค่าดีมานด์ maio ใน Ad Manager UI
กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา
Android
ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสําหรับ Android
iOS
โปรดดูวิธีการในขั้นตอนที่ 2 ในคู่มือสำหรับ iOS
ขั้นตอนที่ 3: นำเข้า maio SDK และอะแดปเตอร์
การใช้ CocoaPods (แนะนำ)
เพิ่มบรรทัดต่อไปนี้ลงใน Podfile ของโปรเจ็กต์
pod 'GoogleMobileAdsMediationMaio'
จากบรรทัดคำสั่งให้เรียกใช้คำสั่งต่อไปนี้
pod install --repo-update
การผสานรวมด้วยตนเอง
- ดาวน์โหลดเวอร์ชันล่าสุดของ maio SDK
- ดาวน์โหลดอะแดปเตอร์ maio เวอร์ชันล่าสุดจากลิงก์ดาวน์โหลดใน
บันทึกการเปลี่ยนแปลง
และลิงก์
maioAdapter.framework
ในโปรเจ็กต์
ขั้นตอนที่ 4: เพิ่มโค้ดที่จําเป็น
การผสานรวม SKAdNetwork
ทำตามเอกสารประกอบของ maio
เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist
ของโปรเจ็กต์
ขั้นตอนที่ 5: ทดสอบการใช้งาน
เปิดใช้โฆษณาทดสอบ
อย่าลืม ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ Ad Manager
ผู้เผยแพร่โฆษณาที่ใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 7.26.0 ขึ้นไปจะได้รับโฆษณาทดสอบจาก maio โดยอัตโนมัติในโทรศัพท์และแท็บเล็ตที่ลงทะเบียนเป็นอุปกรณ์ทดสอบเมื่อส่งคําขอ
ยืนยันโฆษณาทดสอบ
ในการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก maio ให้เปิดใช้ การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้ maio (Waterfall) แหล่งที่มาของโฆษณา
รหัสข้อผิดพลาด
หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก maio
ผู้เผยแพร่โฆษณาสามารถตรวจสอบข้อผิดพลาดที่แท้จริงจากการตอบกลับโฆษณาโดยใช้
GADResponseInfo.adNetworkInfoArray
ในคลาสต่อไปนี้
รูปแบบ | ชื่อชั้นเรียน |
---|---|
โฆษณาคั่นระหว่างหน้า | GADMMaioInterstitialAdapter |
ได้รับรางวัลแล้ว | GADMMaioRewardedAdapter |
ต่อไปนี้เป็นโค้ดและข้อความประกอบที่อะแดปเตอร์ maio ส่งเข้ามาเมื่อโฆษณาโหลดไม่สำเร็จ
รหัสข้อผิดพลาด | เหตุผล |
---|---|
0-10 | maio แสดงข้อผิดพลาดเกี่ยวกับ SDK โดยเฉพาะ โปรดดู รหัสของ maio เพื่อดูรายละเอียดเพิ่มเติม |
101 | maio ยังไม่มีโฆษณา |
102 | พารามิเตอร์เซิร์ฟเวอร์ไม่ถูกต้อง (เช่น ไม่มีรหัสตำแหน่ง) |
103 | อะแดปเตอร์ maio ไม่รองรับรูปแบบโฆษณาที่ขอ |
104 | โหลดโฆษณาสำหรับการกำหนดค่าเครือข่ายนี้แล้ว |
บันทึกการเปลี่ยนแปลงอะแดปเตอร์สื่อกลาง maio iOS
เวอร์ชัน 2.1.5.0
- ตรวจสอบความเข้ากันได้กับ maio SDK เวอร์ชัน 2.1.5 แล้ว
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 11.6.0
- Maio SDK เวอร์ชัน 2.1.5
เวอร์ชัน 2.1.4.0
- ตรวจสอบความเข้ากันได้กับ maio SDK เวอร์ชัน 2.1.4 แล้ว
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 11.2.0
- Maio SDK เวอร์ชัน 2.1.4
เวอร์ชัน 2.1.3.0
- ตรวจสอบความเข้ากันได้กับ maio SDK เวอร์ชัน 2.1.3 แล้ว
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 11.1.0
- Maio SDK เวอร์ชัน 2.1.3
เวอร์ชัน 2.1.2.1
- ตอนนี้ต้องใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 11.0 ขึ้นไป
- รวม
Info.plist
ไว้ในเฟรมเวิร์กภายในMaioAdapter.xcframework
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 11.0.1
- Maio SDK เวอร์ชัน 2.1.2
เวอร์ชัน 2.1.2.0
- ตรวจสอบความเข้ากันได้กับ maio SDK เวอร์ชัน 2.1.2 แล้ว
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 10.14.0
- Maio SDK เวอร์ชัน 2.1.2
เวอร์ชัน 2.1.1.0
- ตรวจสอบความเข้ากันได้กับ maio SDK เวอร์ชัน 2.1.1 แล้ว
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 10.12.0
- Maio SDK เวอร์ชัน 2.1.1
เวอร์ชัน 2.0.0.0
- ตรวจสอบความเข้ากันได้กับ maio SDK เวอร์ชัน 2.0.0 แล้ว
- นำการอ้างอิงออกจาก
MaioOB SDK
แล้ว - นำการรองรับสถาปัตยกรรม
armv7
ออกแล้ว - ตอนนี้ต้องใช้ iOS เวอร์ชัน 12.0 ขึ้นไป
- ตอนนี้ต้องใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 10.4.0 ขึ้นไป
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 10.10.0
- Maio SDK เวอร์ชัน 2.0.0
เวอร์ชัน 1.6.3.1
- ตอนนี้ต้องใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 10.0.0 ขึ้นไป
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 10.0.0
- Maio SDK เวอร์ชัน 1.6.3
- MaioOB SDK เวอร์ชัน 2.0.0-alpha
เวอร์ชัน 1.6.3.0
- อัปเดตอะแดปเตอร์เพื่อใช้
didRewardUser
API แล้ว - ตอนนี้ต้องใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 9.8.0 ขึ้นไป
- ตรวจสอบความเข้ากันได้กับ maio SDK เวอร์ชัน 1.6.3 และ maioOB SDK เวอร์ชัน 2.0.0-alpha แล้ว
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 9.12.0
- Maio SDK เวอร์ชัน 1.6.3
- MaioOB SDK เวอร์ชัน 2.0.0-alpha
เวอร์ชัน 1.6.2.0
- ตรวจสอบความเข้ากันได้กับ maio SDK เวอร์ชัน 1.6.2 และ maioOB SDK เวอร์ชัน 2.0.0-alpha แล้ว
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 9.5.0
- Maio SDK เวอร์ชัน 1.6.2
- MaioOB SDK เวอร์ชัน 2.0.0-alpha
เวอร์ชัน 1.6.1.0
- ตรวจสอบความเข้ากันได้กับ maio SDK เวอร์ชัน 1.6.1 และ maioOB SDK เวอร์ชัน 2.0.0-alpha แล้ว
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 9.2.0
- Maio SDK เวอร์ชัน 1.6.1
- MaioOB SDK เวอร์ชัน 2.0.0-alpha
เวอร์ชัน 1.6.0.1
- ยืนยันความเข้ากันได้กับ Google Mobile Ads SDK เวอร์ชัน 9.0.0 แล้ว
- ตอนนี้ต้องใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 9.0.0 ขึ้นไป
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 9.0.0
- Maio SDK เวอร์ชัน 1.6.0
- MaioOB SDK เวอร์ชัน 2.0.0-alpha
เวอร์ชัน 1.6.0.0
- ตรวจสอบความเข้ากันได้กับ maio SDK เวอร์ชัน 1.6.0 และ maioOB SDK เวอร์ชัน 2.0.0-alpha แล้ว
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 8.13.0
- ขณะนี้ต้องใช้ iOS เวอร์ชัน 10.0 ขึ้นไป
- Maio SDK เวอร์ชัน 1.6.0
- MaioOB SDK เวอร์ชัน 2.0.0-alpha
เวอร์ชัน 1.5.8.0
- ตรวจสอบความเข้ากันได้กับ maio SDK เวอร์ชัน 1.5.8 และ maioOB SDK เวอร์ชัน 2.0.0-alpha แล้ว
- เพิ่มความสามารถในการเสนอราคาให้กับอะแดปเตอร์สำหรับรูปแบบโฆษณาคั่นระหว่างหน้าและโฆษณาที่มีการให้รางวัล
- อาศัย SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 8.0.0 ขึ้นไปอย่างไม่ผ่อนปรน
สร้างและทดสอบด้วย:
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 8.7.0
- Maio SDK เวอร์ชัน 1.5.8
- MaioOB SDK เวอร์ชัน 2.0.0-alpha
เวอร์ชัน 1.5.6.1
- เพิ่มรหัสและข้อความแสดงข้อผิดพลาดของอะแดปเตอร์มาตรฐานแล้ว
- อัปเดตอะแดปเตอร์ให้ใช้รูปแบบ
.xcframework
แล้ว - แก้ไขข้อบกพร่องที่บางครั้งไม่มีการส่งต่อกิจกรรมที่มีการให้รางวัล
- ตอนนี้ต้องใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 8.3.0 ขึ้นไป
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 8.3.0
- Maio SDK เวอร์ชัน 1.5.6
เวอร์ชัน 1.5.6.0
- ตรวจสอบความเข้ากันได้กับ maio SDK เวอร์ชัน 1.5.6 แล้ว
- ตอนนี้ต้องใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 7.68.0 ขึ้นไป
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 7.68.0
- Maio SDK เวอร์ชัน 1.5.6
เวอร์ชัน 1.5.5.0
- ตรวจสอบความเข้ากันได้กับ maio SDK เวอร์ชัน 1.5.5 แล้ว
- ตอนนี้ต้องใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 7.64.0 ขึ้นไป
สร้างและทดสอบด้วย:
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 7.64.0
- Maio SDK เวอร์ชัน 1.5.5
เวอร์ชัน 1.5.4.0
- ตรวจสอบความเข้ากันได้กับ maio SDK เวอร์ชัน 1.5.4 แล้ว
- ตอนนี้ต้องใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 7.60.0 ขึ้นไป
สร้างและทดสอบด้วย:
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 7.60.0
- Maio SDK เวอร์ชัน 1.5.4
เวอร์ชัน 1.5.3.1
- ในการจำกัดระยะหมดเวลา คำขอโฆษณาจะล้มเหลวทันทีหาก maio ไม่มีโฆษณาที่พร้อมแสดง
- ยกเลิกการสนับสนุนสถาปัตยกรรม i386
สร้างและทดสอบด้วย:
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 7.58.0
- Maio SDK เวอร์ชัน 1.5.3
เวอร์ชัน 1.5.3.0
- ตรวจสอบความเข้ากันได้กับ maio SDK เวอร์ชัน 1.5.3 แล้ว
สร้างและทดสอบด้วย:
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 7.55.1
- Maio SDK เวอร์ชัน 1.5.3
เวอร์ชัน 1.5.2.1
- แก้ไขปัญหาที่อะแดปเตอร์ไม่เรียกใช้ Callback
-rewardedAdDidPresent:
สร้างและทดสอบด้วย:
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 7.53.1
- Maio SDK เวอร์ชัน 1.5.2
เวอร์ชัน 1.5.2.0
- ตรวจสอบความเข้ากันได้กับ maio SDK เวอร์ชัน 1.5.2 แล้ว
สร้างและทดสอบด้วย:
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 7.53.1
- Maio SDK เวอร์ชัน 1.5.2
เวอร์ชัน 1.5.1.0
- ตรวจสอบความเข้ากันได้กับ maio SDK เวอร์ชัน 1.5.1 แล้ว
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 7.52.0
- Maio SDK เวอร์ชัน 1.5.1
เวอร์ชัน 1.5.0.0
- ตรวจสอบความเข้ากันได้กับ maio SDK เวอร์ชัน 1.5.0 แล้ว
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 7.51.0
- Maio Ads SDK เวอร์ชัน 1.5.0
เวอร์ชัน 1.4.8.0
- ตรวจสอบความเข้ากันได้กับ maio SDK เวอร์ชัน 1.4.8 แล้ว
เวอร์ชัน 1.4.6.0
- ตรวจสอบความเข้ากันได้กับ maio SDK เวอร์ชัน 1.4.6 แล้ว
- อัปเดตอะแดปเตอร์เพื่อใช้ API ที่มีการให้รางวัลใหม่
- ตอนนี้ต้องใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 7.42.2 ขึ้นไป
เวอร์ชัน 1.4.2.0
- ตรวจสอบความเข้ากันได้กับ maio SDK เวอร์ชัน 1.4.2 แล้ว
เวอร์ชัน 1.4.1.0
- ตรวจสอบความเข้ากันได้กับ maio SDK เวอร์ชัน 1.4.1 แล้ว
- แก้ไขปัญหาที่อะแดปเตอร์ maio อาจล้มเหลวหากมีการระบุ MediaId หลายรายการจาก AdMob
เวอร์ชัน 1.4.0.0
- ตรวจสอบความเข้ากันได้กับ maio SDK เวอร์ชัน 1.4.0 แล้ว
เวอร์ชัน 1.3.2.0
- ตรวจสอบความเข้ากันได้กับ maio SDK เวอร์ชัน 1.3.2 แล้ว
เวอร์ชัน 1.3.1.1
- เพิ่ม Callback
adapterDidCompletePlayingRewardBasedVideoAd:
ที่อะแดปเตอร์แล้ว
เวอร์ชัน 1.3.1.0
- ตรวจสอบความเข้ากันได้กับ maio SDK เวอร์ชัน 1.3.1 แล้ว
เวอร์ชัน 1.3.0.0
- ตรวจสอบความเข้ากันได้กับ maio SDK เวอร์ชัน 1.3.0 แล้ว
เวอร์ชัน 1.2.19.0
- ตรวจสอบความเข้ากันได้กับ maio SDK เวอร์ชัน 1.2.19 แล้ว
เวอร์ชัน 1.2.18.0
- เปิดตัวครั้งแรก
- เพิ่มการรองรับโฆษณาคั่นระหว่างหน้าและโฆษณาวิดีโอที่มีการให้รางวัล