คู่มือนี้จะแสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดง โฆษณาจาก maio โดยใช้สื่อกลาง ซึ่งครอบคลุมการผสานรวมแบบน้ำตก โดยจะครอบคลุมวิธีเพิ่ม maio ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม SDK และอะแดปเตอร์ของ maio เข้ากับแอป iOS
อินเทอร์เฟซแดชบอร์ดของ maio ใช้ข้อความภาษาญี่ปุ่นสำหรับป้ายกำกับ ปุ่ม และคำอธิบาย และภาพหน้าจอในคู่มือนี้ยังไม่ได้แปล อย่างไรก็ตาม ในคำอธิบายและวิธีการของคู่มือนี้ เราจะอ้างอิงป้ายกำกับและปุ่มด้วยคำภาษาอังกฤษที่เทียบเท่า เช่น "URL スキーム" คือ "URL Scheme"
การผสานรวมและรูปแบบโฆษณาที่รองรับ
Ad Mediation Adapter สำหรับ maio มีความสามารถต่อไปนี้
| การผสานรวม | |
|---|---|
| การเสนอราคา | |
| น้ำตก | |
| รูปแบบ | |
| ป้ายประกาศ | |
| โฆษณาคั่นระหว่างหน้า | |
| ได้รับรางวัลแล้ว | |
| เนทีฟ | |
ข้อกำหนด
- เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
Google Mobile Ads SDK เวอร์ชันล่าสุด
ทําตามคู่มือเริ่มต้นใช้งานสื่อกลาง
ขั้นตอนที่ 1: ตั้งค่าใน UI ของ maio
ก่อนอื่น ให้ลงชื่อสมัครใช้ หรือเข้าสู่ระบบบัญชี maio คลิกปุ่มการจัดการแอปพลิเคชันในแถบด้านข้างซ้าย แล้วคลิกแอปใหม่
เลือกแท็บที่สอดคล้องกับประเภทโฆษณาที่คุณต้องการ
โฆษณาคั่นระหว่างหน้า
ป้อนชื่อแอป เลือกแพลตฟอร์ม และระบุURL ของแอป เลือกโฆษณาวิดีโอคั่นระหว่างหน้าเป็นประเภทโฆษณา แล้ว คลิกอัปเดต
ได้รับรางวัลแล้ว
ป้อนชื่อแอป เลือกแพลตฟอร์ม และระบุURL ของแอป เลือกโฆษณาวิดีโอที่มีการให้รางวัลเป็นประเภทโฆษณา แล้วคลิกอัปเดต
ในหน้าการจัดการแอปพลิเคชัน ให้จดรหัสสื่อไว้ คุณต้องมีรหัสนี้เพื่อตั้งค่าหน่วยโฆษณา Ad Manager ในส่วนถัดไป
ในหน้าการจัดการโซน ให้จดรหัสโซน นอกจากนี้ คุณยังต้องใช้รหัสนี้เพื่อตั้งค่าหน่วยโฆษณา Ad Manager ในส่วนถัดไปด้วย
ขั้นตอนที่ 2: ตั้งค่าดีมานด์ของ maio ใน UI ของ Ad Manager
กำหนดค่าการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา
ลงชื่อเข้าใช้บัญชี Ad Manager
ไปที่การแสดงโฆษณา > กลุ่มผลตอบแทน แล้วคลิกปุ่มกลุ่มผลตอบแทนใหม่
ป้อนชื่อที่ไม่ซ้ำกันสำหรับกลุ่มผลตอบแทน ตั้งสถานะเป็นใช้งานอยู่ เลือกรูปแบบโฆษณา และตั้งประเภทพื้นที่โฆษณาเป็นแอปบนอุปกรณ์เคลื่อนที่ ในส่วนการกำหนดเป้าหมาย > พื้นที่โฆษณา ให้เลือกหน่วยโฆษณาในส่วน พื้นที่โฆษณาและแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ที่คุณต้องการเพิ่มสื่อกลาง
จากนั้นคลิกปุ่มเพิ่มพาร์ทเนอร์ผลตอบแทน
หากมีพาร์ทเนอร์ผลตอบแทนสำหรับ maio อยู่แล้ว ให้เลือกพาร์ทเนอร์นั้น หรือเลือกสร้างพาร์ทเนอร์ผลตอบแทนใหม่
เลือก maio เป็นเครือข่ายโฆษณา ป้อนชื่อที่ไม่ซ้ำกัน แล้วเปิดใช้สื่อกลาง
เปิดการเก็บรวบรวมข้อมูลอัตโนมัติ แล้วป้อน รหัส API และคีย์ API ที่ได้รับในส่วนก่อนหน้า
เมื่อเลือกพาร์ทเนอร์ผลตอบแทนแล้ว ให้เลือกสื่อกลาง SDK บนอุปกรณ์เคลื่อนที่ เป็นประเภทการผสานรวม เลือก iOS เป็น แพลตฟอร์ม และเลือกใช้งานอยู่เป็นสถานะ ป้อนรหัสสื่อและรหัสโซน ที่ได้รับในส่วนก่อนหน้า จากนั้นป้อนค่า CPM เริ่มต้น
คลิกบันทึกที่ด้านล่างของหน้าเมื่อดำเนินการเสร็จ
ขั้นตอนที่ 3: นำเข้า SDK และอะแดปเตอร์ของ maio
การใช้ CocoaPods (แนะนำ)
เพิ่มบรรทัดต่อไปนี้ลงใน Podfile ของโปรเจ็กต์
pod 'GoogleMobileAdsMediationMaio'จากบรรทัดคำสั่ง ให้เรียกใช้คำสั่งต่อไปนี้
pod install --repo-update
การผสานรวมด้วยตนเอง
- ดาวน์โหลด SDK ของ MAIO เวอร์ชันล่าสุด
- ดาวน์โหลดอะแดปเตอร์ maio เวอร์ชันล่าสุดจากลิงก์ดาวน์โหลดใน
บันทึกการเปลี่ยนแปลง
และลิงก์
maioAdapter.frameworkในโปรเจ็กต์
ขั้นตอนที่ 4: เพิ่มโค้ดที่จำเป็น
การผสานรวม SKAdNetwork
ทําตามเอกสารประกอบของ maio
เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist ของโปรเจ็กต์
ขั้นตอนที่ 5: ทดสอบการติดตั้งใช้งาน
เปิดใช้โฆษณาทดสอบ
ตรวจสอบว่าคุณได้ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ Ad Manager
ผู้เผยแพร่โฆษณาที่ใช้ Google Mobile Ads SDK เวอร์ชัน 7.26.0 ขึ้นไปจะ ได้รับโฆษณาทดสอบจาก maio โดยอัตโนมัติในโทรศัพท์และแท็บเล็ตที่ลงทะเบียนเป็นอุปกรณ์ทดสอบ เมื่อส่งคำขอ
ยืนยันโฆษณาทดสอบ
หากต้องการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก maio ให้เปิดใช้การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้แหล่งที่มาของโฆษณา maio (Waterfall)
รหัสข้อผิดพลาด
หากอแดปเตอร์ไม่ได้รับโฆษณาจาก maio
ผู้เผยแพร่โฆษณาสามารถตรวจสอบข้อผิดพลาดพื้นฐานจากการตอบกลับโฆษณาได้โดยใช้
GADResponseInfo.adNetworkInfoArray
ภายใต้คลาสต่อไปนี้
| รูปแบบ | ชื่อชั้นเรียน |
|---|---|
| โฆษณาคั่นระหว่างหน้า | GADMMaioInterstitialAdapter |
| ได้รับรางวัลแล้ว | GADMMaioRewardedAdapter |
รหัสและข้อความที่มาพร้อมกันซึ่งอะแดปเตอร์ maio แสดงเมื่อโหลดโฆษณาไม่สำเร็จมีดังนี้
| รหัสข้อผิดพลาด | เหตุผล |
|---|---|
| 0-10 | maio แสดงข้อผิดพลาดเฉพาะ SDK ดูรายละเอียดเพิ่มเติมได้ที่ โค้ดของ maio |
| 101 | maio ยังไม่มีโฆษณาให้แสดง |
| 102 | พารามิเตอร์เซิร์ฟเวอร์ไม่ถูกต้อง (เช่น ไม่มีรหัสตําแหน่ง) |
| 103 | อแดปเตอร์ maio ไม่รองรับรูปแบบโฆษณาที่ขอ |
| 104 | มีการโหลดโฆษณาสำหรับการกำหนดค่าเครือข่ายนี้แล้ว |
บันทึกการเปลี่ยนแปลงของตัวกลาง iOS ของ maio
เวอร์ชันถัดไป
- เปิดใช้ -fobjc-arc และ -fstack-protector-all
เวอร์ชัน 2.1.6.1
- ตอนนี้ต้องใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 12.0.0 ขึ้นไป
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 12.0.0
- Maio SDK เวอร์ชัน 2.1.6
เวอร์ชัน 2.1.6.0
- ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 2.1.6
สร้างและทดสอบด้วย
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 11.13.0
- Maio SDK เวอร์ชัน 2.1.6
เวอร์ชัน 2.1.5.1
- อัปเดต
CFBundleShortVersionStringให้มี 3 องค์ประกอบแทน 4 องค์ประกอบ
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 11.10.0
- Maio SDK เวอร์ชัน 2.1.5
เวอร์ชัน 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
- อัปเดตอแดปเตอร์เพื่อใช้
didRewardUserAPI - ตอนนี้ต้องใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 9.8.0 ขึ้นไป
- ได้รับการยืนยันว่าใช้งานร่วมกับ SDK ของ maio เวอร์ชัน 1.6.3 และ SDK ของ maioOB เวอร์ชัน 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
- ได้รับการยืนยันว่าใช้งานร่วมกับ SDK ของ maio เวอร์ชัน 1.6.2 และ SDK ของ maioOB เวอร์ชัน 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
- ยืนยันความเข้ากันได้กับ SDK ของ maio เวอร์ชัน 1.6.1 และ SDK ของ maioOB เวอร์ชัน 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
- ได้รับการยืนยันว่าใช้งานร่วมกับ SDK ของ maio เวอร์ชัน 1.6.0 และ SDK ของ maioOB เวอร์ชัน 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 ขึ้นไป
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 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 ขึ้นไป
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 7.64.0
- Maio SDK เวอร์ชัน 1.5.5
เวอร์ชัน 1.5.4.0
- ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 1.5.4
- ตอนนี้ต้องใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 7.60.0 ขึ้นไป
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 7.60.0
- Maio SDK เวอร์ชัน 1.5.4
เวอร์ชัน 1.5.3.1
- เพื่อจำกัดการหมดเวลา ตอนนี้คำขอโฆษณาจะล้มเหลวทันทีหาก maio ไม่มีโฆษณาที่พร้อมแสดง
- ยกเลิกการรองรับสถาปัตยกรรม i386
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 7.58.0
- Maio SDK เวอร์ชัน 1.5.3
เวอร์ชัน 1.5.3.0
- ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 1.5.3
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 7.55.1
- Maio SDK เวอร์ชัน 1.5.3
เวอร์ชัน 1.5.2.1
- แก้ไขปัญหาที่อแดปเตอร์ไม่เรียกใช้แฮนเดิล
-rewardedAdDidPresent:
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 7.53.1
- Maio SDK เวอร์ชัน 1.5.2
เวอร์ชัน 1.5.2.0
- ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 1.5.2
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 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
- SDK โฆษณาของ Maio เวอร์ชัน 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
- ยืนยันความเข้ากันได้กับ SDK ของ maio เวอร์ชัน 1.4.0
เวอร์ชัน 1.3.2.0
- ได้รับการยืนยันว่าเข้ากันได้กับ SDK ของ maio เวอร์ชัน 1.3.2
เวอร์ชัน 1.3.1.1
- เพิ่มการเรียกกลับ
adapterDidCompletePlayingRewardBasedVideoAd:ไปยังอะแดปเตอร์
เวอร์ชัน 1.3.1.0
- ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 1.3.1
เวอร์ชัน 1.3.0.0
- ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 1.3.0
เวอร์ชัน 1.2.19.0
- ยืนยันความเข้ากันได้กับ SDK ของ maio เวอร์ชัน 1.2.19
เวอร์ชัน 1.2.18.0
- เปิดตัวครั้งแรก
- เพิ่มการรองรับโฆษณาคั่นระหว่างหน้าและโฆษณาวิดีโอที่มีการให้รางวัล