คู่มือนี้จะแสดงวิธีใช้ Google Mobile Ads SDK เพื่อโหลดและแสดงโฆษณาจาก Maio โดยใช้ สื่อกลาง AdMob, ซึ่งครอบคลุมการผสานรวม Waterfall ซึ่งจะอธิบายวิธีเพิ่ม Maio ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม SDK และอะแดปเตอร์ของ Maio ลงในiOS แอป
อินเทอร์เฟซแดชบอร์ดสำหรับ Maio ใช้ข้อความภาษาญี่ปุ่นสำหรับป้ายกำกับ ปุ่ม และคำอธิบาย และภาพหน้าจอในคู่มือนี้ยังไม่ได้แปล อย่างไรก็ตาม คำอธิบายและวิธีการในคู่มือนี้จะอ้างอิงป้ายกำกับและปุ่มเป็นภาษาอังกฤษ เช่น "URL スキーム" หมายถึง "URL Scheme"
การผสานรวมและรูปแบบโฆษณาที่รองรับ
อะแดปเตอร์สื่อกลางสําหรับ Maio มีความสามารถดังต่อไปนี้
| การผสานรวม | |
|---|---|
| การเสนอราคา | |
| น้ำตก | |
| รูปแบบ | |
| แบนเนอร์ | |
| โฆษณาคั่นระหว่างหน้า | |
| ได้รับรางวัลแล้ว | |
| เนทีฟ | |
ข้อกำหนด
- เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
Google Mobile Ads SDK เวอร์ชันล่าสุด
ทำตามสื่อกลาง คู่มือเริ่มต้นใช้งาน
ขั้นตอนที่ 1: ตั้งค่าการกําหนดค่าใน UI ของ Maio
ก่อนอื่น ให้ลงชื่อสมัครใช้หรือเข้าสู่ระบบบัญชี Maio คลิกปุ่มการจัดการแอปพลิเคชันในแถบด้านข้างทางซ้าย แล้วคลิกแอปใหม่
เลือกแท็บที่สอดคล้องกับประเภทโฆษณาที่ต้องการ
โฆษณาคั่นระหว่างหน้า
ป้อนชื่อแอป เลือกแพลตฟอร์ม แล้วระบุURL ของแอป เลือกโฆษณาคั่นระหว่างหน้าแบบวิดีโอเป็นประเภทโฆษณา แล้วคลิกอัปเดต
ได้รับรางวัลแล้ว
ป้อนชื่อแอป เลือกแพลตฟอร์ม แล้วระบุURL ของแอป เลือก Video Rewards เป็นประเภทโฆษณา แล้วคลิกอัปเดต
ในหน้าการจัดการแอปพลิเคชัน ให้จดบันทึกรหัสสื่อ คุณต้องตั้งค่าหน่วยโฆษณา AdMob ในส่วนถัดไป
ในหน้าการจัดการโซน ให้จดบันทึกรหัสโซน นอกจากนี้ คุณยังต้องใช้รหัสนี้ในการตั้งค่าหน่วยโฆษณา AdMob ในส่วนถัดไปด้วย
ขั้นตอนที่ 2: ตั้งค่าดีมานด์ใน AdMob UI
กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา
คุณต้องเพิ่ม maio ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา
ก่อนอื่น ให้ลงชื่อเข้าใช้บัญชี AdMob จากนั้นไปที่แท็บสื่อกลาง หากมีกลุ่มสื่อกลางที่ต้องการแก้ไขอยู่แล้ว ให้คลิกชื่อกลุ่มสื่อกลางนั้นเพื่อแก้ไข แล้วข้ามไปที่หัวข้อเพิ่ม maio เป็นแหล่งที่มาของโฆษณา
หากต้องการสร้างกลุ่มสื่อกลางใหม่ ให้เลือกสร้างกลุ่มสื่อกลาง
ป้อนรูปแบบโฆษณาและแพลตฟอร์ม แล้วคลิกต่อไป
ตั้งชื่อกลุ่มสื่อกลาง แล้วเลือกสถานที่ตั้งที่จะกำหนดเป้าหมาย จากนั้นตั้งค่าสถานะกลุ่มสื่อกลางเป็นเปิดใช้ แล้วคลิกเพิ่มหน่วยโฆษณา
เชื่อมโยงกลุ่มสื่อกลางนี้กับหน่วยโฆษณาAdMob ที่มีอยู่อย่างน้อย 1 หน่วย จากนั้นคลิกเสร็จสิ้น
ตอนนี้คุณควรจะเห็นการ์ดหน่วยโฆษณาเต็มไปด้วยหน่วยโฆษณาที่คุณเลือกไว้ ดังนี้
เพิ่ม maio เป็นแหล่งที่มาของโฆษณา
ใต้การ์ด Waterfall ในส่วนแหล่งที่มาของโฆษณา ให้เลือกเพิ่มแหล่งที่มาของโฆษณา จากนั้นเลือก maio
เลือก maio และเปิดสวิตช์เพิ่มประสิทธิภาพ ป้อน API ID and API KEYที่ได้รับในส่วนก่อนหน้าเพื่อตั้งค่าการเพิ่มประสิทธิภาพแหล่งที่มาของโฆษณาสำหรับmaio จากนั้นป้อนค่า eCPM สำหรับ maio แล้วคลิกต่อไป
หากมีการแมปสำหรับ maioอยู่แล้ว ก็เลือกแผนที่นั้นได้ หรือคลิกเพิ่มการแมป
แล้วป้อน Media ID and Zone ID ที่ได้รับในส่วนก่อนหน้า จากนั้นคลิกเสร็จสิ้น
ขั้นตอนที่ 3: นําเข้า SDK และอะแดปเตอร์ของ Maio
การใช้ CocoaPods (แนะนำ)
เพิ่มบรรทัดต่อไปนี้ลงใน Podfile ของโปรเจ็กต์
pod 'GoogleMobileAdsMediationMaio'จากบรรทัดคำสั่ง ให้เรียกใช้คำสั่งต่อไปนี้
pod install --repo-update
การผสานรวมด้วยตนเอง
- ดาวน์โหลด maio SDK เวอร์ชันล่าสุด
- ดาวน์โหลดอะแดปเตอร์ Maio เวอร์ชันล่าสุดจากลิงก์ดาวน์โหลดในบันทึกการเปลี่ยนแปลง แล้วลิงก์
maioAdapter.frameworkในโปรเจ็กต์
ขั้นตอนที่ 4: เพิ่มโค้ดที่จำเป็น
การผสานรวม SKAdNetwork
ทำตามเอกสารประกอบของ Maio เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist ของโปรเจ็กต์
ขั้นตอนที่ 5: ทดสอบการใช้งาน
เปิดใช้โฆษณาทดสอบ
ตรวจสอบว่าคุณได้ลงทะเบียนอุปกรณ์ทดสอบสำหรับ AdMob แล้ว
ผู้เผยแพร่โฆษณาที่ใช้ 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
เวอร์ชัน 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 ขึ้นไป
- ยืนยันความเข้ากันได้กับ 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
- ผ่านการรับรองความเข้ากันได้กับ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 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 ขึ้นไปอย่างไม่ผ่อนปรน
สร้างขึ้นและทดสอบด้วย
- 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
สร้างและทดสอบด้วย:
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 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
- 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
- เพิ่มการเรียกกลับ
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
- ฉบับแรก
- เพิ่มการรองรับโฆษณาคั่นระหว่างหน้าและโฆษณาวิดีโอที่มีการให้รางวัล