คู่มือนี้จะแสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดงโฆษณาจาก i-mobile โดยใช้สื่อกลาง ซึ่งครอบคลุมการผสานรวม Waterfall โดยจะครอบคลุมวิธีการเพิ่ม i-mobile ในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม SDK ของ i-mobile และอะแดปเตอร์ลงใน Android แอป
อินเทอร์เฟซแดชบอร์ดสำหรับ i-mobile ใช้ข้อความภาษาญี่ปุ่นสำหรับป้ายกำกับ ปุ่ม และคำอธิบาย ภาพหน้าจอในคู่มือนี้ยังไม่ได้รับการแปล แต่ในคำอธิบายและคำแนะนำของคู่มือนี้ ป้ายกำกับและปุ่มจะแปลด้วยชื่อที่เทียบเท่าภาษาอังกฤษในวงเล็บ
การผสานรวมที่รองรับและรูปแบบโฆษณา
Ad Manager อะแดปเตอร์สื่อกลางสำหรับ i-mobile มีความสามารถดังต่อไปนี้
| การผสานรวม | |
|---|---|
| การเสนอราคา | |
| น้ำตก | |
| รูปแบบ | |
| แบนเนอร์ | |
| โฆษณาคั่นระหว่างหน้า | |
| ได้รับรางวัลแล้ว | |
| เนทีฟ | |
ข้อกำหนด
- Android API ระดับ 19 ขึ้นไป
SDK โฆษณาบนอุปกรณ์เคลื่อนที่ของ Google ล่าสุด
ทำตามสื่อกลาง คู่มือเริ่มต้นใช้งาน
ขั้นตอนที่ 1: ตั้งค่าการกำหนดค่าใน UI ของ i-mobile
ลงชื่อสมัครใช้หรือเข้าสู่ระบบบัญชี i-mobile
เพิ่มแอปไปยังแดชบอร์ด i-mobile โดยคลิกแท็บ サイト/アプ이管理 (การจัดการเว็บไซต์/แอปพลิเคชัน) และปุ่มสำหรับแพลตฟอร์มของแอป
กรอกแบบฟอร์มแล้วคลิกปุ่ม {@/規登録 (ลงชื่อสมัครใช้)
หากต้องการสร้างสปอตโฆษณาใหม่ ให้เลือกแอปในแท็บ サイト/アプク管理 (การจัดการเว็บไซต์/แอปพลิเคชัน)
ไปที่แท็บ 広告ポット管理 (Ad Spot Management) แล้วคลิกปุ่ม ของคุณถูกจัด จำพวกนี้ได้ 広告ポット (New Ad Spot)
ขั้นตอนถัดไป ให้กรอกข้อมูลในแบบฟอร์มโดยระบุ 広告すポットホ (ชื่อ Ad Spot name), 広告ที่แสดงอยู่ในポットサイズ (ขนาดสปอตโฆษณา) และรายละเอียดอื่นๆ จากนั้นคลิกปุ่ม 䦏登録 (ลงชื่อสมัครใช้)
สปอตโฆษณาใหม่ของคุณพร้อมแล้ว หากต้องการดูรายละเอียดการผสานรวม ให้คลิกปุ่ม アプ設定取得 (รับการตั้งค่าแอป)
จดบันทึก パポット (รหัสผู้เผยแพร่โฆษณา), メデ設アID (Media ID) และ customポットID (Spot ID) คุณจะต้องใช้พารามิเตอร์เหล่านี้ในภายหลังเมื่อกำหนดค่า i-mobile สำหรับสื่อกลางใน Ad Manager UI
ขั้นตอนที่ 2: ตั้งค่าความต้องการสำหรับ i-mobile ใน Ad Manager UI
กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา
ลงชื่อเข้าใช้บัญชี Ad Manager
ไปที่การแสดงโฆษณา > กลุ่มผลตอบแทน แล้วคลิกปุ่มกลุ่มผลตอบแทนใหม่
ป้อนชื่อที่ไม่ซ้ำสำหรับกลุ่มผลตอบแทน ตั้งค่าสถานะเป็นใช้งานอยู่ เลือกรูปแบบโฆษณา และตั้งค่าประเภทพื้นที่โฆษณาเป็นแอปบนอุปกรณ์เคลื่อนที่ ในส่วนการกำหนดเป้าหมาย > พื้นที่โฆษณา ให้เลือกหน่วยโฆษณาภายใต้พื้นที่โฆษณาและแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ที่คุณต้องการเพิ่มสื่อกลาง
จากนั้น คลิกปุ่มเพิ่มพาร์ทเนอร์ผลตอบแทน
หากมีพาร์ทเนอร์ผลตอบแทนสำหรับi-mobileอยู่แล้ว คุณก็เลือกได้ มิเช่นนั้น ให้เลือกสร้างพาร์ทเนอร์ผลตอบแทนใหม่
เลือก i-mobile เป็นเครือข่ายโฆษณา ป้อนชื่อที่ไม่ซ้ำ และเปิดใช้สื่อกลาง
เปิดการรวบรวมข้อมูลอัตโนมัติ แล้วป้อนLogin name and API Password
เมื่อเลือกพาร์ทเนอร์ผลตอบแทนแล้ว ให้เลือกสื่อกลาง SDK บนอุปกรณ์เคลื่อนที่เป็นประเภทการผสานรวม Android เป็นแพลตฟอร์ม และเลือกใช้งานอยู่เป็นสถานะ ป้อนPublisher ID, Media ID and Spot ID ที่ได้รับในส่วนก่อนหน้านี้ จากนั้นป้อนค่า CPM เริ่มต้น
คลิกบันทึกที่ด้านล่างของหน้าเมื่อทำเสร็จแล้ว
ขั้นตอนที่ 3: นำเข้า SDK และอะแดปเตอร์ i-mobile
การผสานรวมกับ Android Studio (แนะนำ)
ในไฟล์ settings.gradle.kts ระดับโปรเจ็กต์ ให้เพิ่มที่เก็บต่อไปนี้
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://imobile.github.io/adnw-sdk-android")
}
}
}
จากนั้นในไฟล์ build.gradle.kts ระดับแอป ให้เพิ่มทรัพยากร Dependency และการกำหนดค่าต่อไปนี้ ใช้ SDK และอะแดปเตอร์ i-mobile
เวอร์ชันล่าสุด ดังนี้
dependencies {
implementation("com.google.android.gms:play-services-ads:23.0.0")
implementation("com.google.ads.mediation:imobile:2.3.1.1")
}
การผสานรวมด้วยตนเอง
ดาวน์โหลด SDK i-mobile เวอร์ชันล่าสุดแล้วแตกไฟล์
android-ad-sdk.aarในโฟลเดอร์sdkแล้วเพิ่มลงในโปรเจ็กต์ไปที่อาร์ติแฟกต์ของอะแดปเตอร์ i-mobile ใน Maven Repository ของ Google เลือกเวอร์ชันล่าสุด ดาวน์โหลดไฟล์
.aarของอะแดปเตอร์ i-mobile แล้วเพิ่มลงในโปรเจ็กต์
ขั้นตอนที่ 4: เพิ่มโค้ดที่จำเป็น
ไม่จำเป็นต้องใช้โค้ดเพิ่มเติมสำหรับการผสานรวม i-mobile
ขั้นตอนที่ 5: ทดสอบการใช้งาน
เปิดใช้โฆษณาทดสอบ
อย่าลืม ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ Ad Manager i-mobile จะเตรียม Spot ID, รหัสสื่อ และ รหัสผู้เผยแพร่โฆษณา สำหรับการทดสอบไว้ทดสอบ ซึ่งคุณจะดูได้ที่นี่
ยืนยันโฆษณาทดสอบ
ในการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก i-mobile ให้เปิดใช้ การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้ i-mobile (Waterfall) แหล่งที่มาของโฆษณา
ขั้นตอนที่ไม่บังคับ
การใช้โฆษณาเนทีฟ
การแสดงโฆษณา
อะแดปเตอร์ i-mobile จะป้อนข้อมูลต่อไปนี้
ช่อง
สำหรับ
NativeAd
| ฟิลด์ | เนื้อหาจะรวมอยู่ด้วยโดยอะแดปเตอร์ i-mobile เสมอ |
|---|---|
| บรรทัดแรก | |
| รูปภาพ | |
| เนื้อความ | |
| ไอคอนแอป | 1 |
| คำกระตุ้นให้ดำเนินการ (Call-To-Action) | |
| Star rating | |
| ร้านค้า | |
| ราคา |
1 สำหรับโฆษณาเนทีฟ SDK i-mobile จะไม่มีเนื้อหาไอคอนแอป แต่อะแดปเตอร์ i-mobile จะสร้างไอคอนแอปด้วยรูปภาพโปร่งใสแทน
รหัสข้อผิดพลาด
หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก i-mobile ผู้เผยแพร่โฆษณาสามารถตรวจสอบข้อผิดพลาดที่เป็นต้นเหตุจากการตอบกลับโฆษณาได้โดยใช้
ResponseInfo.getAdapterResponse()
ในคลาสต่อไปนี้
| รูปแบบ | ชื่อชั้นเรียน |
|---|---|
| แบนเนอร์ | com.google.ads.mediation.imobile.IMobileAdapter |
| โฆษณาคั่นระหว่างหน้า | com.google.ads.mediation.imobile.IMobileAdapter |
| เนทีฟ | com.google.ads.mediation.imobile.IMobileMediationAdapter |
ต่อไปนี้คือรหัสและข้อความประกอบที่อะแดปเตอร์ i-mobile ส่งเมื่อโฆษณาโหลดไม่สำเร็จ
| รหัสข้อผิดพลาด | เหตุผล |
|---|---|
| 0-99 | i-mobile SDK แสดงผลข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ที่รหัส |
| 101 | i-mobile ต้องใช้บริบท Activity ในการโหลดโฆษณา |
| 102 | พารามิเตอร์เซิร์ฟเวอร์ i-mobile ที่กำหนดค่าใน Ad Manager UI ขาดหายไป/ไม่ถูกต้อง |
| 103 | ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ i-mobile รองรับ |
| 104 | การเรียกกลับที่สำเร็จในการโหลดโฆษณาเนทีฟของ i-mobile แสดงรายการโฆษณาเนทีฟที่ว่างเปล่า |
| 0-10 | i-mobile SDK แสดงผลข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ที่รหัส |
| 101 | พารามิเตอร์เซิร์ฟเวอร์ i-mobile ที่กำหนดค่าใน Ad Manager UI ขาดหายไป/ไม่ถูกต้อง |
| 102 | ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ i-mobile รองรับ |
| 103 | i-mobile นำเสนอโฆษณาไม่สำเร็จ |
| 104 | i-mobile แสดงอาร์เรย์โฆษณาเนทีฟที่ว่างเปล่า |
| 105 | i-mobile ดาวน์โหลดเนื้อหาโฆษณาเนทีฟไม่สำเร็จ |
| 106 | i-mobile ไม่รองรับการขอโฆษณาคั่นระหว่างหน้าหลายรายการโดยใช้รหัส Spot เดียวกัน |
บันทึกการเปลี่ยนแปลงอะแดปเตอร์สื่อกลาง Android สำหรับ i-mobile
เวอร์ชันถัดไป
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่จําเป็นเป็น 22.4.0
เวอร์ชัน 2.3.1.1
- อัปเดตอะแดปเตอร์ให้ใช้คลาส
VersionInfoใหม่แล้ว - อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่จําเป็นเป็น 22.0.0
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 22.0.0
- IMobile SDK เวอร์ชัน 2.3.1
เวอร์ชัน 2.3.1.0
- มีการยืนยันความเข้ากันได้กับ i-mobile SDK v2.3.1
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่จําเป็นเป็น 21.5.0
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 21.5.0
- IMobile SDK เวอร์ชัน 2.3.1
เวอร์ชัน 2.3.0.0
- มีการยืนยันความเข้ากันได้กับ i-mobile SDK v2.3.0
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่จําเป็นเป็น 21.3.0
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 21.3.0
- IMobile SDK เวอร์ชัน 2.3.0
เวอร์ชัน 2.0.23.1
- อัปเดต
compileSdkVersionและtargetSdkVersionเป็น API 31 แล้ว - อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่จําเป็นเป็น 21.0.0
- อัปเดตระดับ API ขั้นต่ำของ Android เป็น 19 แล้ว
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 21.0.0
- IMobile SDK เวอร์ชัน 2.0.23
เวอร์ชัน 2.0.23.0
- มีการยืนยันความเข้ากันได้กับ i-mobile SDK v2.0.23
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่จําเป็นเป็น 20.5.0
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 20.5.0
- IMobile SDK เวอร์ชัน 2.0.23
เวอร์ชัน 2.0.22.2
- เพิ่มรหัสและข้อความแสดงข้อผิดพลาดของอะแดปเตอร์ที่ได้มาตรฐานแล้ว
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่จําเป็นเป็น 20.1.0
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 20.1.0
- IMobile SDK เวอร์ชัน 2.0.22
เวอร์ชัน 2.0.22.1
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่จําเป็นเป็น 20.0.0
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 20.0.0
- IMobile SDK เวอร์ชัน 2.0.22
เวอร์ชัน 2.0.22.0
- มีการยืนยันความเข้ากันได้กับ i-mobile SDK v2.0.22
- อัปเดตอะแดปเตอร์ให้รองรับคำขอแบนเนอร์แบบปรับขนาดได้ในบรรทัดแล้ว
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 19.1.0
- IMobile SDK เวอร์ชัน 2.0.22
เวอร์ชัน 2.0.21.0
- มีการยืนยันความเข้ากันได้กับ i-mobile SDK v2.0.21
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่จําเป็นเป็น 19.1.0
- เพิ่มการรองรับการปรับขนาดโฆษณาแบนเนอร์แบบปรับขนาดได้
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 19.1.0
- IMobile SDK เวอร์ชัน 2.0.21
เวอร์ชัน 2.0.20.2
- เพิ่มการรองรับขนาดโฆษณาแบนเนอร์ที่ยืดหยุ่น
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่กำหนดเป็น 18.3.0
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 18.3.0
- IMobile SDK เวอร์ชัน 2.0.20
เวอร์ชัน 2.0.20.1
- ตอนนี้อะแดปเตอร์จะแสดงสัดส่วนภาพ
mediaContentที่ไม่ใช่ 0
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 18.2.0
- IMobile SDK เวอร์ชัน 2.0.20
เวอร์ชัน 2.0.20.0
- การเผยแพร่ครั้งแรก
- เพิ่มการรองรับโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า และโฆษณาเนทีฟ