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

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

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

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

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

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

ข้อกำหนด

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

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

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

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

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

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

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

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

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

ในหน้า Zone Management ให้จดบันทึก Zone ID และยังเป็นสิ่งจำเป็นในการตั้งค่า Ad Manager หน่วยโฆษณาในส่วนถัดไปด้วย

นอกจากรหัสสื่อและรหัสโซนแล้ว คุณจะต้องใช้รหัส API และ API KEY เพื่อตั้งค่ารหัสหน่วยโฆษณาสำหรับสื่อกลางด้วย ในหน้า Reporting API ให้จดรหัส API และ API KEY

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ไม่ต้องใช้รหัสเพิ่มเติมสำหรับการผสานการทำงานกับ 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 บริบทที่ใช้โหลดโฆษณาไม่ใช่อินสแตนซ์ "กิจกรรม"
0-10 maio แสดงข้อผิดพลาดเกี่ยวกับ SDK โดยเฉพาะ ดูรายละเอียดเพิ่มเติมได้จากรหัสของ maio
101 maio ยังไม่มีโฆษณาให้บริการ
102 พารามิเตอร์เซิร์ฟเวอร์ไม่ถูกต้อง (เช่น ไม่มีรหัสตำแหน่งโฆษณา)
103 อะแดปเตอร์ Maio ไม่รองรับรูปแบบโฆษณาที่ขอ
104 มีการโหลดโฆษณาสำหรับการกำหนดค่าเครือข่ายนี้แล้ว

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

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

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

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

สร้างและทดสอบกับ

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

สร้างและทดสอบกับ

  • Google Mobile Ads SDK เวอร์ชัน 19.8.0
  • Maio SDK เวอร์ชัน 1.1.14

เวอร์ชัน 1.1.13.0

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

สร้างและทดสอบกับ

  • Google Mobile Ads SDK เวอร์ชัน 19.5.0
  • Maio SDK เวอร์ชัน 1.1.13

เวอร์ชัน 1.1.12.0

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

สร้างและทดสอบกับ

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

  • อัปเดตอะแดปเตอร์ให้รองรับ Monetize 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

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