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

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

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

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

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

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

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

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

• maio SDK 1.0.7 ขึ้นไป

• GMA Next-Gen SDK เวอร์ชันล่าสุด

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ขั้นตอนที่ 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.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
    implementation("com.google.ads.mediation:maio:2.0.9.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0'
    implementation 'com.google.ads.mediation:maio:2.0.9.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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

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

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

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

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

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

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

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

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

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

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

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

รหัสและข้อความที่แสดงโดยอะแดปเตอร์ 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

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