ผสานรวม i-mobile เข้ากับสื่อกลาง

คู่มือนี้แสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดงโฆษณาจาก i-mobile โดยใช้ สื่อกลาง AdMob, ในการผสานรวม Waterfall ซึ่งครอบคลุมถึงวิธีเพิ่ม i-mobile ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม i-mobile SDK และอะแดปเตอร์เข้ากับ แอป

อินเทอร์เฟซแดชบอร์ดสำหรับ i-mobile ใช้ข้อความภาษาญี่ปุ่นสำหรับป้ายกำกับ ปุ่ม และคำอธิบาย ภาพหน้าจอในคู่มือนี้ยังไม่ได้รับการแปล แต่ในคำอธิบายและวิธีการของคู่มือนี้ ป้ายกำกับและปุ่มจะได้รับการแปลโดยเป็นภาษาอังกฤษในวงเล็บที่เทียบเท่ากัน

การผสานรวมและรูปแบบโฆษณาที่รองรับ

อะแดปเตอร์สื่อกลางสำหรับ i-mobile มีความสามารถดังต่อไปนี้

การผสานรวม
การเสนอราคา
น้ำตก
รูปแบบ
แบนเนอร์
โฆษณาคั่นระหว่างหน้า
ได้รับรางวัลแล้ว
เนทีฟ

ข้อกำหนด

• เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป

• SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุด

• ทำตามสื่อกลาง คู่มือเริ่มต้นใช้งาน

ขั้นตอนที่ 1: กำหนดค่าใน UI ของ i-mobile

注册或登录您的 i-mobile 账号。

点击 ika イト/affiliate Management（网站/应用管理）标签页和应用平台对应的按钮，将您的应用添加到 i-mobile 信息中心。

填写表单，然后点击新规定登录按钮。

要创建新的广告插播位，请在 {5}对该/企业管理（网站/应用管理）标签页下选择您的应用。

进入支持 Clickserver 管理（广告插播位管理）标签页，然后点击新规范编写 ット (New Ad Spot) 按钮。

接下来，填写以下表单：提供支持 プット名（广告插播位名称）、提供有关某个广告 的小程序 （广告 Spot 尺寸） 和其他详细信息。然后，点击 新式登榜（注册）按钮。

您的新广告插播位已准备就绪。如需查看其集成详情，请点击 Action to Settings Get (Get App settings) 按钮。

请记下小吃日本 ID（发布商 ID）、手机 ID（媒体 ID）和彷设有 ID (Spot ID)。您稍后在 AdMob 界面中为中介配置 i-mobile 时，将会用到这些参数。

ขั้นตอนที่ 2: ตั้งค่าความต้องการสำหรับอุปกรณ์เคลื่อนที่ใน AdMob UI

กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา

ขั้นตอนที่ 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
ร้านค้า
ราคา

¹ สำหรับโฆษณาเนทีฟ 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