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

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

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

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

Android

iOS

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

Android

iOS

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

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

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

Android

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

iOS

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

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

OpenUPM-CLI

หากคุณมี OpenUPM-CLI ติดตั้งแล้ว คุณสามารถติดตั้ง maio ของโฆษณา Google Mobile ปลั๊กอินสื่อกลางสำหรับ Unity ไปยังโปรเจ็กต์โดยเรียกใช้คำสั่งต่อไปนี้ จากไดเรกทอรีรากของโปรเจ็กต์:

openupm add com.google.ads.mobile.mediation.maio

OpenUPM

ในตัวแก้ไขโปรเจ็กต์ Unity ให้เลือกแก้ไข > การตั้งค่าโปรเจ็กต์ > เครื่องมือจัดการแพ็กเกจเพื่อเปิด การตั้งค่าเครื่องมือจัดการแพ็กเกจ Unity

ในแท็บ Scoped Registries ให้เพิ่ม OpenUPM เป็นรีจิสทรีที่กำหนดขอบเขตด้วยตัวเลือก รายละเอียดต่อไปนี้

  • ชื่อ: OpenUPM
  • URL: https://package.openupm.com
  • ขอบเขต: com.google

รายละเอียด OpenUPM

จากนั้นไปที่หน้าต่าง > เครื่องมือจัดการแพ็กเกจเพื่อเปิด ตัวจัดการแพ็กเกจ Unity และ เลือก My Registries จากเมนูแบบเลื่อนลง

รีจิสทรี Unity

เลือกแพ็กเกจสื่อกลาง maio ของโฆษณา Google Mobile และ ให้คลิกติดตั้ง

ติดตั้งจาก OpenUPM

แพ็กเกจ Unity

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

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

นำเข้าจาก Unity

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

บังคับแก้ไข

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

Android

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

iOS

การผสานรวม SKAdNetwork

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

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

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

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

ผู้เผยแพร่โฆษณาที่ใช้ 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