คู่มือนี้จะแสดงวิธีใช้ Google Mobile Ads SDK เพื่อโหลดและแสดงโฆษณาจาก Maio โดยใช้ Mediation ของ 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 ในส่วนถัดไปด้วย
(Waterfall เท่านั้น) นอกจากรหัสสื่อและรหัสโซนแล้ว คุณจะต้องมีรหัส API และคีย์ API เพื่อตั้งค่ารหัสหน่วยโฆษณาสําหรับสื่อกลาง ในหน้า Reporting API ให้จดบันทึกรหัส API และคีย์ APIขั้นตอนที่ 2: ตั้งค่าดีมานด์ใน UI ของ AdMob
กำหนดการตั้งค่าสื่อกลางสําหรับหน่วยโฆษณา
คุณต้องเพิ่ม Maio ในการกําหนดค่าสื่อกลางสําหรับหน่วยโฆษณา
ก่อนอื่น ให้ลงชื่อเข้าใช้บัญชี AdMob จากนั้นไปที่แท็บสื่อกลาง หากมีกลุ่มสื่อกลางที่มีอยู่ซึ่งต้องการแก้ไข ให้คลิกชื่อกลุ่มสื่อกลางนั้นเพื่อแก้ไข แล้วข้ามไปเพิ่ม Maio เป็นแหล่งที่มาของโฆษณา
หากต้องการสร้างกลุ่มสื่อกลางใหม่ ให้เลือกสร้างกลุ่มสื่อกลาง
ป้อนรูปแบบโฆษณาและแพลตฟอร์ม แล้วคลิกต่อไป
ตั้งชื่อกลุ่มสื่อกลาง แล้วเลือกสถานที่ที่จะกําหนดเป้าหมาย ถัดไป ให้ตั้งค่าสถานะกลุ่มสื่อกลางเป็นเปิดใช้ แล้วคลิกเพิ่มหน่วยโฆษณา
เชื่อมโยงกลุ่มสื่อกลางนี้กับหน่วยโฆษณา AdMob ที่มีอยู่อย่างน้อย 1 หน่วย จากนั้นคลิกเสร็จสิ้น
ตอนนี้คุณควรเห็นการ์ดหน่วยโฆษณาที่สร้างขึ้นด้วยหน่วยโฆษณาที่คุณเลือก
เพิ่ม Maio เป็นแหล่งที่มาของโฆษณา
เลือกเพิ่มแหล่งที่มาของโฆษณาในการ์ด Waterfall ในส่วนแหล่งที่มาของโฆษณา จากนั้นเลือก maio
เลือก maio แล้วเปิดใช้สวิตช์เพิ่มประสิทธิภาพ ป้อนรหัส API และคีย์ API ที่ได้ในส่วนก่อนหน้าเพื่อตั้งค่าการเพิ่มประสิทธิภาพแหล่งที่มาของโฆษณาสําหรับ maiol จากนั้นป้อนมูลค่า eCPM สำหรับ maiol แล้วคลิกต่อไป
หากมีการแมปสำหรับ Magento อยู่แล้ว คุณจะเลือกการแมปนั้นได้ หรือคลิกเพิ่มการแมป
จากนั้นป้อนรหัสสื่อและรหัสโซนที่ได้ในส่วนก่อนหน้า จากนั้นคลิกเสร็จสิ้น
ขั้นตอนที่ 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
- อัปเดตอะแดปเตอร์ให้ใช้
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
- ผ่านการรับรองความเข้ากันได้กับ 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
- เพิ่มความสามารถในการเสนอราคาลงในอะแดปเตอร์สําหรับรูปแบบโฆษณาคั่นระหว่างหน้าและโฆษณาที่มีการให้รางวัล
- ลดความจําเป็นในการใช้ Google Mobile Ads SDK เวอร์ชัน 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
- 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
- ฉบับแรก
- เพิ่มการรองรับโฆษณาคั่นระหว่างหน้าและโฆษณาวิดีโอที่มีการให้รางวัล