คู่มือนี้จะแสดงวิธีใช้ Google Mobile Ads SDK เพื่อโหลดและแสดงโฆษณาจาก i-mobile โดยใช้ mediation ซึ่งครอบคลุมการผสานรวม Waterfall ซึ่งจะอธิบายวิธีเพิ่ม i-mobile ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม SDK และอะแดปเตอร์ i-mobile เข้ากับแอป Android
อินเทอร์เฟซหน้าแดชบอร์ดสำหรับ i-mobile ใช้ข้อความภาษาญี่ปุ่นสำหรับป้ายกำกับ ปุ่ม และคำอธิบาย ภาพหน้าจอในคู่มือนี้ไม่มีคำแปล อย่างไรก็ตาม คำอธิบายและวิธีการในคู่มือนี้จะแปลป้ายกำกับและปุ่มเป็นภาษาไทยพร้อมคำภาษาอังกฤษที่เทียบเท่าไว้ในวงเล็บ
การผสานรวมและรูปแบบโฆษณาที่รองรับ
อะแดปเตอร์สื่อกลางสําหรับ i-mobile มีคุณสมบัติดังต่อไปนี้
การผสานรวม | |
---|---|
การเสนอราคา | |
น้ำตก | |
รูปแบบ | |
แบนเนอร์ | |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว | |
เนทีฟ |
ข้อกำหนด
- Android API ระดับ 21 ขึ้นไป
Google Mobile Ads SDK เวอร์ชันล่าสุด
สื่อกลางเสร็จสมบูรณ์ คู่มือเริ่มต้นใช้งาน
ขั้นตอนที่ 1: ตั้งค่าการกําหนดค่าใน UI ของ i-mobile
ลงชื่อสมัครใช้หรือเข้าสู่ระบบบัญชี i-mobile
เพิ่มแอปลงในแดชบอร์ด i-mobile โดยคลิกแท็บサイト/アプリ管理 (การจัดการเว็บไซต์/แอปพลิเคชัน) และปุ่มสำหรับแพลตฟอร์มของแอป
กรอกแบบฟอร์มและคลิกปุ่ม 新規登録 (ลงชื่อสมัครใช้)
หากต้องการสร้างพื้นที่โฆษณาใหม่ ให้เลือกแอปในแท็บサイト/アプリ管理 (การจัดการเว็บไซต์/แอปพลิเคชัน)
ไปที่แท็บ 広告スポット管理 (การจัดการพื้นที่โฆษณา) แล้วคลิกปุ่ม新規広告スポット (พื้นที่โฆษณาใหม่)
ถัดไป ให้กรอกแบบฟอร์มโดยระบุ 広告スポット名 (ชื่อช่องโฆษณา), 広告スポットサイズ (ขนาดช่องโฆษณา) และรายละเอียดอื่นๆ จากนั้นคลิกปุ่ม 新規登録 (ลงชื่อสมัครใช้)
ตําแหน่งโฆษณาใหม่พร้อมใช้งานแล้ว หากต้องการดูรายละเอียดการผสานรวม ให้คลิกปุ่มアプリ設定取得 (Get App settings)
จดบันทึก パブリッシャーID (รหัสผู้เผยแพร่โฆษณา), メディアID (รหัสสื่อ) และ スポットID (รหัสโฆษณา) คุณต้องใช้พารามิเตอร์เหล่านี้ในภายหลังเมื่อกําหนดค่า i-mobile สําหรับสื่อกลางใน UI ของ Ad Manager
ขั้นตอนที่ 2: ตั้งค่าดีมานด์ i-mobile ใน UI ของ Ad Manager
กำหนดการตั้งค่าสื่อกลางสําหรับหน่วยโฆษณา
ลงชื่อเข้าใช้บัญชี Ad Manager
ไปที่การแสดงโฆษณา > กลุ่มผลตอบแทน แล้วคลิกปุ่มกลุ่มผลตอบแทนใหม่
ป้อนชื่อที่ไม่ซ้ำกันสําหรับกลุ่มผลตอบแทน ตั้งค่าสถานะเป็นใช้งานอยู่ เลือกรูปแบบโฆษณา และตั้งค่าประเภทพื้นที่โฆษณาเป็นแอปบนอุปกรณ์เคลื่อนที่ ในส่วนการกําหนดเป้าหมาย > พื้นที่โฆษณา ให้เลือกหน่วยโฆษณาในส่วนพื้นที่โฆษณาและแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ที่ต้องการเพิ่มสื่อกลาง
จากนั้นคลิกปุ่มเพิ่มพาร์ทเนอร์ผลตอบแทน
หากมีพาร์ทเนอร์ผลตอบแทนสำหรับ i-mobile อยู่แล้ว คุณจะเลือกพาร์ทเนอร์รายนั้นได้ หรือเลือกสร้างพาร์ทเนอร์ผลตอบแทนใหม่
เลือก i-mobile เป็นเครือข่ายโฆษณา ป้อนชื่อที่ไม่ซ้ำกัน และเปิดใช้สื่อกลาง
เปิดการเก็บรวบรวมข้อมูลอัตโนมัติ แล้วป้อนชื่อผู้ใช้และรหัสผ่าน API
เมื่อเลือกพาร์ทเนอร์ผลตอบแทนแล้ว ให้เลือกสื่อกลาง SDK บนอุปกรณ์เคลื่อนที่เป็นประเภทการผสานรวม เลือก Android เป็นแพลตฟอร์ม และเลือกใช้งานอยู่เป็นสถานะ ป้อนรหัสผู้เผยแพร่โฆษณา รหัสสื่อ และรหัสโฆษณาที่ได้ในส่วนก่อนหน้า จากนั้นป้อนค่า 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
ระดับแอป ใช้ SDK และอะแดปเตอร์ i-mobile เวอร์ชันล่าสุด
dependencies {
implementation("com.google.android.gms:play-services-ads:23.6.0")
implementation("com.google.ads.mediation:imobile:2.3.2.0")
}
การผสานรวมด้วยตนเอง
ดาวน์โหลด i-mobile SDK เวอร์ชันล่าสุดและแตกไฟล์
android-ad-sdk.aar
ในโฟลเดอร์sdk
แล้วเพิ่มลงในโปรเจ็กต์ไปที่อาร์ติแฟกต์อะแดปเตอร์ i-mobile ที่เก็บ Maven ของ Google เลือกเวอร์ชันล่าสุด ดาวน์โหลดไฟล์
.aar
ของอะแดปเตอร์ i-mobile แล้วเพิ่มลงในโปรเจ็กต์
ขั้นตอนที่ 4: เพิ่มโค้ดที่จำเป็น
ไม่จำเป็นต้องใช้โค้ดเพิ่มเติมสำหรับการผสานรวม i-mobile
ขั้นตอนที่ 5: ทดสอบการใช้งาน
เปิดใช้โฆษณาทดสอบ
ตรวจสอบว่าคุณได้ลงทะเบียนอุปกรณ์ทดสอบสําหรับ Ad Manager แล้ว i-mobile มีรหัสพาร์ทเนอร์ รหัสสื่อ และรหัสผู้เผยแพร่โฆษณาสำหรับทดสอบ ซึ่งดูได้ที่นี่
ยืนยันโฆษณาทดสอบ
หากต้องการยืนยันว่าคุณกําลังได้รับโฆษณาทดสอบจาก 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 แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมที่ code |
101 | i-mobile ต้องใช้บริบท Activity เพื่อโหลดโฆษณา |
102 | ไม่มี/พารามิเตอร์เซิร์ฟเวอร์ i-mobile ที่กําหนดค่าใน UI ของ Ad Manager ไม่ถูกต้อง |
103 | ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ i-mobile รองรับ |
104 | ฟังก์ชันการเรียกกลับเมื่อโหลดโฆษณาเนทีฟของ 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 เวอร์ชัน 2.3.1
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 23.0.0
- IMobile SDK เวอร์ชัน 2.3.1
เวอร์ชัน 2.3.1.1
- อัปเดตอะแดปเตอร์ให้ใช้คลาส
VersionInfo
ใหม่ - อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 22.0.0
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 22.0.0
- IMobile SDK เวอร์ชัน 2.3.1
เวอร์ชัน 2.3.1.0
- ยืนยันความเข้ากันได้กับ i-mobile SDK เวอร์ชัน 2.3.1
- อัปเดตเวอร์ชันขั้นต่ำของ Google Mobile Ads SDK เป็น 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 แล้ว - อัปเดตเวอร์ชันขั้นต่ำของ Google Mobile Ads SDK เป็น 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 เวอร์ชัน 2.0.23
- อัปเดตเวอร์ชันขั้นต่ำของ Google Mobile Ads SDK เป็น 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
- อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 20.0.0
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 20.0.0
- IMobile SDK เวอร์ชัน 2.0.22
เวอร์ชัน 2.0.22.0
- ยืนยันความเข้ากันได้กับ i-mobile SDK เวอร์ชัน 2.0.22
- อัปเดตอะแดปเตอร์ให้รองรับคําขอแบนเนอร์แบบปรับขนาดได้แบบแทรกในบรรทัด
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 19.1.0
- IMobile SDK เวอร์ชัน 2.0.22
เวอร์ชัน 2.0.21.0
- ยืนยันความเข้ากันได้กับ i-mobile SDK เวอร์ชัน 2.0.21
- อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 19.1.0
- เพิ่มการรองรับการปรับขนาดโฆษณาแบนเนอร์แบบปรับขนาดได้
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 19.1.0
- IMobile SDK เวอร์ชัน 2.0.21
เวอร์ชัน 2.0.20.2
- เพิ่มการรองรับขนาดโฆษณาแบนเนอร์ที่ยืดหยุ่น
- อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 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
- การเผยแพร่ครั้งแรก
- เพิ่มการรองรับโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า และโฆษณาเนทีฟ