คู่มือนี้แสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดง โฆษณาจาก i-mobile โดยใช้สื่อกลาง ซึ่งครอบคลุมการผสานรวม Waterfall ซึ่งครอบคลุมถึงวิธีเพิ่ม i-mobile ลงในหน่วยโฆษณา การกำหนดค่าสื่อกลาง และวิธีผสานรวม i-mobile SDK และอะแดปเตอร์ แอป Unity
อินเทอร์เฟซบนหน้าแดชบอร์ดสำหรับ i-mobile จะใช้ข้อความภาษาญี่ปุ่นเป็นป้ายกำกับ และคำอธิบาย ภาพหน้าจอในคู่มือนี้ แปลแล้ว แต่ในคำอธิบายและวิธีการของคู่มือนี้ ป้ายกำกับและ ปุ่มต่างๆ จะได้รับการแปลโดยใส่เครื่องหมายภาษาอังกฤษไว้ในวงเล็บ
การผสานรวมและรูปแบบโฆษณาที่รองรับ
Ad Manager อะแดปเตอร์สื่อกลางสำหรับ i-mobile มี ความสามารถต่อไปนี้
การผสานรวม | |
---|---|
การเสนอราคา | |
น้ำตก | |
รูปแบบ | |
แบนเนอร์ | |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว |
ข้อกำหนด
- Unity 5.6 ขึ้นไป
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุด
- เพื่อทำให้ใช้งานได้ใน Android
- API ของ Android ระดับ 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
ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณา Google Mobile เวอร์ชันล่าสุดสำหรับ i-mobile
จากลิงก์ดาวน์โหลดในบันทึกการเปลี่ยนแปลง
และแตกไฟล์ GoogleMobileAdsIMobileMediation.unitypackage
ออกจากไฟล์ ZIP
ในเครื่องมือแก้ไขโปรเจ็กต์ Unity ให้เลือกเนื้อหา > นำเข้าแพ็กเกจ >
แพ็กเกจที่กำหนดเอง แล้วค้นหา GoogleMobileAdsIMobileMediation.unitypackage
ที่คุณดาวน์โหลดไว้ ตรวจสอบว่าได้เลือกไฟล์ทั้งหมดแล้ว และคลิก
นำเข้า
จากนั้นเลือกชิ้นงาน > ตัวแก้ไขบริการ Google Play > รีโซลเวอร์ Android >
บังคับให้แก้ไข ไลบรารีตัวแปลค่าบริการ Unity Play จะทำงาน
การแก้ไขทรัพยากร Dependency ใหม่ตั้งแต่ต้นและคัดลอกทรัพยากร Dependency ที่ประกาศไว้ไปยัง
ไดเรกทอรี 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 แสดงผลข้อผิดพลาด ดูรายละเอียดเพิ่มเติมในรหัส |
101 | พารามิเตอร์เซิร์ฟเวอร์ i-mobile ที่กำหนดค่าใน Ad Manager UI ขาดหายไป/ไม่ถูกต้อง |
102 | ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ i-mobile รองรับ |
103 | i-mobile แสดงโฆษณาไม่สำเร็จ |
104 | i-mobile แสดงผลอาร์เรย์โฆษณาเนทีฟที่ว่างเปล่า |
105 | i-mobile ดาวน์โหลดองค์ประกอบโฆษณาเนทีฟไม่สำเร็จ |
106 | i-mobile ไม่สนับสนุนการขอโฆษณาคั่นระหว่างหน้าหลายรายการโดยใช้รหัส Spot เดียวกัน |
บันทึกการเปลี่ยนแปลงปลั๊กอิน 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 Plugin เวอร์ชัน 9.0.0
เวอร์ชัน 1.3.3
- สนับสนุนอะแดปเตอร์ i-mobile Android เวอร์ชัน 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
- รองรับอะแดปเตอร์ iOS i-mobile เวอร์ชัน 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
- สร้างและทดสอบโดยใช้ Google Mobile Ads Unity Plugin เวอร์ชัน 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
เวอร์ชัน 1.2.0
เวอร์ชัน 1.1.0
เวอร์ชัน 1.0.2
เวอร์ชัน 1.0.1
เวอร์ชัน 1.0.0
- เปิดตัวครั้งแรก
- รองรับอะแดปเตอร์ i-mobile Android เวอร์ชัน 2.0.20.1
- รองรับอะแดปเตอร์ iOS i-mobile เวอร์ชัน 2.0.29.0