คู่มือนี้จะแสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดงโฆษณาจาก i-mobile โดยใช้สื่อกลาง ซึ่งครอบคลุมการผสานรวม Waterfall โดยจะครอบคลุมวิธีการเพิ่ม i-mobile ในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม SDK ของ i-mobile และอะแดปเตอร์ลงใน iOS แอป
อินเทอร์เฟซแดชบอร์ดสำหรับ i-mobile ใช้ข้อความภาษาญี่ปุ่นสำหรับป้ายกำกับ ปุ่ม และคำอธิบาย ภาพหน้าจอในคู่มือนี้ยังไม่ได้รับการแปล แต่ในคำอธิบายและคำแนะนำของคู่มือนี้ ป้ายกำกับและปุ่มจะแปลด้วยชื่อที่เทียบเท่าภาษาอังกฤษในวงเล็บ
การผสานรวมที่รองรับและรูปแบบโฆษณา
Ad Manager อะแดปเตอร์สื่อกลางสำหรับ i-mobile มีความสามารถดังต่อไปนี้
การผสานรวม | |
---|---|
การเสนอราคา | |
น้ำตก | |
รูปแบบ | |
แบนเนอร์ | |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว | |
เนทีฟ |
ข้อกำหนด
- เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
SDK โฆษณาบนอุปกรณ์เคลื่อนที่ของ Google ล่าสุด
ทำตามสื่อกลาง คู่มือเริ่มต้นใช้งาน
ขั้นตอนที่ 1: ตั้งค่าการกำหนดค่าใน UI ของ i-mobile
ลงชื่อสมัครใช้หรือเข้าสู่ระบบบัญชี i-mobile
เพิ่มแอปไปยังแดชบอร์ด i-mobile โดยคลิกแท็บ サイト/アプ이管理 (การจัดการเว็บไซต์/แอปพลิเคชัน) และปุ่มสำหรับแพลตฟอร์มของแอป
กรอกแบบฟอร์มแล้วคลิกปุ่ม {@/規登録 (ลงชื่อสมัครใช้)
หากต้องการสร้างสปอตโฆษณาใหม่ ให้เลือกแอปในแท็บ サイト/アプク管理 (การจัดการเว็บไซต์/แอปพลิเคชัน)
ไปที่แท็บ 広告ポット管理 (Ad Spot Management) แล้วคลิกปุ่ม ของคุณถูกจัด จำพวกนี้ได้ 広告ポット (New Ad Spot)
ขั้นตอนถัดไป ให้กรอกข้อมูลในแบบฟอร์มโดยระบุ 広告すポットホ (ชื่อ Ad Spot name), 広告ที่แสดงอยู่ในポットサイズ (ขนาดสปอตโฆษณา) และรายละเอียดอื่นๆ จากนั้นคลิกปุ่ม 䦏登録 (ลงชื่อสมัครใช้)
สปอตโฆษณาใหม่ของคุณพร้อมแล้ว หากต้องการดูรายละเอียดการผสานรวม ให้คลิกปุ่ม アプ設定取得 (รับการตั้งค่าแอป)
จดบันทึก パポット (รหัสผู้เผยแพร่โฆษณา), メデ設アID (Media ID) และ customポットID (Spot ID) คุณจะต้องใช้พารามิเตอร์เหล่านี้ในภายหลังเมื่อกำหนดค่า i-mobile สำหรับสื่อกลางใน Ad Manager UI
ขั้นตอนที่ 2: ตั้งค่าความต้องการสำหรับ i-mobile ใน Ad Manager UI
กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา
ลงชื่อเข้าใช้บัญชี Ad Manager
ไปที่การแสดงโฆษณา > กลุ่มผลตอบแทน แล้วคลิกปุ่มกลุ่มผลตอบแทนใหม่
ป้อนชื่อที่ไม่ซ้ำสำหรับกลุ่มผลตอบแทน ตั้งค่าสถานะเป็นใช้งานอยู่ เลือกรูปแบบโฆษณา และตั้งค่าประเภทพื้นที่โฆษณาเป็นแอปบนอุปกรณ์เคลื่อนที่ ในส่วนการกำหนดเป้าหมาย > พื้นที่โฆษณา ให้เลือกหน่วยโฆษณาภายใต้พื้นที่โฆษณาและแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ที่คุณต้องการเพิ่มสื่อกลาง
จากนั้น คลิกปุ่มเพิ่มพาร์ทเนอร์ผลตอบแทน
หากมีพาร์ทเนอร์ผลตอบแทนสำหรับi-mobileอยู่แล้ว คุณก็เลือกได้ มิเช่นนั้น ให้เลือกสร้างพาร์ทเนอร์ผลตอบแทนใหม่
เลือก i-mobile เป็นเครือข่ายโฆษณา ป้อนชื่อที่ไม่ซ้ำ และเปิดใช้สื่อกลาง
เปิดการรวบรวมข้อมูลอัตโนมัติ แล้วป้อนLogin name and API Password
เมื่อเลือกพาร์ทเนอร์ผลตอบแทนแล้ว ให้เลือกสื่อกลาง SDK บนอุปกรณ์เคลื่อนที่เป็นประเภทการผสานรวม iOS เป็นแพลตฟอร์ม และเลือกใช้งานอยู่เป็นสถานะ ป้อนPublisher ID, Media ID and Spot ID ที่ได้รับในส่วนก่อนหน้านี้ จากนั้นป้อนค่า CPM เริ่มต้น
คลิกบันทึกที่ด้านล่างของหน้าเมื่อทำเสร็จแล้ว
ขั้นตอนที่ 3: นำเข้า SDK และอะแดปเตอร์ i-mobile
การใช้ CocoaPods (แนะนำ)
เพิ่มบรรทัดต่อไปนี้ลงใน Podfile ของโปรเจ็กต์
pod 'GoogleMobileAdsMediationIMobile'
จากการเรียกใช้บรรทัดคำสั่ง ให้ทำดังนี้
pod install --repo-update
การผสานรวมด้วยตนเอง
- ดาวน์โหลด SDK i-mobile เวอร์ชันล่าสุดและลิงก์
ImobileSdkAds.framework
ในโปรเจ็กต์ - ดาวน์โหลดอะแดปเตอร์ i-mobile เวอร์ชันล่าสุดจากลิงก์ดาวน์โหลดใน Changelog และลิงก์
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 |
คำกระตุ้นให้ดำเนินการ (Call-To-Action) | |
Star rating | |
ร้านค้า | |
ราคา |
1 สำหรับโฆษณาเนทีฟ SDK i-mobile จะไม่มีเนื้อหาไอคอนแอป แต่อะแดปเตอร์ i-mobile จะสร้างไอคอนแอปด้วยรูปภาพโปร่งใสแทน
รหัสข้อผิดพลาด
หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก i-mobile ผู้เผยแพร่โฆษณาสามารถตรวจสอบข้อผิดพลาดที่เป็นต้นเหตุจากการตอบกลับโฆษณาได้โดยใช้
GADResponseInfo.adNetworkInfoArray
ในคลาสต่อไปนี้
รูปแบบ | ชื่อชั้นเรียน |
---|---|
แบนเนอร์ | IMobileAdapter |
โฆษณาคั่นระหว่างหน้า | IMobileAdapter |
เนทีฟ | GADMediationAdapterIMobile |
ต่อไปนี้คือรหัสและข้อความประกอบที่อะแดปเตอร์ i-mobile ส่งเมื่อโฆษณาโหลดไม่สำเร็จ
รหัสข้อผิดพลาด | เหตุผล |
---|---|
0-99 | i-mobile SDK แสดงผลข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ที่รหัส |
101 | i-mobile ต้องใช้บริบท Activity ในการโหลดโฆษณา |
102 | พารามิเตอร์เซิร์ฟเวอร์ i-mobile ที่กำหนดค่าใน Ad Manager UI ขาดหายไป/ไม่ถูกต้อง |
103 | ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ i-mobile รองรับ |
104 | การเรียกกลับที่สำเร็จในการโหลดโฆษณาเนทีฟของ 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 เดียวกัน |
บันทึกการเปลี่ยนแปลงอะแดปเตอร์สื่อกลาง iOS สำหรับ i-mobile
เวอร์ชัน 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 ขึ้นไป
สร้างและทดสอบกับ
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 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
- มีการยืนยันความเข้ากันได้กับ SDK ของ i-mobile เวอร์ชัน 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 ขึ้นไป
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 8.4.0
- i-mobile SDK เวอร์ชัน 2.1.0
เวอร์ชัน 2.1.0.0
- มีการยืนยันความเข้ากันได้กับ SDK ของ i-mobile เวอร์ชัน 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 เดียวกัน
- ตอนนี้อะแดปเตอร์จะส่งต่อโค้ดเรียกกลับ
-nativeAdWillLeaveApplication:
เมื่อมีการแตะโฆษณาเนทีฟ - ตอนนี้ต้องใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 7.68.0 ขึ้นไป
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 7.68.0
- i-mobile SDK เวอร์ชัน 2.0.33
เวอร์ชัน 2.0.33.0
- ยืนยันความเข้ากันได้กับ SDK ของ i-mobile เวอร์ชัน 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
- ยืนยันความเข้ากันได้กับ SDK ของ i-mobile เวอร์ชัน 2.0.32
- ตอนนี้ต้องใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 7.60.0 ขึ้นไป
- เพิ่มการรองรับการปรับขนาดโฆษณาขนาด 320x50 และ 320x100 เพื่อให้พอดีกับขนาดคำขอของแบนเนอร์แบบปรับขนาดได้มากยิ่งขึ้น
- ยกเลิกการรองรับสถาปัตยกรรม i386
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 7.60.0
- i-mobile SDK เวอร์ชัน 2.0.32
เวอร์ชัน 2.0.31.0
- มีการยืนยันความเข้ากันได้กับ SDK ของ i-mobile เวอร์ชัน 2.0.31
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 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