คู่มือนี้จะแสดงวิธีใช้ Google Mobile Ads SDK เพื่อโหลดและแสดงโฆษณาจาก i-mobile โดยใช้สื่อกลาง ซึ่งครอบคลุมการผสานรวม Waterfall ซึ่งจะอธิบายวิธีเพิ่ม i-mobile ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม SDK และอะแดปเตอร์ i-mobile เข้ากับแอป Unity
อินเทอร์เฟซหน้าแดชบอร์ดสำหรับ i-mobile ใช้ข้อความภาษาญี่ปุ่นสำหรับป้ายกำกับ ปุ่ม และคำอธิบาย ภาพหน้าจอในคู่มือนี้ไม่มีคำแปล อย่างไรก็ตาม คำอธิบายและวิธีการในคู่มือนี้จะแปลป้ายกำกับและปุ่มเป็นภาษาไทยพร้อมคำภาษาอังกฤษที่เทียบเท่าไว้ในวงเล็บ
การผสานรวมและรูปแบบโฆษณาที่รองรับ
อะแดปเตอร์สื่อกลาง AdMob สําหรับ i-mobile มีคุณสมบัติดังต่อไปนี้
การผสานรวม | |
---|---|
การเสนอราคา | |
น้ำตก | |
รูปแบบ | |
แบนเนอร์ | |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว |
ข้อกำหนด
- Unity 5.6 ขึ้นไป
- Google Mobile Ads SDK เวอร์ชันล่าสุด
- วิธีติดตั้งใช้งานใน Android
- Android API ระดับ 21 ขึ้นไป
- วิธีติดตั้งใช้งานใน iOS
- เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
- โปรเจ็กต์ Unity ที่ใช้งานได้ซึ่งกําหนดค่าด้วย 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 ใน UI ของ AdMob
กำหนดการตั้งค่าสื่อกลางสําหรับหน่วยโฆษณา
โปรดดูวิธีการที่ขั้นตอนที่ 2 ในคู่มือสำหรับ Android
ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสำหรับ iOS
ขั้นตอนที่ 3: นําเข้า SDK และอะแดปเตอร์ i-mobile
หากติดตั้ง OpenUPM-CLI แล้ว คุณจะติดตั้งปลั๊กอินสื่อกลาง i-mobile ของ Google Mobile Ads สําหรับ Unity ลงในโปรเจ็กต์ได้โดยเรียกใช้คําสั่งต่อไปนี้จากไดเรกทอรีรูทของโปรเจ็กต์
openupm add com.google.ads.mobile.mediation.imobile
ในเครื่องมือแก้ไขโปรเจ็กต์ Unity ให้เลือกแก้ไข > การตั้งค่าโปรเจ็กต์ > เครื่องมือจัดการแพ็กเกจเพื่อเปิดการตั้งค่าเครื่องมือจัดการแพ็กเกจ Unity
ในแท็บรีจิสทรีที่มีขอบเขต ให้เพิ่ม OpenUPM เป็นรีจิสทรีที่มีขอบเขตพร้อมรายละเอียดต่อไปนี้
- ชื่อ:
OpenUPM
- URL:
https://package.openupm.com
- ขอบเขต:
com.google
จากนั้นไปที่หน้าต่าง > เครื่องมือจัดการแพ็กเกจเพื่อเปิดเครื่องมือจัดการแพ็กเกจ Unity แล้วเลือกที่เก็บของฉันจากเมนูแบบเลื่อนลง
เลือกแพ็กเกจ Google Mobile Ads i-mobile Mediation แล้วคลิกติดตั้ง
ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณา Google Mobile เวอร์ชันล่าสุดสําหรับ i-mobile จากลิงก์ดาวน์โหลดในบันทึกการเปลี่ยนแปลง และแตกไฟล์ GoogleMobileAdsIMobileMediation.unitypackage
จากไฟล์ ZIP
ในเครื่องมือแก้ไขโปรเจ็กต์ Unity ให้เลือกเนื้อหา > นําเข้าแพ็กเกจ >
แพ็กเกจที่กําหนดเอง แล้วค้นหาไฟล์ GoogleMobileAdsIMobileMediation.unitypackage
ที่ดาวน์โหลด ตรวจสอบว่าได้เลือกไฟล์ทั้งหมดแล้ว แล้วคลิกนําเข้า
จากนั้นเลือกชิ้นงาน > เครื่องมือจัดการทรัพยากรภายนอก >
เครื่องมือแก้ไขของ Android > บังคับแก้ไข ไลบรารีเครื่องมือจัดการทรัพยากร Dependency ภายนอกจะทำการแก้ไข Dependency ตั้งแต่ต้นและคัดลอก Dependency ที่ประกาศไว้ไปยังไดเรกทอรี Assets/Plugins/Android
ของแอป Unity
ขั้นตอนที่ 4: ต้องใช้โค้ดเพิ่มเติม
การผสานรวม i-mobile ไม่จำเป็นต้องใช้โค้ดเพิ่มเติม
การผสานรวม SKAdNetwork
ทำตามเอกสารประกอบของ i-mobile เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist
ของโปรเจ็กต์
ขั้นตอนที่ 5: ทดสอบการใช้งาน
เปิดใช้โฆษณาทดสอบ
ตรวจสอบว่าคุณได้ลงทะเบียนอุปกรณ์ทดสอบสําหรับ AdMob แล้ว i-mobile มีรหัสพาร์ทเนอร์ รหัสสื่อ และรหัสผู้เผยแพร่โฆษณาสำหรับทดสอบ ซึ่งดูได้ที่นี่
ยืนยันโฆษณาทดสอบ
หากต้องการยืนยันว่าคุณกําลังได้รับโฆษณาทดสอบจาก i-mobile ให้เปิดใช้การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียวในเครื่องมือตรวจสอบโฆษณาโดยใช้แหล่งที่มาของโฆษณา i-mobile (Waterfall)
รหัสข้อผิดพลาด
หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก i-mobile ผู้เผยแพร่โฆษณาจะตรวจสอบข้อผิดพลาดพื้นฐานจากการตอบกลับโฆษณาได้โดยใช้ ResponseInfo
ในส่วนคลาสต่อไปนี้
รูปแบบ | ชื่อชั้นเรียน |
---|---|
แบนเนอร์ | com.google.ads.mediation.imobile.IMobileAdapter |
โฆษณาคั่นระหว่างหน้า | com.google.ads.mediation.imobile.IMobileAdapter |
เนทีฟ | com.google.ads.mediation.imobile.IMobileMediationAdapter |
รูปแบบ | ชื่อชั้นเรียน |
---|---|
แบนเนอร์ | IMobileAdapter |
โฆษณาคั่นระหว่างหน้า | IMobileAdapter |
เนทีฟ | GADMediationAdapterIMobile |
ต่อไปนี้คือรหัสและข้อความที่มาพร้อมกับข้อผิดพลาดที่อะแดปเตอร์ i-mobile แสดงเมื่อโหลดโฆษณาไม่สําเร็จ
รหัสข้อผิดพลาด | เหตุผล |
---|---|
0-99 | i-mobile SDK แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมที่ code |
101 | i-mobile ต้องใช้บริบท Activity เพื่อโหลดโฆษณา |
102 | พารามิเตอร์เซิร์ฟเวอร์ i-mobile ที่กําหนดค่าใน UI ของ AdMob ไม่มีอยู่หรือไม่ถูกต้อง |
103 | ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ i-mobile รองรับ |
104 | ฟังก์ชันการเรียกกลับเมื่อโหลดโฆษณาเนทีฟของ i-mobile แสดงรายการโฆษณาเนทีฟว่างเปล่า |
รหัสข้อผิดพลาด | เหตุผล |
---|---|
0-10 | i-mobile SDK แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมที่ code |
101 | พารามิเตอร์เซิร์ฟเวอร์ i-mobile ที่กําหนดค่าใน UI ของ AdMob ไม่มีอยู่หรือไม่ถูกต้อง |
102 | ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ i-mobile รองรับ |
103 | i-mobile แสดงโฆษณาไม่สำเร็จ |
104 | i-mobile ส่งกลับอาร์เรย์โฆษณาเนทีฟว่าง |
105 | i-mobile ดาวน์โหลดชิ้นงานโฆษณาเนทีฟไม่สำเร็จ |
106 | i-mobile ไม่รองรับคําขอโฆษณาคั่นระหว่างหน้าหลายรายการโดยใช้รหัสตำแหน่งโฆษณาเดียวกัน |
บันทึกการเปลี่ยนแปลงของปลั๊กอินสื่อกลาง Unity ของ i-mobile
เวอร์ชัน 1.3.6
- รองรับอะแดปเตอร์ Android ของ i-mobile เวอร์ชัน 2.3.2.0
- รองรับอะแดปเตอร์ iOS ของ i-mobile เวอร์ชัน 2.3.4.1
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 9.3.0
เวอร์ชัน 1.3.5
- รองรับอะแดปเตอร์ Android ของ i-mobile เวอร์ชัน 2.3.2.0
- รองรับอะแดปเตอร์ iOS ของ i-mobile เวอร์ชัน 2.3.4.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 9.1.0
เวอร์ชัน 1.3.4
- รองรับอะแดปเตอร์ Android ของ i-mobile เวอร์ชัน 2.3.1.2
- รองรับอะแดปเตอร์ iOS ของ i-mobile เวอร์ชัน 2.3.4.0
- สร้างขึ้นและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 9.0.0
เวอร์ชัน 1.3.3
- รองรับอะแดปเตอร์ Android ของ i-mobile เวอร์ชัน 2.3.1.1
- รองรับอะแดปเตอร์ iOS ของ i-mobile เวอร์ชัน 2.3.3.0
- สร้างขึ้นและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 9.0.0
เวอร์ชัน 1.3.2
- ย้ายเนื้อหาอะแดปเตอร์ไปยัง
GoogleMobileAds/Mediation/IMobile/
แล้ว - รองรับอะแดปเตอร์ Android ของ i-mobile เวอร์ชัน 2.3.1.1
- รองรับอะแดปเตอร์ iOS ของ i-mobile เวอร์ชัน 2.3.2.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 8.1.0
เวอร์ชัน 1.3.1
- รองรับอะแดปเตอร์ Android ของ i-mobile เวอร์ชัน 2.3.0.0
- รองรับอะแดปเตอร์ iOS ของ i-mobile เวอร์ชัน 2.3.0.1
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 7.4.1
เวอร์ชัน 1.3.0
- รองรับอะแดปเตอร์ Android ของ i-mobile เวอร์ชัน 2.3.0.0
- รองรับอะแดปเตอร์ iOS ของ i-mobile เวอร์ชัน 2.3.0.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 7.3.1
เวอร์ชัน 1.2.2
- รองรับอะแดปเตอร์ Android ของ i-mobile เวอร์ชัน 2.0.23.1
- รองรับอะแดปเตอร์ iOS ของ i-mobile เวอร์ชัน 2.2.0.1
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 7.0.2
เวอร์ชัน 1.2.1
- รองรับอะแดปเตอร์ Android ของ i-mobile เวอร์ชัน 2.0.23.0
- รองรับอะแดปเตอร์ iOS ของ i-mobile เวอร์ชัน 2.2.0.1
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 7.0.0
เวอร์ชัน 1.2.0
- รองรับอะแดปเตอร์ Android ของ i-mobile เวอร์ชัน 2.0.23.0
- รองรับอะแดปเตอร์ iOS ของ i-mobile เวอร์ชัน 2.2.0.0
เวอร์ชัน 1.1.0
- รองรับอะแดปเตอร์ Android ของ i-mobile เวอร์ชัน 2.0.22.2
- รองรับอะแดปเตอร์ iOS ของ i-mobile เวอร์ชัน 2.1.0.1
เวอร์ชัน 1.0.2
- รองรับอะแดปเตอร์ Android ของ i-mobile เวอร์ชัน 2.0.22.0
- รองรับอะแดปเตอร์ iOS ของ i-mobile เวอร์ชัน 2.0.32.0
เวอร์ชัน 1.0.1
- รองรับอะแดปเตอร์ Android ของ i-mobile เวอร์ชัน 2.0.21.0
- รองรับอะแดปเตอร์ iOS ของ i-mobile เวอร์ชัน 2.0.31.0
เวอร์ชัน 1.0.0
- ฉบับแรก
- รองรับอะแดปเตอร์ Android ของ i-mobile เวอร์ชัน 2.0.20.1
- รองรับอะแดปเตอร์ iOS ของ i-mobile เวอร์ชัน 2.0.29.0