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

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

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

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

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

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

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

• Android API ระดับ 24 ขึ้นไป

• maio SDK 1.0.7 ขึ้นไป

• Google Mobile Ads SDK (Legacy) เวอร์ชันล่าสุด

• ตั้งค่าสื่อกลาง AdMob

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

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

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

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

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

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

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

คุณต้องเพิ่ม maio ลงในการกำหนดค่าสื่อกลางสำหรับหน่วยโฆษณา

ก่อนอื่น ให้ลงชื่อเข้าใช้บัญชี AdMob จากนั้นไปที่แท็บสื่อกลาง หากมีกลุ่มสื่อกลางอยู่แล้วและต้องการแก้ไข ให้คลิกชื่อกลุ่มสื่อกลางนั้นเพื่อแก้ไข แล้วข้ามไปที่หัวข้อเพิ่ม maio เป็นแหล่งที่มาของโฆษณา

หากต้องการสร้างกลุ่มสื่อกลางใหม่ ให้เลือกสร้างกลุ่มสื่อกลาง

ป้อนรูปแบบโฆษณาและแพลตฟอร์ม แล้วคลิกต่อไป

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

เชื่อมโยงกลุ่มสื่อกลางนี้กับหน่วยโฆษณา AdMob ที่มีอยู่อย่างน้อย 1 หน่วย จากนั้นคลิกเสร็จสิ้น

ตอนนี้คุณควรเห็นการ์ดหน่วยโฆษณาที่สร้างขึ้นพร้อมหน่วยโฆษณาที่คุณเลือก

เพิ่ม maio เป็นแหล่งที่มาของโฆษณา

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

การผสานรวม Android Studio (แนะนำ)

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

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

ในไฟล์ gradle ระดับแอป ให้เพิ่มทรัพยากร Dependency ของการติดตั้งใช้งานต่อไปนี้

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

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.google.ads.mediation:maio:2.0.9.1'
}

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

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

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

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

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

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

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

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

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

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

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

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

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

บันทึกการเปลี่ยนแปลงของอะแดปเตอร์สื่อกลาง maio สำหรับ Android

เวอร์ชันถัดไป

• อัปเดตอะแดปเตอร์ให้ใช้ InitializationCompleteCallback.onInitializationFailed(AdError) API
• อัปเดตระดับ API ขั้นต่ำของ Android ที่จำเป็นเป็น 24

เวอร์ชัน 2.0.9.1

• ปักหมุดทรัพยากร Dependency ของ Kotlin ของอะแดปเตอร์เป็น 1.9.0 (เวอร์ชัน Kotlin ขั้นต่ำที่ GMA NextGen SDK รองรับ)
• แก้ไขลักษณะการทำงานแบบ Fall-through ในสาขาที่ล้มเหลวซึ่งมีการจำกัดอายุผู้ชมระหว่างการเริ่มต้นโฆษณาและคำขอโหลดโฆษณา

สร้างขึ้นและทดสอบด้วย:

• Google Mobile Ads SDK เวอร์ชัน 25.4.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.5.0
• Maio SDK เวอร์ชัน 2.0.9.1

เวอร์ชัน 2.0.9.0

• กรองคำขอที่จำกัดอายุผู้ชมสำหรับ maio SDK เมื่อตั้งค่า AgeRestrictedTreatment ใหม่เป็น CHILD
• ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 2.0.9 แล้ว

สร้างขึ้นและทดสอบด้วย:

• Google Mobile Ads SDK เวอร์ชัน 25.4.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.3.1
• Maio SDK เวอร์ชัน 2.0.9.0

เวอร์ชัน 2.0.8.2

• กรองคำขอที่มีการจำกัดอายุผู้ชมสำหรับ maio SDK เนื่องจากไม่สามารถรับสัญญาณที่มีการจำกัดอายุผู้ชม
• เพิ่มพร็อพเพอร์ตี้เพื่อสร้างอะแดปเตอร์ที่มีทรัพยากร Dependency ของ GMA Next-Gen SDK

สร้างขึ้นและทดสอบด้วย:

• Google Mobile Ads SDK เวอร์ชัน 25.1.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.1.0
• Maio SDK เวอร์ชัน 2.0.8.2

เวอร์ชัน 2.0.8.1

• เพิ่มการรองรับรูปแบบโฆษณาแบนเนอร์

สร้างขึ้นและทดสอบด้วย:

• Google Mobile Ads SDK เวอร์ชัน 25.0.0
• Maio SDK เวอร์ชัน 2.0.8.1

เวอร์ชัน 2.0.8.0

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

สร้างขึ้นและทดสอบด้วย:

• Google Mobile Ads SDK เวอร์ชัน 24.9.0
• Maio SDK เวอร์ชัน 2.0.8.0

เวอร์ชัน 2.0.7.0

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

สร้างขึ้นและทดสอบด้วย:

• Google Mobile Ads SDK เวอร์ชัน 24.7.0
• Maio SDK เวอร์ชัน 2.0.7.0

เวอร์ชัน 2.0.6.0

• นำการอ้างอิงระดับคลาสไปยัง Context ออก ช่วยลดปัญหาหน่วยความจำรั่วไหลได้
• ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 2.0.6 แล้ว

สร้างขึ้นและทดสอบด้วย:

• Google Mobile Ads SDK เวอร์ชัน 24.6.0
• Maio SDK เวอร์ชัน 2.0.6.0

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

สร้างขึ้นและทดสอบด้วย:

• Google Mobile Ads SDK เวอร์ชัน 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

สร้างขึ้นและทดสอบด้วย:

• Google Mobile Ads SDK เวอร์ชัน 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

• ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 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

• เพิ่มรหัสและข้อความแสดงข้อผิดพลาดของอะแดปเตอร์ที่ได้มาตรฐาน
• ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 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

• ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 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

• ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 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

• อัปเดตอะแดปเตอร์เพื่อรองรับ Rewarded API ใหม่
• อัปเดตเวอร์ชัน Google Mobile Ads SDK ขั้นต่ำที่จำเป็นเป็น 17.2.0

เวอร์ชัน 1.1.6.0

• ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 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

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

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

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