ผสานรวม Maio กับสื่อกลาง

คู่มือนี้แสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดง โฆษณาจาก maio ที่ใช้ สื่อกลาง ซึ่งครอบคลุมการผสานรวม Waterfall ซึ่งครอบคลุมถึงวิธีเพิ่ม maio ลงในหน่วยโฆษณา การกำหนดค่าสื่อกลาง และวิธีผสานรวม maio SDK และอะแดปเตอร์ แอป

อินเทอร์เฟซแดชบอร์ดสำหรับ maio จะใช้ข้อความภาษาญี่ปุ่นสำหรับป้ายกำกับ ปุ่มต่างๆ และคำอธิบาย รวมทั้งภาพหน้าจอในคู่มือนี้ยังไม่ได้รับการแปล แต่ในคำอธิบายและวิธีการของคู่มือนี้ ป้ายกำกับและปุ่ม อ้างอิงด้วยภาษาอังกฤษที่เทียบเท่ากัน "URL 東キーム" ตัวอย่างเช่น คือ "รูปแบบ URL"

การผสานรวมและรูปแบบโฆษณาที่รองรับ

อะแดปเตอร์สื่อกลางสำหรับ maio มีความสามารถต่อไปนี้

การผสานรวม
การเสนอราคา
น้ำตก
รูปแบบ
แบนเนอร์
โฆษณาคั่นระหว่างหน้า
ได้รับรางวัลแล้ว
เนทีฟ

ข้อกำหนด

• เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป

• SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุด

• ดำเนินการสื่อกลางให้เสร็จสิ้น คู่มือเริ่มต้นใช้งาน

ขั้นตอนที่ 1: ตั้งค่าการกำหนดค่าใน UI ของ maio

ก่อนอื่น ให้ลงชื่อสมัครใช้หรือลงชื่อเข้าสู่ระบบบัญชี maio ของคุณ คลิกปุ่ม การจัดการแอปพลิเคชันในแถบด้านซ้าย แล้วคลิกแอปใหม่

เลือกแท็บประเภทโฆษณาที่ต้องการ

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

ในหน้า Zone Management ให้จดบันทึก Zone ID และยังเป็นสิ่งจำเป็นในการตั้งค่า Ad Manager หน่วยโฆษณาในส่วนถัดไปด้วย

(Waterfall เท่านั้น) นอกจากรหัสสื่อและรหัสโซนแล้ว คุณจะต้องใช้รหัส API และ API KEY เพื่อตั้งค่ารหัสหน่วยโฆษณาสำหรับสื่อกลางด้วย ในหน้า Reporting API ให้จดรหัส API และ API KEY

ขั้นตอนที่ 2: ตั้งค่าดีมานด์ maio ใน Ad Manager UI

กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา

ขั้นตอนที่ 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	บริบทที่ใช้ในการโหลดโฆษณาไม่ใช่อินสแตนซ์ "กิจกรรม"
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 ขึ้นไป

สร้างและทดสอบด้วย:

• SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 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

• เปิดตัวครั้งแรก
• เพิ่มการรองรับโฆษณาคั่นระหว่างหน้าและโฆษณาวิดีโอที่มีการให้รางวัล