คู่มือนี้แสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดงโฆษณาจาก i-mobile โดยใช้ สื่อกลาง AdMob, ในการผสานรวม 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 ของ AdMob
ขั้นตอนที่ 2: ตั้งค่าดีมานด์ i-mobile ใน AdMob UI
กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา
คุณต้องเพิ่ม i-mobile ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา
ก่อนอื่น ให้ลงชื่อเข้าใช้บัญชี AdMob จากนั้นไปที่แท็บสื่อกลาง หากมีกลุ่มสื่อกลางที่ต้องการแก้ไขอยู่แล้ว ให้คลิกชื่อกลุ่มสื่อกลางนั้นเพื่อแก้ไข แล้วข้ามไปที่หัวข้อเพิ่ม i-mobile เป็นแหล่งที่มาของโฆษณา
หากต้องการสร้างกลุ่มสื่อกลางใหม่ ให้เลือกสร้างกลุ่มสื่อกลาง
ป้อนรูปแบบโฆษณาและแพลตฟอร์ม แล้วคลิกต่อไป
ตั้งชื่อกลุ่มสื่อกลาง แล้วเลือกสถานที่ตั้งที่จะกำหนดเป้าหมาย จากนั้นตั้งค่าสถานะกลุ่มสื่อกลางเป็นเปิดใช้ แล้วคลิกเพิ่มหน่วยโฆษณา
เชื่อมโยงกลุ่มสื่อกลางนี้กับหน่วยโฆษณาAdMob ที่มีอยู่อย่างน้อย 1 หน่วย จากนั้นคลิกเสร็จสิ้น
ตอนนี้คุณควรจะเห็นการ์ดหน่วยโฆษณาเต็มไปด้วยหน่วยโฆษณาที่คุณเลือกไว้ ดังนี้
เพิ่ม i-mobile เป็นแหล่งที่มาของโฆษณา
ใต้การ์ด Waterfall ในส่วนแหล่งที่มาของโฆษณา ให้เลือกเพิ่มแหล่งที่มาของโฆษณา จากนั้นเลือก i-mobile
เลือก i-mobile และเปิดสวิตช์เพิ่มประสิทธิภาพ ป้อน Login name and API Passwordที่ได้รับในส่วนก่อนหน้าเพื่อตั้งค่าการเพิ่มประสิทธิภาพแหล่งที่มาของโฆษณาสำหรับi-mobile จากนั้นป้อนค่า eCPM สำหรับ i-mobile แล้วคลิกต่อไปหากมีการแมปสำหรับ i-mobileอยู่แล้ว ก็เลือกแผนที่นั้นได้ หรือคลิกเพิ่มการแมป
แล้วป้อน Publisher ID, Media ID and Spot ID ที่ได้รับในส่วนก่อนหน้า จากนั้นคลิกเสร็จสิ้น
ขั้นตอนที่ 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.5.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: ทดสอบการใช้งาน
เปิดใช้โฆษณาทดสอบ
ตรวจสอบว่าคุณได้ลงทะเบียนอุปกรณ์ทดสอบสำหรับ AdMob แล้ว 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 ที่กําหนดค่าใน AdMob UI ขาดหายไป/ไม่ถูกต้อง |
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 แล้ว - อัปเดตเวอร์ชัน 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 เวอร์ชัน 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
- อัปเดตเวอร์ชัน 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 เวอร์ชัน 2.0.21
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 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
- การเผยแพร่ครั้งแรก
- เพิ่มการรองรับโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า และโฆษณาเนทีฟ