คู่มือนี้แสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดงโฆษณาจาก i-mobile โดยใช้ สื่อกลาง AdMob, ในการผสานรวม Waterfall ซึ่งครอบคลุมถึงวิธีเพิ่ม i-mobile ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม i-mobile SDK และอะแดปเตอร์เข้ากับ แอป
อินเทอร์เฟซแดชบอร์ดสำหรับ i-mobile ใช้ข้อความภาษาญี่ปุ่นสำหรับป้ายกำกับ ปุ่ม และคำอธิบาย ภาพหน้าจอในคู่มือนี้ยังไม่ได้รับการแปล แต่ในคำอธิบายและวิธีการของคู่มือนี้ ป้ายกำกับและปุ่มจะได้รับการแปลโดยเป็นภาษาอังกฤษในวงเล็บที่เทียบเท่ากัน
การผสานรวมและรูปแบบโฆษณาที่รองรับ
อะแดปเตอร์สื่อกลางสำหรับ i-mobile มีความสามารถดังต่อไปนี้
การผสานรวม | |
---|---|
การเสนอราคา | |
น้ำตก | |
รูปแบบ | |
แบนเนอร์ | |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว | |
เนทีฟ |
ข้อกำหนด
- เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุด
ทำตามสื่อกลาง คู่มือเริ่มต้นใช้งาน
ขั้นตอนที่ 1: กำหนดค่าใน UI ของ i-mobile
点击 ika イト/affiliate Management(网站/应用管理)标签页和应用平台对应的按钮,将您的应用添加到 i-mobile 信息中心。
Android
iOS
填写表单,然后点击新规定登录按钮。
Android
iOS
要创建新的广告插播位,请在 {5}对该/企业管理(网站/应用管理)标签页下选择您的应用。
Android
iOS
进入支持 Clickserver 管理(广告插播位管理)标签页,然后点击新规范编写 ット (New Ad Spot) 按钮。
接下来,填写以下表单:提供支持 プット名(广告插播位名称)、提供有关某个广告 的小程序 (广告 Spot 尺寸) 和其他详细信息。然后,点击 新式登榜(注册)按钮。
您的新广告插播位已准备就绪。如需查看其集成详情,请点击 Action to Settings Get (Get App settings) 按钮。
请记下小吃日本 ID(发布商 ID)、手机 ID(媒体 ID)和彷设有 ID (Spot ID)。您稍后在 AdMob 界面中为中介配置 i-mobile 时,将会用到这些参数。
Android
iOS
ขั้นตอนที่ 2: ตั้งค่าความต้องการสำหรับอุปกรณ์เคลื่อนที่ใน AdMob UI
กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา
Android
ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสําหรับ Android
iOS
โปรดดูวิธีการในขั้นตอนที่ 2 ในคู่มือสำหรับ iOS
ขั้นตอนที่ 3: นำเข้า SDK และอะแดปเตอร์ i-mobile
การใช้ CocoaPods (แนะนำ)
เพิ่มบรรทัดต่อไปนี้ลงใน Podfile ของโปรเจ็กต์
pod 'GoogleMobileAdsMediationIMobile'
จากบรรทัดคำสั่งให้เรียกใช้คำสั่งต่อไปนี้
pod install --repo-update
การผสานรวมด้วยตนเอง
- ดาวน์โหลด i-mobile
SDK และลิงก์
ImobileSdkAds.framework
เวอร์ชันล่าสุดในโปรเจ็กต์ของคุณ - ดาวน์โหลดอะแดปเตอร์ i-mobile เวอร์ชันล่าสุดจากลิงก์ดาวน์โหลดใน Changelog และลิงก์
IMobileAdapter.framework
ในโปรเจ็กต์ของคุณ
ขั้นตอนที่ 4: เพิ่มโค้ดที่จําเป็น
การผสานรวม SKAdNetwork
ทำตามเอกสารประกอบของ i-mobile เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist
ของโปรเจ็กต์
ขั้นตอนที่ 5: ทดสอบการใช้งาน
เปิดใช้โฆษณาทดสอบ
อย่าลืม ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ AdMob i-mobile จะเตรียม Spot ID, รหัสสื่อ และ รหัสผู้เผยแพร่โฆษณา สำหรับการทดสอบไว้ทดสอบ ซึ่งคุณจะดูได้ที่นี่
ยืนยันโฆษณาทดสอบ
ในการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก i-mobile ให้เปิดใช้ การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้ i-mobile (Waterfall) แหล่งที่มาของโฆษณา
ขั้นตอนที่ไม่บังคับ
การใช้โฆษณาเนทีฟ
การแสดงโฆษณา
อะแดปเตอร์ i-mobile จะมีข้อมูลดังต่อไปนี้
คำอธิบายช่องขั้นสูงของโฆษณาเนทีฟ
สำหรับ
GADNativeAd
ฟิลด์ | เนื้อหารวมอยู่โดยอะแดปเตอร์ i-mobile เสมอ |
---|---|
บรรทัดแรก | |
รูปภาพ | |
เนื้อความ | |
ไอคอนของแอป | 1 |
คำกระตุ้นให้ดำเนินการ (Call-To-Action) | |
Star rating | |
ร้านค้า | |
ราคา |
1 สำหรับโฆษณาเนทีฟ i-mobile SDK จะไม่มีเนื้อหาไอคอนแอป แต่อะแดปเตอร์ i-mobile จะแสดงไอคอนแอปด้วยรูปภาพแบบโปร่งใส
รหัสข้อผิดพลาด
หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก i-mobile
ผู้เผยแพร่โฆษณาสามารถตรวจสอบข้อผิดพลาดที่เกี่ยวข้องจากการตอบกลับโฆษณาโดยใช้
GADResponseInfo.adNetworkInfoArray
ในชั้นเรียนต่อไปนี้
รูปแบบ | ชื่อชั้นเรียน |
---|---|
แบนเนอร์ | IMobileAdapter |
โฆษณาคั่นระหว่างหน้า | IMobileAdapter |
เนทีฟ | GADMediationAdapterIMobile |
ต่อไปนี้เป็นรหัสและข้อความประกอบที่อะแดปเตอร์ i-mobile แสดงเมื่อโฆษณาโหลดไม่สำเร็จ
รหัสข้อผิดพลาด | เหตุผล |
---|---|
0-99 | i-mobile SDK แสดงผลข้อผิดพลาด ดูรายละเอียดเพิ่มเติมในรหัส |
101 | i-mobile ต้องใช้บริบท Activity เพื่อโหลดโฆษณา |
102 | พารามิเตอร์เซิร์ฟเวอร์ i-mobile ที่กำหนดค่าใน AdMob UI ขาดหายไป/ไม่ถูกต้อง |
103 | ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ i-mobile รองรับ |
104 | Callback ที่ประสบความสำเร็จสำหรับการโหลดโฆษณาเนทีฟของ i-mobile แสดงผลรายการโฆษณาเนทีฟที่ว่างเปล่า |
0-10 | i-mobile SDK แสดงผลข้อผิดพลาด ดูรายละเอียดเพิ่มเติมในรหัส |
101 | พารามิเตอร์เซิร์ฟเวอร์ i-mobile ที่กำหนดค่าใน AdMob UI ขาดหายไป/ไม่ถูกต้อง |
102 | ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ i-mobile รองรับ |
103 | i-mobile แสดงโฆษณาไม่สำเร็จ |
104 | i-mobile แสดงผลอาร์เรย์โฆษณาเนทีฟที่ว่างเปล่า |
105 | i-mobile ดาวน์โหลดองค์ประกอบโฆษณาเนทีฟไม่สำเร็จ |
106 | i-mobile ไม่สนับสนุนการขอโฆษณาคั่นระหว่างหน้าหลายรายการโดยใช้รหัส Spot เดียวกัน |
บันทึกการเปลี่ยนแปลงอะแดปเตอร์สื่อกลาง i-mobile iOS
เวอร์ชัน 2.3.4.0
- ยืนยันความเข้ากันได้กับ i-mobile SDK 2.3.4
- เพิ่มการสนับสนุนเพื่อแสดงเวอร์ชัน SDK ของ i-mobile ใน
adSDKVersion
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 11.2.0
- i-mobile SDK เวอร์ชัน 2.3.4
เวอร์ชัน 2.3.3.0
- ยืนยันความเข้ากันได้กับ i-mobile SDK 2.3.3
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 11.1.0
- i-mobile SDK เวอร์ชัน 2.3.3
เวอร์ชัน 2.3.2.1
- นำวิธีผู้รับมอบสิทธิ์
willBackgroundApplication
ที่เลิกใช้งานแล้วออกจากการใช้งานแบนเนอร์ โฆษณาคั่นระหว่างหน้า และโฆษณาเนทีฟ - ตอนนี้ต้องใช้ iOS เวอร์ชัน 12.0 ขึ้นไป
- ตอนนี้ต้องใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 11.0 ขึ้นไป
- รวม
Info.plist
ไว้ในเฟรมเวิร์กภายในIMobileAdapter.xcframework
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 11.0.1
- i-mobile SDK เวอร์ชัน 2.3.2
เวอร์ชัน 2.3.2.0
- ยืนยันความเข้ากันได้กับ i-mobile SDK 2.3.2
- นำการรองรับสถาปัตยกรรม
armv7
ออกแล้ว - ตอนนี้ต้องใช้ iOS เวอร์ชัน 11.0 ขึ้นไป
- ตอนนี้ต้องใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 10.4.0 ขึ้นไป
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 10.4.0
- i-mobile SDK เวอร์ชัน 2.3.2
เวอร์ชัน 2.3.1.0
- ยืนยันความเข้ากันได้กับ i-mobile SDK 2.3.1
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 10.3.0
- i-mobile SDK เวอร์ชัน 2.3.1
เวอร์ชัน 2.3.0.1
- ตอนนี้ต้องใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 10.0.0 ขึ้นไป
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 10.0.0
- i-mobile SDK เวอร์ชัน 2.3.0
เวอร์ชัน 2.3.0.0
- ยืนยันความเข้ากันได้กับ i-mobile SDK 2.3.0
- ตอนนี้ต้องใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 9.8.0 ขึ้นไป
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 9.13.0
- i-mobile SDK เวอร์ชัน 2.3.0
เวอร์ชัน 2.2.0.1
- ตอนนี้ต้องใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 9.0.0 ขึ้นไป
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 9.0.0
- i-mobile SDK เวอร์ชัน 2.2.0
เวอร์ชัน 2.2.0.0
- ยืนยันความเข้ากันได้กับ i-mobile SDK เวอร์ชัน 2.2.0
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 8.13.0
- i-mobile SDK เวอร์ชัน 2.2.0
เวอร์ชัน 2.1.0.1
- อาศัย SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 8.0.0 ขึ้นไปอย่างไม่ผ่อนปรน
สร้างและทดสอบด้วย
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 8.4.0
- i-mobile SDK เวอร์ชัน 2.1.0
เวอร์ชัน 2.1.0.0
- ยืนยันความเข้ากันได้กับ i-mobile SDK เวอร์ชัน 2.1.0
- ตอนนี้ต้องใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 8.1.0 ขึ้นไป
- อัปเดตอะแดปเตอร์ให้ใช้รูปแบบ
.xcframework
แล้ว
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 8.1.0
- i-mobile SDK เวอร์ชัน 2.1.0
เวอร์ชัน 2.0.33.1
- เพิ่มรหัสและข้อความแสดงข้อผิดพลาดของอะแดปเตอร์มาตรฐานแล้ว
- ตอนนี้อะแดปเตอร์จำกัดการขอโฆษณาคั่นระหว่างหน้าหลายรายการที่ใช้รหัส Spot ของ i-mobile เดียวกัน
- ตอนนี้อะแดปเตอร์จะส่งต่อ Callback
-nativeAdWillLeaveApplication:
เมื่อมีการแตะโฆษณาเนทีฟ - ตอนนี้ต้องใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 7.68.0 ขึ้นไป
สร้างและทดสอบด้วย
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 7.68.0
- i-mobile SDK เวอร์ชัน 2.0.33
เวอร์ชัน 2.0.33.0
- ยืนยันความเข้ากันได้กับ i-mobile SDK เวอร์ชัน 2.0.33
- ตอนนี้ต้องใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 7.65.0 ขึ้นไป
- ขณะนี้ต้องใช้ iOS เวอร์ชัน 9.0 ขึ้นไป
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 7.65.0
- i-mobile SDK เวอร์ชัน 2.0.33
เวอร์ชัน 2.0.32.0
- ยืนยันความเข้ากันได้กับ i-mobile SDK เวอร์ชัน 2.0.32
- ตอนนี้ต้องใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 7.60.0 ขึ้นไป
- เพิ่มการรองรับการปรับขนาดโฆษณาขนาด 320x50 และ 320x100 เพื่อให้พอดีกับขนาดคำขอแบนเนอร์แบบปรับขนาดได้มากยิ่งขึ้น
- ยกเลิกการสนับสนุนสถาปัตยกรรม i386
สร้างและทดสอบด้วย
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 7.60.0
- i-mobile SDK เวอร์ชัน 2.0.32
เวอร์ชัน 2.0.31.0
- ยืนยันความเข้ากันได้กับ i-mobile SDK เวอร์ชัน 2.0.31
สร้างและทดสอบด้วย
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 7.53.1
- i-mobile SDK เวอร์ชัน 2.0.31
เวอร์ชัน 2.0.29.0
- การเผยแพร่ครั้งแรก
- เพิ่มการรองรับโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า และโฆษณาเนทีฟ
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 7.52.0
- i-mobile SDK เวอร์ชัน 2.0.29