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

คู่มือนี้จะแสดงวิธีใช้ Google Mobile Ads SDK เพื่อโหลดและแสดงโฆษณาจาก Maio โดยใช้ Mediation ของ AdMob ซึ่งครอบคลุมการผสานรวม 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 คลิกปุ่มการจัดการแอปพลิเคชันในแถบด้านข้างทางซ้าย แล้วคลิกแอปใหม่

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

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

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

หมายเหตุ: โฆษณาคั่นระหว่างหน้าจาก Maio จะข้ามได้โดยค่าเริ่มต้น

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

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

หมายเหตุ: โฆษณาวิดีโอที่มีการให้รางวัลจาก Maio จะข้ามไม่ได้โดยค่าเริ่มต้น

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

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

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

หมายเหตุ: หากตั้งค่าบัญชี Maio เป็นครั้งแรก คุณอาจต้องติดต่อทีมสนับสนุนของ Maio เพื่อขอรับรหัส API และคีย์ API

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

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

คุณต้องเพิ่ม Maio ในการกําหนดค่าสื่อกลางสําหรับหน่วยโฆษณา

ก่อนอื่น ให้ลงชื่อเข้าใช้บัญชี AdMob จากนั้นไปที่แท็บสื่อกลาง หากมีกลุ่มสื่อกลางที่มีอยู่ซึ่งต้องการแก้ไข ให้คลิกชื่อกลุ่มสื่อกลางนั้นเพื่อแก้ไข แล้วข้ามไปเพิ่ม Maio เป็นแหล่งที่มาของโฆษณา

หากต้องการสร้างกลุ่มสื่อกลางใหม่ ให้เลือกสร้างกลุ่มสื่อกลาง

ป้อนรูปแบบโฆษณาและแพลตฟอร์ม แล้วคลิกต่อไป

ตั้งชื่อกลุ่มสื่อกลาง แล้วเลือกสถานที่ที่จะกําหนดเป้าหมาย ถัดไป ให้ตั้งค่าสถานะกลุ่มสื่อกลางเป็นเปิดใช้ แล้วคลิกเพิ่มหน่วยโฆษณา

เชื่อมโยงกลุ่มสื่อกลางนี้กับหน่วยโฆษณา AdMob ที่มีอยู่อย่างน้อย 1 หน่วย จากนั้นคลิกเสร็จสิ้น

ตอนนี้คุณควรเห็นการ์ดหน่วยโฆษณาที่สร้างขึ้นด้วยหน่วยโฆษณาที่คุณเลือก

เพิ่ม Maio เป็นแหล่งที่มาของโฆษณา

เลือกเพิ่มแหล่งที่มาของโฆษณาในการ์ด Waterfall ในส่วนแหล่งที่มาของโฆษณา จากนั้นเลือก maio

เลือก maio แล้วเปิดใช้สวิตช์เพิ่มประสิทธิภาพ ป้อนรหัส API และคีย์ API ที่ได้ในส่วนก่อนหน้าเพื่อตั้งค่าการเพิ่มประสิทธิภาพแหล่งที่มาของโฆษณาสําหรับ maiol จากนั้นป้อนมูลค่า eCPM สำหรับ maiol แล้วคลิกต่อไป

หมายเหตุ: คุณตั้งค่าการเพิ่มประสิทธิภาพแหล่งที่มาของโฆษณาได้เพียงครั้งเดียวต่อเครือข่าย

หากมีการแมปสำหรับ Magento อยู่แล้ว คุณจะเลือกการแมปนั้นได้ หรือคลิกเพิ่มการแมป

จากนั้นป้อนรหัสสื่อและรหัสโซนที่ได้ในส่วนก่อนหน้า จากนั้นคลิกเสร็จสิ้น

สำคัญ: ต้องเชื่อมโยงรหัสสื่อกับแอปเป้าหมายตามที่แสดงใน UI ของ Maio

หมายเหตุ: การเพิ่มประสิทธิภาพแหล่งที่มาของโฆษณาต้องใช้เวลารวบรวมข้อมูล 2-3 วันเพื่อคำนวณ eCPM ของเครือข่ายสื่อกลางได้อย่างแม่นยำ ในระหว่างนี้ สถานะการเพิ่มประสิทธิภาพแหล่งที่มาของโฆษณาจะเป็น PENDING คุณจึงต้องกำหนดค่า eCPM ด้วยตนเองสำหรับเครือข่าย เมื่อคำนวณ eCPM ได้แล้ว แหล่งที่มาของโฆษณาจะเริ่มอัปเดต eCPM ในนามของคุณโดยอัตโนมัติ

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

หมายเหตุ: การไม่ผสานรวม Maio เวอร์ชันที่เข้ากันได้กับ Google Mobile Ads SDK อาจทําให้เกิดปัญหาการสร้าง

การผสานรวม 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: ทดสอบการใช้งาน

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

ตรวจสอบว่าคุณได้ลงทะเบียนอุปกรณ์ทดสอบสำหรับ AdMob แล้ว

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

สำคัญ: ปิดใช้โหมดทดสอบสําหรับ AdMob และ 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

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