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

เลือกแพลตฟอร์ม: Android iOS Unity Flutter Android (เดิม)

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

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

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

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

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

ข้อกำหนดเบื้องต้น

ก่อนดำเนินการต่อ ให้ตรวจสอบสิ่งต่อไปนี้

  • Google Mobile Ads Unity Plugin เวอร์ชันล่าสุด
  • Unity Editor เวอร์ชัน 4 ขึ้นไป
  • วิธีติดตั้งใช้งานใน Android
    • Android API ระดับ 24 ขึ้นไป
  • วิธีติดตั้งใช้งานใน iOS
    • เป้าหมายการติดตั้งใช้งาน iOS เวอร์ชัน 15.0 ขึ้นไป
  • โปรเจ็กต์ Unity ที่ใช้งานได้ซึ่งกำหนดค่าด้วย Google Mobile Ads Unity Plugin ดูรายละเอียดได้ที่หัวข้อตั้งค่า Google Mobile Ads Unity Plugin
  • ตั้งค่าสื่อกลาง

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

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

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

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

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

    Android

    iOS

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

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

    Android

    iOS

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

    Android

    iOS

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

    Android

    iOS

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

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

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

    Android

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

    iOS

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

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

    OpenUPM-CLI

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

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

    OpenUPM

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

    ในแท็บ Scoped Registries ให้เพิ่ม OpenUPM เป็น Scoped Registry โดยระบุรายละเอียดต่อไปนี้

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

    รายละเอียด OpenUPM

    จากนั้นไปที่ Window > Package Manager เพื่อเปิด Unity Package Manager แล้วเลือกMy Registries จากเมนูแบบเลื่อนลง

    Unity Registry

    เลือกแพ็กเกจ Google Mobile Ads Maio Mediation แล้วคลิกติดตั้ง

    ติดตั้งจาก OpenUPM

    แพ็กเกจ Unity

    ดาวน์โหลดปลั๊กอินสื่อกลาง Google Mobile Ads สำหรับ maio เวอร์ชันล่าสุดจากลิงก์ดาวน์โหลดในบันทึกการเปลี่ยนแปลง แล้วแตกไฟล์ GoogleMobileAdsMaioMediation.unitypackage จากไฟล์ ZIP

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

    นำเข้าจาก Unity

    จากนั้นเลือก Assets > External Dependency Manager > Android Resolver > Force Resolve ไลบรารี External Dependency Manager จะทำการแก้ไขทรัพยากร Dependency ตั้งแต่ต้นและคัดลอกทรัพยากร Dependency ที่ประกาศไว้ไปยังไดเรกทอรี Assets/Plugins/Android ของแอป Unity

    บังคับให้แก้ไข

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

    Android

    ไม่จำเป็นต้องใช้โค้ดเพิ่มเติมสำหรับการผสานรวม maio

    iOS

    การผสานรวม SKAdNetwork

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

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

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

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

    ผู้เผยแพร่โฆษณาที่ใช้ Google Mobile Ads Unity Plugin เวอร์ชัน 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 บริบทที่ใช้โหลดโฆษณาไม่ใช่อินสแตนซ์ `Activity`

    iOS

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

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

    เวอร์ชัน 3.1.11

    เวอร์ชัน 3.1.10

    เวอร์ชัน 3.1.9

    เวอร์ชัน 3.1.8

    เวอร์ชัน 3.1.7

    เวอร์ชัน 3.1.6

    เวอร์ชัน 3.1.5

    เวอร์ชัน 3.1.4

    เวอร์ชัน 3.1.3

    เวอร์ชัน 3.1.2

    เวอร์ชัน 3.1.1

    เวอร์ชัน 3.1.0

    เวอร์ชัน 3.0.2

    เวอร์ชัน 3.0.1

    เวอร์ชัน 3.0.0

    เวอร์ชัน 2.0.4

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

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

    เวอร์ชัน 1.2.2

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

    เวอร์ชัน 1.2.1

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

    เวอร์ชัน 1.2.0

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

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

    เวอร์ชัน 1.1.0

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