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

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

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

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

Ad Mediation Adapter สำหรับ maio มีความสามารถต่อไปนี้

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

ข้อกำหนด

  • Google Mobile Ads SDK เวอร์ชันล่าสุด
  • Flutter 3.7.0 ขึ้นไป
  • หากต้องการติดตั้งใช้งานใน Android
    • API ระดับ 23 ขึ้นไปของ Android
  • หากต้องการติดตั้งใช้งานใน iOS
    • เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
  • โปรเจ็กต์ Flutter ที่ใช้งานได้ซึ่งกำหนดค่าด้วย Google Mobile Ads SDK ดูรายละเอียดได้ที่เริ่มต้นใช้งาน
  • ทําตามคู่มือเริ่มต้นใช้งานสื่อกลางให้เสร็จสมบูรณ์

ขั้นตอนที่ 1: ตั้งค่าใน UI ของ maio

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

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

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

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

Android

iOS

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

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

Android

iOS

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

Android

iOS

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

Android

iOS

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

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

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

Android

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

iOS

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

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

การผสานรวมผ่าน pub.dev

เพิ่มทรัพยากร Dependency ต่อไปนี้ด้วย SDK และอะแดปเตอร์ maio เวอร์ชันล่าสุดในไฟล์ pubspec.yaml ของแพ็กเกจ

dependencies:
  gma_mediation_maio: ^

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

ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณา Google ในอุปกรณ์เคลื่อนที่เวอร์ชันล่าสุดสำหรับ maio แตกไฟล์ที่ดาวน์โหลด แล้วเพิ่มโฟลเดอร์ปลั๊กอินที่แตกออกมา (และเนื้อหาของโฟลเดอร์) ลงในโปรเจ็กต์ Flutter จากนั้นอ้างอิงปลั๊กอินในไฟล์ pubspec.yaml โดยเพิ่มทรัพยากร Dependency ต่อไปนี้

dependencies:
  gma_mediation_maio:
    path: path/to/local/package

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

Android

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

iOS

การผสานรวม SKAdNetwork

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

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

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

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

ผู้เผยแพร่โฆษณาที่ใช้ Google Mobile Ads SDK เวอร์ชัน 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 มีการโหลดโฆษณาสำหรับการกำหนดค่าเครือข่ายนี้แล้ว

บันทึกการเปลี่ยนแปลงของตัวกลาง Flutter ของ maio

เวอร์ชัน 1.0.3

เวอร์ชัน 1.0.2

เวอร์ชัน 1.0.1

เวอร์ชัน 1.0.0