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

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

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

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

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

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

ข้อกำหนด

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

• Google Mobile Ads SDK เวอร์ชันล่าสุด

• สื่อกลางเสร็จสมบูรณ์ คู่มือเริ่มต้นใช้งาน

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

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

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

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

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

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

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

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

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

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

ในหน้าการจัดการโซน ให้จดบันทึกรหัสโซน นอกจากนี้ คุณยังต้องใช้รหัสนี้ในการตั้งค่าหน่วยโฆษณา Ad Manager ในส่วนถัดไปด้วย

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

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

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

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

ลงชื่อเข้าใช้บัญชี Ad Manager

ไปที่การแสดงโฆษณา > กลุ่มผลตอบแทน แล้วคลิกปุ่มกลุ่มผลตอบแทนใหม่

ป้อนชื่อที่ไม่ซ้ำกันสําหรับกลุ่มผลตอบแทน ตั้งค่าสถานะเป็นใช้งานอยู่ เลือกรูปแบบโฆษณา และตั้งค่าประเภทพื้นที่โฆษณาเป็นแอปบนอุปกรณ์เคลื่อนที่ ในส่วนการกําหนดเป้าหมาย > พื้นที่โฆษณา ให้เลือกหน่วยโฆษณาในส่วนพื้นที่โฆษณาและแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ที่ต้องการเพิ่มสื่อกลาง

จากนั้นคลิกปุ่มเพิ่มพาร์ทเนอร์ผลตอบแทน

หากมีพาร์ทเนอร์ผลตอบแทนสำหรับ MAIO อยู่แล้ว คุณจะเลือกพาร์ทเนอร์รายนั้นได้ หรือเลือกสร้างพาร์ทเนอร์ผลตอบแทนใหม่

เลือก maio เป็นเครือข่ายโฆษณา ป้อนชื่อที่ไม่ซ้ำกัน และเปิดใช้สื่อกลาง

เปิดการเก็บรวบรวมข้อมูลอัตโนมัติ แล้วป้อนรหัส API และคีย์ API ที่ได้จากส่วนก่อนหน้า

เมื่อเลือกพาร์ทเนอร์ผลตอบแทนแล้ว ให้เลือกสื่อกลาง SDK บนอุปกรณ์เคลื่อนที่เป็นประเภทการผสานรวม เลือก iOS เป็นแพลตฟอร์ม และเลือกใช้งานอยู่เป็นสถานะ ป้อนรหัสสื่อและรหัสโซนที่ได้ในส่วนก่อนหน้า จากนั้นป้อนค่า CPM เริ่มต้น

สำคัญ: รหัสสื่อต้องเชื่อมโยงกับแอปเป้าหมายเช่นเดียวกับใน UI ของ Maio

คลิกบันทึกที่ด้านล่างของหน้าเมื่อดำเนินการเสร็จ

หมายเหตุ: การรวบรวมข้อมูลอัตโนมัติต้องใช้เวลารวบรวมข้อมูล 2-3 วันก่อนที่จะคำนวณค่า CPM แบบไดนามิกสำหรับเครือข่ายสื่อกลางได้อย่างแม่นยำ เมื่อคำนวณ eCPM ได้แล้ว ระบบจะอัปเดตข้อมูลในนามของคุณโดยอัตโนมัติ

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

หมายเหตุ: การไม่ผสานรวม Maio เวอร์ชันที่เข้ากันได้กับ Google Mobile Ads SDK อาจทําให้เกิดปัญหาการสร้าง

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

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

  pod 'GoogleMobileAdsMediationMaio'
  

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

  pod install --repo-update

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

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

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

การผสานรวม SKAdNetwork

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

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

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

ตรวจสอบว่าคุณได้ลงทะเบียนอุปกรณ์ทดสอบสําหรับ Ad Manager แล้ว

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

สำคัญ: ปิดใช้โหมดทดสอบสําหรับ Ad Manager และ 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

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