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

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

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

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

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

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

ข้อกำหนด

• เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
• [สำหรับการเสนอราคา]: อะแดปเตอร์ maio 1.5.8.0 ขึ้นไป (แนะนำให้ใช้เวอร์ชันล่าสุด)

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

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

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

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

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

โฆษณาคั่นระหว่างหน้า

ป้อนชื่อของแอป เลือกแพลตฟอร์ม และระบุ URL ของแอป เลือกประเภทโฆษณาเป็นโฆษณาวิดีโอคั่นระหว่างหน้า แล้วคลิกอัปเดต

Android

iOS

หมายเหตุ: โฆษณาคั่นระหว่างหน้าจาก maio จะข้ามได้โดยค่าเริ่มต้น

ได้รับรางวัลแล้ว

ป้อนชื่อของแอป เลือกแพลตฟอร์ม และระบุ URL ของแอป เลือกรางวัลวิดีโอเป็นประเภทโฆษณา แล้วคลิกอัปเดต

Android

iOS

หมายเหตุ: โดยค่าเริ่มต้น โฆษณาวิดีโอที่มีการให้รางวัลจาก maio จะไม่ข้ามได้

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

Android

iOS

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

Android

iOS

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

หมายเหตุ: (Waterfall เท่านั้น) หากนี่เป็นครั้งแรกที่คุณตั้งค่าบัญชี Maio คุณอาจต้องติดต่อทีมสนับสนุนของ Maio เพื่อขอรหัส API และ API KEY ให้คุณ

ขั้นตอนที่ 2: ตั้งค่าดีมานด์ Macio ใน AdMob UI

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

Android

ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสําหรับ Android

iOS

โปรดดูวิธีการในขั้นตอนที่ 2 ในคู่มือสำหรับ iOS

ขั้นตอนที่ 3: นำเข้า SDK และอะแดปเตอร์ Maio

หมายเหตุ: การไม่ผสานรวมเวอร์ชัน maio ที่เข้ากันได้และ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google อาจทำให้เกิดปัญหาเกี่ยวกับการสร้างได้

การใช้ CocoaPods (แนะนำ)

• เพิ่มบรรทัดต่อไปนี้ลงใน Podfile ของโปรเจ็กต์

  pod 'GoogleMobileAdsMediationMaio'
  

• จากการเรียกใช้บรรทัดคำสั่ง ให้ทำดังนี้

  pod install --repo-update

การผสานรวมด้วยตนเอง

• ดาวน์โหลด maio SDK เวอร์ชันล่าสุด
• ดาวน์โหลดอะแดปเตอร์ Maio เวอร์ชันล่าสุดจากลิงก์ดาวน์โหลดใน Changelog และลิงก์ maioAdapter.framework ในโปรเจ็กต์

ขั้นตอนที่ 4: เพิ่มโค้ดที่จำเป็น

การผสานรวม SKAdNetwork

ทำตามเอกสารประกอบของ maio เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist ของโปรเจ็กต์

ขั้นตอนที่ 5: ทดสอบการใช้งาน

เปิดใช้โฆษณาทดสอบ

อย่าลืม ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ AdMob

ผู้เผยแพร่โฆษณาที่ใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 7.26.0 ขึ้นไปจะได้รับโฆษณาทดสอบจาก maio โดยอัตโนมัติในโทรศัพท์และแท็บเล็ตที่ลงทะเบียนเป็นอุปกรณ์ทดสอบเมื่อส่งคําขอ

สำคัญ: ปิดใช้โหมดทดสอบสำหรับ AdMob และ 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	มีการโหลดโฆษณาสำหรับการกำหนดค่าเครือข่ายนี้แล้ว

บันทึกการเปลี่ยนแปลงอะแดปเตอร์สื่อกลาง iOS ของ maio

เวอร์ชัน 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 และ 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

• ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 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

• ยืนยันความเข้ากันได้กับ 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 และ 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
• เพิ่มความสามารถในการเสนอราคาให้กับอะแดปเตอร์สำหรับรูปแบบโฆษณาคั่นระหว่างหน้าและโฆษณาที่มีการให้รางวัล
• ผู้ใช้ไม่ใช้ 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

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