คู่มือนี้แสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดง โฆษณาจาก maio ที่ใช้ สื่อกลาง ซึ่งครอบคลุมการผสานรวม Waterfall ซึ่งครอบคลุมถึงวิธีเพิ่ม maio ลงในหน่วยโฆษณา การกำหนดค่าสื่อกลาง และวิธีผสานรวม maio SDK และอะแดปเตอร์ Android แอป
อินเทอร์เฟซแดชบอร์ดสำหรับ maio จะใช้ข้อความภาษาญี่ปุ่นสำหรับป้ายกำกับ ปุ่มต่างๆ และคำอธิบาย รวมทั้งภาพหน้าจอในคู่มือนี้ยังไม่ได้รับการแปล แต่ในคำอธิบายและวิธีการของคู่มือนี้ ป้ายกำกับและปุ่ม ที่อ้างถึงด้วยภาษาอังกฤษที่เทียบเท่ากัน "URL 東キーム" ตัวอย่างเช่น คือ "รูปแบบ URL"
การผสานรวมและรูปแบบโฆษณาที่รองรับ
อะแดปเตอร์สื่อกลางสำหรับ maio มีความสามารถต่อไปนี้
การผสานรวม | |
---|---|
การเสนอราคา | |
น้ำตก | |
รูปแบบ | |
แบนเนอร์ | |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว | |
เนทีฟ |
ข้อกำหนด
- API ของ Android ระดับ 21 ขึ้นไป
- maio SDK 1.0.7 ขึ้นไป
SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุด
ดำเนินการสื่อกลางให้เสร็จสิ้น คู่มือเริ่มต้นใช้งาน
ขั้นตอนที่ 1: ตั้งค่าการกำหนดค่าใน UI ของ maio
ก่อนอื่น ให้ลงชื่อสมัครใช้หรือลงชื่อเข้าสู่ระบบบัญชี maio ของคุณ คลิกปุ่ม การจัดการแอปพลิเคชันในแถบด้านซ้าย แล้วคลิกแอปใหม่
เลือกแท็บประเภทโฆษณาที่ต้องการ
โฆษณาคั่นระหว่างหน้า
ป้อนชื่อของแอป เลือกแพลตฟอร์ม และระบุ URL ของแอป เลือกประเภทโฆษณาเป็นโฆษณาวิดีโอคั่นระหว่างหน้า แล้วคลิกอัปเดต
ได้รับรางวัลแล้ว
ป้อนชื่อของแอป เลือกแพลตฟอร์ม และระบุ URL ของแอป เลือกรางวัลวิดีโอเป็นประเภทโฆษณา แล้วคลิกอัปเดต
ในหน้าการจัดการแอปพลิเคชัน ให้จดรหัสสื่อ แต่คุณต้องตั้งค่า Ad Manager หน่วยโฆษณาในส่วนถัดไป
ในหน้า Zone Management ให้จดบันทึก Zone ID และยังเป็นสิ่งจำเป็นในการตั้งค่า Ad Manager หน่วยโฆษณาในส่วนถัดไปด้วย
ขั้นตอนที่ 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 และอะแดปเตอร์
การผสานรวมกับ Android Studio (แนะนำ)
เพิ่มข้อมูลต่อไปนี้ในไฟล์ 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.3.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 | บริบทที่ใช้ในการโหลดโฆษณาไม่ใช่อินสแตนซ์ "กิจกรรม" |
บันทึกการเปลี่ยนแปลงอะแดปเตอร์สื่อกลาง 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
- เปิดตัวครั้งแรก
- เพิ่มการรองรับโฆษณาคั่นระหว่างหน้าและโฆษณาวิดีโอที่มีการให้รางวัล