คู่มือนี้จะแสดงวิธีใช้ Google Mobile Ads SDK เพื่อโหลดและแสดงโฆษณาจาก i-mobile โดยใช้ สื่อกลาง, ครอบคลุมการผสานรวม Waterfall ซึ่งครอบคลุมถึงวิธีเพิ่ม i-mobile ลงในหน่วยโฆษณา การกำหนดค่าสื่อกลาง และวิธีผสานรวม i-mobile SDK และอะแดปเตอร์ แอป Android
อินเทอร์เฟซหน้าแดชบอร์ดสำหรับ i-mobile ใช้ข้อความภาษาญี่ปุ่นสำหรับป้ายกำกับ ปุ่ม และคำอธิบาย ภาพหน้าจอในคู่มือนี้ไม่มีคำแปล แต่ในคำอธิบายและวิธีการของคู่มือนี้ ป้ายกำกับและ ปุ่มต่างๆ จะได้รับการแปลโดยใส่เครื่องหมายภาษาอังกฤษไว้ในวงเล็บ
การผสานรวมและรูปแบบโฆษณาที่รองรับ
อะแดปเตอร์สื่อกลางสำหรับ i-mobile มีความสามารถต่อไปนี้
การผสานรวม | |
---|---|
การเสนอราคา | |
น้ำตก | |
รูปแบบ | |
แบนเนอร์ | |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว | |
เนทีฟ |
ข้อกำหนด
- API ของ Android ระดับ 21 ขึ้นไป
Google Mobile Ads SDK เวอร์ชันล่าสุด
สื่อกลางเสร็จสมบูรณ์ คู่มือเริ่มต้นใช้งาน
ขั้นตอนที่ 1: กำหนดค่าใน UI ของ i-mobile
ขั้นตอนที่ 2: ตั้งค่าความต้องการสำหรับอุปกรณ์เคลื่อนที่ใน Ad Manager UI
ขั้นตอนที่ 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.3.0")
implementation("com.google.ads.mediation:imobile:2.3.2.0")
}
การผสานรวมด้วยตนเอง
ดาวน์โหลดเวอร์ชันล่าสุดของ i-mobile SDK และดึงข้อมูล
android-ad-sdk.aar
ในโฟลเดอร์sdk
แล้วเพิ่มลงในโปรเจ็กต์ไปที่อาร์ติแฟกต์ของอะแดปเตอร์ i-mobile ในที่เก็บ Maven ของ Google เลือกเวอร์ชันล่าสุด ดาวน์โหลด i-mobile
.aar
ของอะแดปเตอร์ แล้วเพิ่มลงในโปรเจ็กต์
ขั้นตอนที่ 4: เพิ่มโค้ดที่จำเป็น
ไม่ต้องมีรหัสเพิ่มเติมสำหรับการผสานรวม i-mobile
ขั้นตอนที่ 5: ทดสอบการใช้งาน
เปิดใช้โฆษณาทดสอบ
อย่าลืม ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ Ad Manager i-mobile จะเตรียม Spot ID, รหัสสื่อ และ รหัสผู้เผยแพร่โฆษณา สำหรับการทดสอบไว้ทดสอบ ซึ่งคุณจะดูได้ที่นี่
ยืนยันโฆษณาทดสอบ
ในการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก i-mobile ให้เปิดใช้ การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้ i-mobile (Waterfall) แหล่งที่มาของโฆษณา
ขั้นตอนที่ไม่บังคับ
การใช้โฆษณาเนทีฟ
การแสดงโฆษณา
อะแดปเตอร์ i-mobile จะป้อนข้อมูลต่อไปนี้
ช่อง
สําหรับ
NativeAd
ช่อง | เนื้อหารวมอยู่โดยอะแดปเตอร์ i-mobile เสมอ |
---|---|
บรรทัดแรก | |
รูปภาพ | |
เนื้อความ | |
ไอคอนแอป | 1 |
คำกระตุ้นการตัดสินใจ | |
การให้ดาว | |
ร้านค้า | |
ราคา |
1 สำหรับโฆษณาเนทีฟ i-mobile SDK จะไม่มีเนื้อหาไอคอนแอป แต่อะแดปเตอร์ i-mobile จะสร้างไอคอนแอปด้วยรูปภาพโปร่งใสแทน
รหัสข้อผิดพลาด
หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก i-mobile
ผู้เผยแพร่โฆษณาสามารถตรวจสอบข้อผิดพลาดที่แท้จริงจากการตอบกลับโฆษณาโดยใช้
ResponseInfo.getAdapterResponses()
ในคลาสต่อไปนี้
รูปแบบ | ชื่อชั้นเรียน |
---|---|
แบนเนอร์ | 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 | Callback ที่ประสบความสำเร็จสำหรับการโหลดโฆษณาเนทีฟของ i-mobile แสดงผลรายการโฆษณาเนทีฟที่ว่างเปล่า |
บันทึกการเปลี่ยนแปลงของอะแดปเตอร์สื่อกลาง Android ของ i-mobile
เวอร์ชัน 2.3.2.0
- ยืนยันความเข้ากันได้กับ i-mobile SDK v2.3.2
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 23.1.0
- IMobile SDK เวอร์ชัน 2.3.2
เวอร์ชัน 2.3.1.2
- อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 23.0.0
- ยืนยันความเข้ากันได้กับ i-mobile SDK v2.3.1
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 23.0.0
- IMobile SDK เวอร์ชัน 2.3.1
เวอร์ชัน 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
- อัปเดต Google Mobile Ads SDK เป็นเวอร์ชัน 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
- เพิ่มรหัสและข้อความแสดงข้อผิดพลาดมาตรฐานสำหรับอะแดปเตอร์
- อัปเดตเวอร์ชันขั้นต่ำของ Google Mobile Ads SDK เป็น 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
- การเผยแพร่ครั้งแรก
- เพิ่มการรองรับโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า และโฆษณาเนทีฟ