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

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

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

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

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

ข้อกำหนด

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

• maio SDK 1.0.7 ขึ้นไป

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

• สื่อกลางเสร็จสมบูรณ์ คู่มือเริ่มต้นใช้งาน

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

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

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

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

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

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

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

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

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

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

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

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

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

เปิดการเก็บรวบรวมข้อมูลอัตโนมัติ แล้วป้อนรหัส API และคีย์ 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")
    }
  }
}

จากนั้นเพิ่มการพึ่งพาและการกําหนดค่าการติดตั้งใช้งานต่อไปนี้ในไฟล์ build.gradle.kts ระดับแอป ใช้ maiO SDK และอะแดปเตอร์เวอร์ชันล่าสุด

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.6.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 โดยอัตโนมัติในโทรศัพท์และแท็บเล็ตที่ลงทะเบียนเป็นอุปกรณ์ทดสอบเมื่อส่งคำขอ

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

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

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

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

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

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

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

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

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