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

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

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

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

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

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

ข้อกำหนด

• API ของ Android ระดับ 21 ขึ้นไป

• maio SDK 1.0.7 ขึ้นไป

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

• ดำเนินการสื่อกลางให้เสร็จสิ้น คู่มือเริ่มต้นใช้งาน

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

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

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

หมายเหตุ: ไม่สามารถผสานรวม maio ที่ทำงานร่วมกันได้กับ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันต่างๆ อาจทำให้เกิดปัญหาในการสร้างได้

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

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

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

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

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

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

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

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

ไม่ต้องมีรหัสเพิ่มเติมสำหรับการผสานรวม maio บน Android

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

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

อย่าลืม ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ Ad Manager

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

สำคัญ: ปิดใช้โหมดทดสอบสำหรับ Ad Manager และ 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	บริบทที่ใช้ในการโหลดโฆษณาไม่ใช่อินสแตนซ์ "กิจกรรม"

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

เวอร์ชัน 1.1.16.3

• อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 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 ใหม่
• อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 22.0.0

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

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

เวอร์ชัน 1.1.16.1

• อัปเดต compileSdkVersion และ targetSdkVersion เป็น API 31 แล้ว
• อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 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 ขั้นต่ำที่ต้องใช้

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

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

เวอร์ชัน 1.1.15.0

• ตรวจสอบความเข้ากันได้กับ maio SDK เวอร์ชัน 1.1.15 แล้ว
• อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 20.0.0

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

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

เวอร์ชัน 1.1.14.0

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

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

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

เวอร์ชัน 1.1.13.0

• ตรวจสอบความเข้ากันได้กับ maio SDK เวอร์ชัน 1.1.13 แล้ว
• อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 19.5.0

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

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

เวอร์ชัน 1.1.12.0

• อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 19.4.0

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

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

เวอร์ชัน 1.1.11.1

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

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

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

เวอร์ชัน 1.1.11.0

• ตรวจสอบความเข้ากันได้กับ maio SDK เวอร์ชัน 1.1.11 แล้ว
• อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 18.3.0

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

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

เวอร์ชัน 1.1.10.0

• ตรวจสอบความเข้ากันได้กับ maio SDK เวอร์ชัน 1.1.10 แล้ว
• อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 18.2.0

เวอร์ชัน 1.1.8.0

• ตรวจสอบความเข้ากันได้กับ maio SDK เวอร์ชัน 1.1.8 แล้ว
• อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 18.1.0

เวอร์ชัน 1.1.7.0

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

เวอร์ชัน 1.1.6.1

• อัปเดตอะแดปเตอร์ให้รองรับ API ที่มีการให้รางวัลใหม่
• อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 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

• อัปเดตอะแดปเตอร์ให้ทำงานกับคลาสอินสแตนซ์แทน 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

• แก้ไขปัญหาที่อาจทำให้ NullPointerException เกิดขึ้นเมื่อโฆษณาไม่ผ่านการตรวจสอบ เพื่อโหลด

เวอร์ชัน 1.0.7.0

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

เวอร์ชัน 1.0.6.0

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