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

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

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

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

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

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

ข้อกำหนด

  • Unity 4 ขึ้นไป
  • SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุด
  • เพื่อทำให้ใช้งานได้ใน Android
    • API ของ Android ระดับ 21 ขึ้นไป
  • เพื่อทำให้ใช้งานได้ใน 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: ตั้งค่าดีมานด์ maio ใน AdMob UI

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

Android

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

iOS

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

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

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

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

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

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

Android

ไม่ต้องมีรหัสเพิ่มเติมสำหรับการผสานรวม maio เลย

iOS

การผสานรวม SKAdNetwork

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

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

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

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

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

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

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

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

เวอร์ชัน 2.0.3

เวอร์ชัน 2.0.2

เวอร์ชัน 2.0.1

เวอร์ชัน 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 ใหม่
  • รองรับอะแดปเตอร์ Android ของ maio เวอร์ชัน 1.1.7.0
  • รองรับอะแดปเตอร์ iOS ของ maio เวอร์ชัน 1.4.6.0

เวอร์ชัน 1.2.2

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

เวอร์ชัน 1.2.1

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

เวอร์ชัน 1.2.0

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

เวอร์ชัน 1.1.3

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

เวอร์ชัน 1.1.2

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

เวอร์ชัน 1.1.1

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

เวอร์ชัน 1.1.0

  • รองรับอะแดปเตอร์ Android ของ maio เวอร์ชัน 1.1.0.0
  • รองรับอะแดปเตอร์ iOS ของ maio เวอร์ชัน 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