คู่มือนี้แสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดง โฆษณาจาก i-mobile โดยใช้สื่อกลาง ซึ่งครอบคลุมการผสานรวม Waterfall ซึ่งครอบคลุมถึงวิธีเพิ่ม i-mobile ลงในหน่วยโฆษณา การกำหนดค่าสื่อกลาง และวิธีผสานรวม i-mobile SDK และอะแดปเตอร์ แอป Unity
อินเทอร์เฟซบนหน้าแดชบอร์ดสำหรับ i-mobile จะใช้ข้อความภาษาญี่ปุ่นเป็นป้ายกำกับ และคำอธิบาย ภาพหน้าจอในคู่มือนี้ไม่มีคำแปล อย่างไรก็ตาม คำอธิบายและวิธีการในคู่มือนี้จะแปลป้ายกำกับและปุ่มเป็นภาษาไทยพร้อมคำภาษาอังกฤษที่เทียบเท่าไว้ในวงเล็บ
การผสานรวมและรูปแบบโฆษณาที่รองรับ
Ad Manager อะแดปเตอร์สื่อกลางสำหรับ i-mobile มี ความสามารถต่อไปนี้
การผสานรวม | |
---|---|
การเสนอราคา | |
น้ำตก | |
รูปแบบ | |
แบนเนอร์ | |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว |
ข้อกำหนด
- Unity 5.6 ขึ้นไป
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุด
- เพื่อทำให้ใช้งานได้ใน Android
- Android API ระดับ 21 ขึ้นไป
- วิธีติดตั้งใช้งานใน iOS
- เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
- โปรเจ็กต์ Unity ที่ใช้งานได้ซึ่งกำหนดค่าด้วย SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ดูรายละเอียดได้ที่เริ่มต้นใช้งาน
- ดำเนินการสื่อกลางให้เสร็จสิ้น คู่มือเริ่มต้นใช้งาน
ขั้นตอนที่ 1: กำหนดค่าใน UI ของ i-mobile
ลงชื่อสมัครใช้หรือเข้าสู่ระบบบัญชี i-mobile
เพิ่มแอปไปยังแดชบอร์ด i-mobile โดยคลิกแท็บ サイト/アプ이管理 (การจัดการเว็บไซต์/แอปพลิเคชัน) และปุ่มสำหรับแพลตฟอร์มของแอป
Android
iOS
กรอกแบบฟอร์มแล้วคลิกปุ่ม {@/規登録 (ลงชื่อสมัครใช้)
Android
iOS
หากต้องการสร้างสปอตโฆษณาใหม่ ให้เลือกแอปในแท็บ サイト/アプク管理 (การจัดการเว็บไซต์/แอปพลิเคชัน)
Android
iOS
ไปที่แท็บ 広告ポット管理 (Ad Spot Management) แล้วคลิกปุ่ม ของคุณถูกจัด จำพวกนี้ได้ 広告ポット (New Ad Spot)
ขั้นตอนถัดไป ให้กรอกข้อมูลในแบบฟอร์มโดยระบุ 広告すポットホ (ชื่อ Ad Spot name), 広告ที่แสดงอยู่ในポットサイズ (ขนาดสปอตโฆษณา) และรายละเอียดอื่นๆ จากนั้นคลิกปุ่ม 䦏登録 (ลงชื่อสมัครใช้)
สปอตโฆษณาใหม่ของคุณพร้อมแล้ว หากต้องการดูรายละเอียดการผสานรวม ให้คลิกปุ่ม アプ設定取得 (รับการตั้งค่าแอป)
จดบันทึก パポット (รหัสผู้เผยแพร่โฆษณา), メデ設アID (Media ID) และ customポットID (Spot ID) คุณจะต้องใช้พารามิเตอร์เหล่านี้ในภายหลังเมื่อกำหนดค่า i-mobile สำหรับสื่อกลางใน Ad Manager UI
Android
iOS
ขั้นตอนที่ 2: ตั้งค่าความต้องการสำหรับอุปกรณ์เคลื่อนที่ใน Ad Manager UI
กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา
Android
ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสําหรับ Android
iOS
โปรดดูวิธีการในขั้นตอนที่ 2 ในคู่มือสำหรับ iOS
ขั้นตอนที่ 3: นำเข้า SDK และอะแดปเตอร์ i-mobile
OpenUPM-CLI
หากคุณมี OpenUPM-CLI ติดตั้งแล้ว คุณสามารถติดตั้ง i-mobile โฆษณาบนมือถือของ Google ปลั๊กอินสื่อกลางสำหรับ Unity ไปยังโปรเจ็กต์โดยเรียกใช้คำสั่งต่อไปนี้ จากไดเรกทอรีรากของโปรเจ็กต์:
openupm add com.google.ads.mobile.mediation.imobile
OpenUPM
ในตัวแก้ไขโปรเจ็กต์ Unity ให้เลือกแก้ไข > การตั้งค่าโปรเจ็กต์ > เครื่องมือจัดการแพ็กเกจเพื่อเปิด การตั้งค่าเครื่องมือจัดการแพ็กเกจ Unity
ในแท็บ Scoped Registries ให้เพิ่ม OpenUPM เป็นรีจิสทรีที่กำหนดขอบเขตด้วยตัวเลือก รายละเอียดต่อไปนี้
- ชื่อ:
OpenUPM
- URL:
https://package.openupm.com
- ขอบเขต:
com.google
จากนั้นไปที่หน้าต่าง > เครื่องมือจัดการแพ็กเกจเพื่อเปิด ตัวจัดการแพ็กเกจ Unity และ เลือก My Registries จากเมนูแบบเลื่อนลง
เลือกแพ็กเกจสื่อกลาง i-mobile ของ Google Mobile Ads และ ให้คลิกติดตั้ง
แพ็กเกจ Unity
ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุดสำหรับ
i-mobile จากลิงก์ดาวน์โหลดใน
เวลา
บันทึกการเปลี่ยนแปลง
และดึงข้อมูล
GoogleMobileAdsIMobileMediation.unitypackage
จากรหัสไปรษณีย์
ในเครื่องมือแก้ไขโปรเจ็กต์ Unity ให้เลือกเนื้อหา > นำเข้าแพ็กเกจ >
แพ็กเกจที่กำหนดเอง แล้วค้นหา
GoogleMobileAdsIMobileMediation.unitypackage
ที่คุณดาวน์โหลดไว้ ตรวจสอบว่าได้เลือกไฟล์ทั้งหมดแล้ว และคลิก
นำเข้า
จากนั้นเลือกชิ้นงาน > ตัวแก้ไขบริการ Google Play >
ตัวแก้ไข Android > บังคับให้แก้ไข ไลบรารี Unity Play Services Resolver จะทำการแก้ไขข้อกำหนดตั้งแต่ต้นและคัดลอกข้อกำหนดที่ประกาศไว้ไปยังไดเรกทอรี Assets/Plugins/Android
ของแอป Unity
ขั้นตอนที่ 4: ต้องใช้รหัสเพิ่มเติม
Android
ไม่ต้องมีรหัสเพิ่มเติมเกี่ยวกับการผสานรวม i-mobile
iOS
การผสานรวม SKAdNetwork
ทำตามเอกสารประกอบของ i-mobile เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist
ของโปรเจ็กต์
ขั้นตอนที่ 5: ทดสอบการใช้งาน
เปิดใช้โฆษณาทดสอบ
อย่าลืม ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ Ad Manager i-mobile จะเตรียม Spot ID, รหัสสื่อ และ รหัสผู้เผยแพร่โฆษณา สำหรับการทดสอบไว้ทดสอบ ซึ่งคุณจะดูได้ที่นี่
ยืนยันโฆษณาทดสอบ
ในการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก i-mobile ให้เปิดใช้ การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้ i-mobile (Waterfall) แหล่งที่มาของโฆษณา
รหัสข้อผิดพลาด
หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก i-mobile ผู้เผยแพร่โฆษณาจะตรวจสอบข้อผิดพลาดพื้นฐานจากการตอบกลับโฆษณาได้โดยใช้ ResponseInfo
ในส่วนคลาสต่อไปนี้
Android
รูปแบบ | ชื่อชั้นเรียน |
---|---|
แบนเนอร์ | com.google.ads.mediation.imobile.IMobileAdapter |
โฆษณาคั่นระหว่างหน้า | com.google.ads.mediation.imobile.IMobileAdapter |
เนทีฟ | com.google.ads.mediation.imobile.IMobileMediationAdapter |
iOS
รูปแบบ | ชื่อชั้นเรียน |
---|---|
แบนเนอร์ | IMobileAdapter |
โฆษณาคั่นระหว่างหน้า | IMobileAdapter |
เนทีฟ | GADMediationAdapterIMobile |
นี่คือรหัสและข้อความประกอบที่อะแดปเตอร์ i-mobile เมื่อโฆษณาไม่โหลด
Android
รหัสข้อผิดพลาด | เหตุผล |
---|---|
0-99 | i-mobile SDK แสดงผลข้อผิดพลาด ดูรหัส เพื่อดูรายละเอียดเพิ่มเติม |
101 | i-mobile ต้องใช้บริบท Activity เพื่อโหลดโฆษณา |
102 | พารามิเตอร์เซิร์ฟเวอร์ i-mobile ที่กำหนดค่าใน Ad Manager UI ขาดหายไป/ไม่ถูกต้อง |
103 | ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ i-mobile รองรับ |
104 | Callback ที่ประสบความสำเร็จสำหรับการโหลดโฆษณาเนทีฟของ i-mobile แสดงผลรายการโฆษณาเนทีฟที่ว่างเปล่า |
iOS
รหัสข้อผิดพลาด | เหตุผล |
---|---|
0-10 | i-mobile SDK แสดงผลข้อผิดพลาด ดูรายละเอียดเพิ่มเติมที่ code |
101 | พารามิเตอร์เซิร์ฟเวอร์ i-mobile ที่กำหนดค่าใน Ad Manager UI ขาดหายไป/ไม่ถูกต้อง |
102 | ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ i-mobile รองรับ |
103 | i-mobile แสดงโฆษณาไม่สำเร็จ |
104 | i-mobile แสดงผลอาร์เรย์โฆษณาเนทีฟที่ว่างเปล่า |
105 | i-mobile ดาวน์โหลดองค์ประกอบโฆษณาเนทีฟไม่สำเร็จ |
106 | i-mobile ไม่รองรับคําขอโฆษณาคั่นระหว่างหน้าหลายรายการโดยใช้รหัสตำแหน่งโฆษณาเดียวกัน |
บันทึกการเปลี่ยนแปลงปลั๊กอิน i-mobile Unity Mediation
เวอร์ชัน 1.3.5
- รองรับอะแดปเตอร์ i-mobile Android เวอร์ชัน 2.3.2.0
- รองรับอะแดปเตอร์ iOS i-mobile เวอร์ชัน 2.3.4.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.1.0
เวอร์ชัน 1.3.4
- รองรับอะแดปเตอร์ i-mobile Android เวอร์ชัน 2.3.1.2
- รองรับอะแดปเตอร์ iOS ของ i-mobile เวอร์ชัน 2.3.4.0
- สร้างขึ้นและทดสอบด้วยปลั๊กอิน Google Mobile Ads Unity เวอร์ชัน 9.0.0
เวอร์ชัน 1.3.3
- รองรับอะแดปเตอร์ Android ของ i-mobile เวอร์ชัน 2.3.1.1
- รองรับอะแดปเตอร์ iOS ของ i-mobile เวอร์ชัน 2.3.3.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.0.0
เวอร์ชัน 1.3.2
- ย้ายเนื้อหาของอะแดปเตอร์ไปยัง
GoogleMobileAds/Mediation/IMobile/
แล้ว - สนับสนุนอะแดปเตอร์ i-mobile Android เวอร์ชัน 2.3.1.1
- รองรับอะแดปเตอร์ iOS i-mobile เวอร์ชัน 2.3.2.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.1.0
เวอร์ชัน 1.3.1
- รองรับอะแดปเตอร์ i-mobile Android เวอร์ชัน 2.3.0.0
- รองรับอะแดปเตอร์ i-mobile iOS เวอร์ชัน 2.3.0.1
- สร้างและทดสอบโดยใช้ Google Mobile Ads Unity Plugin เวอร์ชัน 7.4.1
เวอร์ชัน 1.3.0
- รองรับอะแดปเตอร์ i-mobile Android เวอร์ชัน 2.3.0.0
- รองรับอะแดปเตอร์ iOS i-mobile เวอร์ชัน 2.3.0.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 7.3.1
เวอร์ชัน 1.2.2
- รองรับอะแดปเตอร์ i-mobile Android เวอร์ชัน 2.0.23.1
- รองรับอะแดปเตอร์ iOS i-mobile เวอร์ชัน 2.2.0.1
- สร้างและทดสอบโดยใช้ Google Mobile Ads Unity Plugin เวอร์ชัน 7.0.2
เวอร์ชัน 1.2.1
- รองรับอะแดปเตอร์ i-mobile Android เวอร์ชัน 2.0.23.0
- รองรับอะแดปเตอร์ iOS ของ i-mobile เวอร์ชัน 2.2.0.1
- สร้างและทดสอบโดยใช้ Google Mobile Ads Unity Plugin เวอร์ชัน 7.0.0