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

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

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

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

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

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

ข้อกำหนด

  • Unity 4 ขึ้นไป
  • SDK โฆษณาบนอุปกรณ์เคลื่อนที่ของ Google ล่าสุด
  • เพื่อทำให้ใช้งานได้ใน Android
    • Android API ระดับ 19 ขึ้นไป
  • เพื่อทำให้ใช้งานได้ใน iOS
    • เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
  • โปรเจ็กต์ Unity ที่ใช้งานได้ซึ่งกำหนดค่าด้วย SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google โปรดดูรายละเอียดในเริ่มต้นใช้งาน
  • ทำตามคู่มือเริ่มต้นใช้งานสื่อกลาง

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

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

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

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

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

Android

iOS

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

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

Android

iOS

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

Android

iOS

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

Android

iOS

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

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

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

Android

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

iOS

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

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

ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google สำหรับ maio เวอร์ชันล่าสุดจากลิงก์ดาวน์โหลดใน Changelog สำหรับ maio และแยก GoogleMobileAdsMaioMediation.unitypackage ออกจากไฟล์ ZIP

ในเครื่องมือแก้ไขโปรเจ็กต์ Unity ให้เลือกเนื้อหา > นำเข้าแพ็กเกจ > กำหนดเอง แพ็กเกจ แล้วค้นหาไฟล์ GoogleMobileAdsMaioMediation.unitypackage ที่คุณดาวน์โหลด ตรวจสอบว่าได้เลือกไฟล์ทั้งหมดแล้ว จากนั้นคลิกนำเข้า

จากนั้นเลือกเนื้อหา > ตัวแก้ไขบริการ Google Play > ตัวแก้ไข Android > บังคับให้แก้ไข ไลบรารีของตัวแปลค่าบริการ Google Play ของ Unity จะดำเนินการแก้ปัญหา Dependency ตั้งแต่ต้นและคัดลอกทรัพยากร Dependency ที่ประกาศไว้ในไดเรกทอรี Assets/Plugins/Android ของแอป Unity

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

Android

ไม่ต้องใช้รหัสเพิ่มเติมสำหรับการผสานการทำงาน maio

iOS

การผสานรวม SKAdNetwork

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

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

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

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

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

ยืนยันโฆษณาทดสอบ

ในการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก maio ให้เปิดใช้ การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้ maio (Bidding) and maio (Waterfall) แหล่งที่มาของโฆษณา

รหัสข้อผิดพลาด

หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก maio ผู้เผยแพร่โฆษณาจะตรวจสอบข้อผิดพลาดที่มีอยู่จากการตอบกลับโฆษณาได้โดยใช้ ResponseInfo ในคลาสต่อไปนี้

Android

รูปแบบ ชื่อชั้นเรียน
โฆษณาคั่นระหว่างหน้า jp.maio.sdk.android.mediation.admob.adapter.Interstitial
ได้รับรางวัลแล้ว jp.maio.sdk.android.mediation.admob.adapter.Rewarded

iOS

รูปแบบ ชื่อชั้นเรียน
โฆษณาคั่นระหว่างหน้า GADMMaioInterstitialAdapter
ได้รับรางวัลแล้ว GADMMaioRewardedAdapter

ต่อไปนี้คือรหัสและข้อความประกอบที่อะแดปเตอร์ maio ส่งไว้เมื่อโฆษณาโหลดไม่สำเร็จ

Android

รหัสข้อผิดพลาด เหตุผล
0-10 maio แสดงข้อผิดพลาดเกี่ยวกับ SDK โดยเฉพาะ ดูรายละเอียดเพิ่มเติมได้ที่รหัสและเอกสารของ maio
101 Maio ไม่มีโฆษณา
102 พารามิเตอร์เซิร์ฟเวอร์ไม่ถูกต้อง (เช่น ไม่มีรหัสตำแหน่งโฆษณา)
103 บริบทที่ใช้โหลดโฆษณาไม่ใช่อินสแตนซ์ "กิจกรรม"

iOS

รหัสข้อผิดพลาด เหตุผล
0-10 maio แสดงข้อผิดพลาดเกี่ยวกับ SDK โดยเฉพาะ ดูรายละเอียดเพิ่มเติมได้จากรหัสของ maio
101 maio ยังไม่มีโฆษณาให้บริการ
102 พารามิเตอร์เซิร์ฟเวอร์ไม่ถูกต้อง (เช่น ไม่มีรหัสตำแหน่งโฆษณา)
103 อะแดปเตอร์ Maio ไม่รองรับรูปแบบโฆษณาที่ขอ
104 มีการโหลดโฆษณาสำหรับการกำหนดค่าเครือข่ายนี้แล้ว

บันทึกการเปลี่ยนแปลงปลั๊กอิน Unity Mediation ของ maio

เวอร์ชัน 2.0.0

เวอร์ชัน 1.4.3

เวอร์ชัน 1.4.2

เวอร์ชัน 1.4.1

เวอร์ชัน 1.4.0

เวอร์ชัน 1.3.6

เวอร์ชัน 1.3.5

เวอร์ชัน 1.3.4

เวอร์ชัน 1.3.3

เวอร์ชัน 1.3.2

เวอร์ชัน 1.3.1

เวอร์ชัน 1.3.0

เวอร์ชัน 1.2.3

  • อัปเดตปลั๊กอินเพื่อรองรับ API ที่มีการให้รางวัลใหม่
  • รองรับอะแดปเตอร์ maio Android เวอร์ชัน 1.1.7.0
  • รองรับอะแดปเตอร์ maio iOS เวอร์ชัน 1.4.6.0

เวอร์ชัน 1.2.2

  • รองรับอะแดปเตอร์ maio Android เวอร์ชัน 1.1.6.0
  • รองรับอะแดปเตอร์ maio iOS เวอร์ชัน 1.4.2.0

เวอร์ชัน 1.2.1

  • รองรับอะแดปเตอร์ maio Android เวอร์ชัน 1.1.6.0
  • รองรับอะแดปเตอร์ maio iOS เวอร์ชัน 1.4.1.0

เวอร์ชัน 1.2.0

  • รองรับอะแดปเตอร์ maio Android เวอร์ชัน 1.1.4.1
  • รองรับอะแดปเตอร์ maio iOS เวอร์ชัน 1.4.0.0

เวอร์ชัน 1.1.3

  • รองรับอะแดปเตอร์ maio Android เวอร์ชัน 1.1.3.1
  • รองรับอะแดปเตอร์ maio iOS เวอร์ชัน 1.3.2.0

เวอร์ชัน 1.1.2

  • รองรับอะแดปเตอร์ maio Android เวอร์ชัน 1.1.3.0
  • รองรับอะแดปเตอร์ maio iOS เวอร์ชัน 1.3.2.0

เวอร์ชัน 1.1.1

  • รองรับอะแดปเตอร์ maio Android เวอร์ชัน 1.1.1.0
  • รองรับอะแดปเตอร์ maio iOS เวอร์ชัน 1.3.1.1

เวอร์ชัน 1.1.0

  • รองรับอะแดปเตอร์ maio Android เวอร์ชัน 1.1.0.0
  • รองรับอะแดปเตอร์ maio iOS เวอร์ชัน 1.3.0.0

เวอร์ชัน 1.0.2

  • รองรับ maio Android SDK เวอร์ชัน 1.0.8
  • รองรับ maio iOS SDK เวอร์ชัน 1.2.19

เวอร์ชัน 1.0.1

  • รองรับ maio Android SDK เวอร์ชัน 1.0.7
  • รองรับ maio iOS SDK เวอร์ชัน 1.2.19

เวอร์ชัน 1.0.0

  • เปิดตัวครั้งแรก!
  • รองรับ maio Android SDK เวอร์ชัน 1.0.6
  • รองรับ maio iOS SDK เวอร์ชัน 1.2.18