คู่มือนี้แสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดง โฆษณาจาก i-mobile ที่ใช้ สื่อกลาง ซึ่งครอบคลุมการผสานรวม Waterfall ซึ่งครอบคลุมถึงวิธีเพิ่ม i-mobile ลงในหน่วยโฆษณา การกำหนดค่าสื่อกลาง และวิธีผสานรวม i-mobile SDK และอะแดปเตอร์ แอป Android
อินเทอร์เฟซบนหน้าแดชบอร์ดสำหรับ i-mobile จะใช้ข้อความภาษาญี่ปุ่นเป็นป้ายกำกับ และคำอธิบาย ภาพหน้าจอในคู่มือนี้ แปลแล้ว แต่ในคำอธิบายและวิธีการของคู่มือนี้ ป้ายกำกับและ ปุ่มต่างๆ จะได้รับการแปลโดยใส่เครื่องหมายภาษาอังกฤษไว้ในวงเล็บ
การผสานรวมและรูปแบบโฆษณาที่รองรับ
อะแดปเตอร์สื่อกลางสำหรับ i-mobile มีความสามารถต่อไปนี้
การผสานรวม | |
---|---|
การเสนอราคา | |
น้ำตก | |
รูปแบบ | |
แบนเนอร์ | |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว | |
เนทีฟ |
ข้อกำหนด
- API ของ Android ระดับ 21 ขึ้นไป
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: ตั้งค่าความต้องการสำหรับอุปกรณ์เคลื่อนที่ใน 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.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
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 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
- อัปเดตเวอร์ชัน 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
- การเผยแพร่ครั้งแรก
- เพิ่มการรองรับโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า และโฆษณาเนทีฟ