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

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

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

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

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

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

ข้อกำหนด

  • API ของ Android ระดับ 21 ขึ้นไป
  • 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: ตั้งค่าดีมานด์ maio ใน Ad Manager UI

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

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

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

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

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

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

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

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

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

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

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

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

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

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