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

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

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

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

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

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

ข้อกำหนด

  • API ระดับ 23 ขึ้นไปของ Android
  • maio SDK 1.0.7 ขึ้นไป

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

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

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

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

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

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

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

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

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

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

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

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

ลงชื่อเข้าใช้บัญชี Ad Manager

ไปที่การแสดงโฆษณา > กลุ่มผลตอบแทน แล้วคลิกปุ่มกลุ่มผลตอบแทนใหม่

ป้อนชื่อที่ไม่ซ้ำกันสำหรับกลุ่มผลตอบแทน ตั้งสถานะเป็นใช้งานอยู่ เลือกรูปแบบโฆษณา และตั้งประเภทพื้นที่โฆษณาเป็นแอปบนอุปกรณ์เคลื่อนที่ ในส่วนการกำหนดเป้าหมาย > พื้นที่โฆษณา ให้เลือกหน่วยโฆษณาในส่วน พื้นที่โฆษณาและแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ที่คุณต้องการเพิ่มสื่อกลาง

จากนั้นคลิกปุ่มเพิ่มพาร์ทเนอร์ผลตอบแทน

หากมีพาร์ทเนอร์ผลตอบแทนสำหรับ maio อยู่แล้ว ให้เลือกพาร์ทเนอร์นั้น หรือเลือกสร้างพาร์ทเนอร์ผลตอบแทนใหม่

เลือก maio เป็นเครือข่ายโฆษณา ป้อนชื่อที่ไม่ซ้ำกัน แล้วเปิดใช้สื่อกลาง

เปิดการเก็บรวบรวมข้อมูลอัตโนมัติ แล้วป้อน รหัส API และคีย์ API ที่ได้รับในส่วนก่อนหน้า

เมื่อเลือกพาร์ทเนอร์ผลตอบแทนแล้ว ให้เลือกสื่อกลาง SDK บนอุปกรณ์เคลื่อนที่ เป็นประเภทการผสานรวม เลือก Android เป็น แพลตฟอร์ม และเลือกใช้งานอยู่เป็นสถานะ ป้อนรหัสสื่อและรหัสโซน ที่ได้รับในส่วนก่อนหน้า จากนั้นป้อนค่า CPM เริ่มต้น

คลิกบันทึกที่ด้านล่างของหน้าเมื่อดำเนินการเสร็จ

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

ในไฟล์ settings.gradle.kts ระดับโปรเจ็กต์ ให้เพิ่มที่เก็บต่อไปนี้ 

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://imobile-maio.github.io/maven")
    }
  }
}

จากนั้นในไฟล์ build.gradle.kts ระดับแอป ให้เพิ่มทรัพยากร Dependency และการกำหนดค่าการใช้งานต่อไปนี้ ใช้ SDK และอะแดปเตอร์ของ maio เวอร์ชันล่าสุดโดยทำดังนี้ 

dependencies {
    implementation("com.google.android.gms:play-services-ads:24.5.0")
    implementation("com.google.ads.mediation:maio:2.0.5.0")
}

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

  • ดาวน์โหลด maio Android SDK เวอร์ชันล่าสุดและเพิ่มลงในโปรเจ็กต์
  • ไปที่อาร์ติแฟกต์ของอะแดปเตอร์ MAIO ในที่เก็บ Maven ของ Google เลือกเวอร์ชันล่าสุด ดาวน์โหลดไฟล์ `.aar` ของอแดปเตอร์ maio แล้วเพิ่มลงในโปรเจ็กต์

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

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

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

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

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

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

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

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

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

หากอแดปเตอร์ไม่ได้รับโฆษณาจาก maio ผู้เผยแพร่โฆษณาสามารถตรวจสอบข้อผิดพลาดพื้นฐานจากการตอบกลับโฆษณาได้โดยใช้ ResponseInfo.getAdapterResponses() ภายใต้คลาสต่อไปนี้

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

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

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

บันทึกการเปลี่ยนแปลงของ AdMob Android Mediation Adapter

เวอร์ชัน 2.0.5.0

  • ได้รับการยืนยันว่าเข้ากันได้กับ maio SDK เวอร์ชัน 2.0.5

สร้างและทดสอบด้วย

  • Google Mobile Ads SDK เวอร์ชัน 24.4.0
  • Maio SDK เวอร์ชัน 2.0.5.0

เวอร์ชัน 2.0.4.0

  • ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 2.0.4

สร้างและทดสอบด้วย

  • SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 24.3.0
  • Maio SDK เวอร์ชัน 2.0.4.0

เวอร์ชัน 2.0.3.1

  • อัปเดตระดับ API ขั้นต่ำของ Android ที่จำเป็นเป็น 23
  • อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำที่กำหนดเป็น 24.0.0

สร้างและทดสอบด้วย

  • Google Mobile Ads SDK เวอร์ชัน 24.0.0
  • Maio SDK เวอร์ชัน 2.0.3.0

เวอร์ชัน 2.0.3.0

  • ได้รับการยืนยันว่าใช้งานร่วมกับ maio SDK เวอร์ชัน 2.0.3.0 ได้

สร้างและทดสอบด้วย

  • Google Mobile Ads SDK เวอร์ชัน 23.6.0
  • Maio SDK เวอร์ชัน 2.0.3.0

เวอร์ชัน 1.1.16.3

  • อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำที่กำหนดเป็น 23.0.0
  • ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 1.1.16

สร้างและทดสอบด้วย

  • Google Mobile Ads SDK เวอร์ชัน 23.0.0
  • Maio SDK เวอร์ชัน 1.1.16

เวอร์ชัน 1.1.16.2

  • อัปเดตอะแดปเตอร์ให้ใช้คลาส VersionInfo ใหม่
  • อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำที่กำหนดเป็น 22.0.0

สร้างและทดสอบด้วย

  • Google Mobile Ads SDK เวอร์ชัน 22.0.0
  • Maio SDK เวอร์ชัน 1.1.16

เวอร์ชัน 1.1.16.1

  • อัปเดต compileSdkVersion และ targetSdkVersion เป็น API 31 แล้ว
  • อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำที่กำหนดเป็น 21.0.0
  • อัปเดตระดับ API ของ Android ขั้นต่ำที่จำเป็นเป็น 19

สร้างและทดสอบด้วย

  • SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 21.0.0
  • Maio SDK เวอร์ชัน 1.1.16

เวอร์ชัน 1.1.16.0

  • อัปเดตรหัสข้อผิดพลาดเพื่อบันทึกข้อผิดพลาดเพิ่มเติมของ MAIO
  • ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 1.1.16
  • อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำที่กำหนดเป็น 20.4.0

สร้างและทดสอบด้วย

  • Google Mobile Ads SDK เวอร์ชัน 20.4.0
  • Maio SDK เวอร์ชัน 1.1.16

เวอร์ชัน 1.1.15.0

  • ยืนยันความเข้ากันได้กับ SDK ของ maio เวอร์ชัน 1.1.15
  • อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำที่กำหนดเป็น 20.0.0

สร้างและทดสอบด้วย

  • Google Mobile Ads SDK เวอร์ชัน 20.0.0
  • Maio SDK เวอร์ชัน 1.1.15

เวอร์ชัน 1.1.14.0

  • เพิ่มรหัสและข้อความแสดงข้อผิดพลาดของอะแดปเตอร์ที่ได้มาตรฐาน
  • ยืนยันความเข้ากันได้กับ SDK ของ maio เวอร์ชัน 1.1.14
  • อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำที่กำหนดเป็น 19.8.0

สร้างและทดสอบด้วย

  • Google Mobile Ads SDK เวอร์ชัน 19.8.0
  • Maio SDK เวอร์ชัน 1.1.14

เวอร์ชัน 1.1.13.0

  • ยืนยันความเข้ากันได้กับ SDK ของ maio เวอร์ชัน 1.1.13
  • อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำที่กำหนดเป็น 19.5.0

สร้างและทดสอบด้วย

  • Google Mobile Ads SDK เวอร์ชัน 19.5.0
  • Maio SDK เวอร์ชัน 1.1.13

เวอร์ชัน 1.1.12.0

  • อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำที่กำหนดเป็น 19.4.0

สร้างและทดสอบด้วย

  • Google Mobile Ads SDK เวอร์ชัน 19.4.0
  • Maio SDK เวอร์ชัน 1.1.12

เวอร์ชัน 1.1.11.1

  • เพื่อจำกัดการหมดเวลา ตอนนี้คำขอโฆษณาจะล้มเหลวทันทีหาก maio ไม่มีโฆษณาที่พร้อมแสดง
  • อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำที่กำหนดเป็น 19.1.0

สร้างและทดสอบด้วย

  • Google Mobile Ads SDK เวอร์ชัน 19.1.0
  • Maio SDK เวอร์ชัน 1.1.11

เวอร์ชัน 1.1.11.0

  • ยืนยันความเข้ากันได้กับ SDK ของ maio เวอร์ชัน 1.1.11
  • อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำที่กำหนดเป็น 18.3.0

สร้างและทดสอบด้วย

  • Google Mobile Ads SDK เวอร์ชัน 18.3.0
  • Maio SDK เวอร์ชัน 1.1.11

เวอร์ชัน 1.1.10.0

  • ได้รับการยืนยันว่าเข้ากันได้กับ maio SDK เวอร์ชัน 1.1.10
  • อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำที่กำหนดเป็น 18.2.0

เวอร์ชัน 1.1.8.0

  • ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 1.1.8
  • อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำที่กำหนดเป็น 18.1.0

เวอร์ชัน 1.1.7.0

  • แก้ไขข้อบกพร่อง
  • ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 1.1.7

เวอร์ชัน 1.1.6.1

  • อัปเดตอแดปเตอร์เพื่อรองรับ API โฆษณาที่มีการให้รางวัลใหม่
  • อัปเดตเวอร์ชันขั้นต่ำที่กำหนดของ Google Mobile Ads SDK เป็น 17.2.0

เวอร์ชัน 1.1.6.0

  • ยืนยันความเข้ากันได้กับ SDK ของ maio เวอร์ชัน 1.1.6

เวอร์ชัน 1.1.5.0

  • ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 1.1.5

เวอร์ชัน 1.1.4.0

  • ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 1.1.4

เวอร์ชัน 1.1.3.1

  • อัปเดตอะแดปเตอร์ให้ทำงานกับคลาสอินสแตนซ์แทน Singleton

เวอร์ชัน 1.1.3.0

  • ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 1.1.3

เวอร์ชัน 1.1.2.1

  • อัปเดตอแดปเตอร์ด้วยฟังก์ชันการเริ่มต้นที่อัปเดตแล้ว

เวอร์ชัน 1.1.2.0

  • ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 1.1.2

เวอร์ชัน 1.1.1.1

  • อัปเดตอแดปเตอร์เพื่อเรียกใช้onRewardedVideoComplete()เหตุการณ์โฆษณา

เวอร์ชัน 1.1.1.0

  • ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 1.1.1

เวอร์ชัน 1.1.0.0

  • ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 1.1.0

เวอร์ชัน 1.0.8.0

  • ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 1.0.8

เวอร์ชัน 1.0.7.1

  • แก้ไขปัญหาที่อาจทำให้เกิด NullPointerExceptions เมื่อโฆษณาโหลดไม่สำเร็จ

เวอร์ชัน 1.0.7.0

  • เพิ่มความสามารถในการเปิดใช้โหมดทดสอบโดยการเพิ่มรหัสอุปกรณ์ทดสอบไปยัง AdRequest
  • ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 1.0.7

เวอร์ชัน 1.0.6.0

  • เปิดตัวครั้งแรก
  • เพิ่มการรองรับโฆษณาคั่นระหว่างหน้าและโฆษณาวิดีโอที่มีการให้รางวัล