คู่มือนี้จะแสดงวิธีใช้ Google Mobile Ads SDK เพื่อโหลดและแสดงโฆษณาจาก i-mobile โดยใช้ สื่อกลาง, ครอบคลุมการผสานรวม Waterfall ซึ่งครอบคลุมถึงวิธีเพิ่ม i-mobile ลงในหน่วยโฆษณา การกำหนดค่าสื่อกลาง และวิธีผสานรวม i-mobile SDK และอะแดปเตอร์ แอป iOS
อินเทอร์เฟซหน้าแดชบอร์ดสำหรับ i-mobile ใช้ข้อความภาษาญี่ปุ่นสำหรับป้ายกำกับ ปุ่ม และคำอธิบาย ภาพหน้าจอในคู่มือนี้ไม่มีคำแปล แต่ในคำอธิบายและวิธีการของคู่มือนี้ ป้ายกำกับและ ปุ่มต่างๆ จะได้รับการแปลโดยใส่เครื่องหมายภาษาอังกฤษไว้ในวงเล็บ
การผสานรวมและรูปแบบโฆษณาที่รองรับ
อะแดปเตอร์สื่อกลางสำหรับ i-mobile มีความสามารถต่อไปนี้
การผสานรวม | |
---|---|
การเสนอราคา | |
น้ำตก | |
รูปแบบ | |
แบนเนอร์ | |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว | |
เนทีฟ |
ข้อกำหนด
- เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
Google Mobile Ads SDK เวอร์ชันล่าสุด
สื่อกลางเสร็จสมบูรณ์ คู่มือเริ่มต้นใช้งาน
ขั้นตอนที่ 1: กำหนดค่าใน UI ของ i-mobile
ขั้นตอนที่ 2: ตั้งค่าความต้องการสำหรับอุปกรณ์เคลื่อนที่ใน Ad Manager UI
ขั้นตอนที่ 3: นำเข้า SDK และอะแดปเตอร์ i-mobile
การใช้ CocoaPods (แนะนำ)
เพิ่มบรรทัดต่อไปนี้ลงใน Podfile ของโปรเจ็กต์
pod 'GoogleMobileAdsMediationIMobile'
จากบรรทัดคำสั่งให้เรียกใช้คำสั่งต่อไปนี้
pod install --repo-update
การผสานรวมด้วยตนเอง
- ดาวน์โหลด i-mobile เวอร์ชันล่าสุด
SDK และลิงก์
ImobileSdkAds.framework
ในโปรเจ็กต์ของคุณ - ดาวน์โหลดอะแดปเตอร์ i-mobile เวอร์ชันล่าสุดจากลิงก์ดาวน์โหลดใน
บันทึกการเปลี่ยนแปลงและ
ลิงก์
IMobileAdapter.framework
ในโปรเจ็กต์
ขั้นตอนที่ 4: เพิ่มโค้ดที่จำเป็น
การผสานรวม SKAdNetwork
ปฏิบัติตามเอกสารประกอบของ i-mobile
เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist
ของโปรเจ็กต์
ขั้นตอนที่ 5: ทดสอบการใช้งาน
เปิดใช้โฆษณาทดสอบ
อย่าลืม ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ Ad Manager i-mobile จะเตรียม Spot ID, รหัสสื่อ และ รหัสผู้เผยแพร่โฆษณา สำหรับการทดสอบไว้ทดสอบ ซึ่งคุณจะดูได้ที่นี่
ยืนยันโฆษณาทดสอบ
ในการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก i-mobile ให้เปิดใช้ การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้ i-mobile (Waterfall) แหล่งที่มาของโฆษณา
ขั้นตอนที่ไม่บังคับ
การใช้โฆษณาเนทีฟ
การแสดงโฆษณา
อะแดปเตอร์ i-mobile จะป้อนข้อมูลต่อไปนี้
ช่อง
สําหรับ
GADNativeAd
ช่อง | เนื้อหารวมอยู่โดยอะแดปเตอร์ i-mobile เสมอ |
---|---|
บรรทัดแรก | |
รูปภาพ | |
เนื้อความ | |
ไอคอนแอป | 1 |
คำกระตุ้นการตัดสินใจ | |
การให้ดาว | |
ร้านค้า | |
ราคา |
1 สำหรับโฆษณาเนทีฟ i-mobile SDK จะไม่มีเนื้อหาไอคอนแอป แต่อะแดปเตอร์ i-mobile จะสร้างไอคอนแอปด้วยรูปภาพโปร่งใสแทน
รหัสข้อผิดพลาด
หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก i-mobile
ผู้เผยแพร่โฆษณาสามารถตรวจสอบข้อผิดพลาดที่แท้จริงจากการตอบกลับโฆษณาโดยใช้
GADResponseInfo.adNetworkInfoArray
ในคลาสต่อไปนี้
รูปแบบ | ชื่อชั้นเรียน |
---|---|
แบนเนอร์ | IMobileAdapter |
โฆษณาคั่นระหว่างหน้า | IMobileAdapter |
เนทีฟ | GADMediationAdapterIMobile |
ต่อไปนี้คือรหัสและข้อความที่มาพร้อมกับข้อผิดพลาดที่อะแดปเตอร์ i-mobile แสดงเมื่อโหลดโฆษณาไม่สําเร็จ
รหัสข้อผิดพลาด | เหตุผล |
---|---|
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 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
- ลดความจําเป็นในการใช้ Google Mobile Ads SDK เวอร์ชัน 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