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

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

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

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

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

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

ข้อกำหนด

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

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

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

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

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

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

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

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

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

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

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

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

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

ลงชื่อเข้าใช้บัญชี 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 ระดับแอป ใช้ SDK และอะแดปเตอร์ maiO เวอร์ชันล่าสุด

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.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() ในคลาสต่อไปนี้

รูปแบบ ชื่อชั้นเรียน
โฆษณาคั่นระหว่างหน้า 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 บริบทที่ใช้โหลดโฆษณาไม่ใช่อินสแตนซ์ "กิจกรรม"

บันทึกการเปลี่ยนแปลงของอะแดปเตอร์สื่อกลาง 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

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