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

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

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

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

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

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

ข้อกำหนด

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

• Google Mobile Ads SDK เวอร์ชันล่าสุด

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

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

ลงชื่อสมัครใช้หรือบันทึก เข้าในบัญชี i-mobile

เพิ่มแอปลงในแดชบอร์ด i-mobile โดยคลิกแท็บサイト／アプリ管理 (การจัดการเว็บไซต์/แอปพลิเคชัน) และปุ่มสำหรับแพลตฟอร์มของแอป

Android

iOS

กรอกแบบฟอร์มแล้วคลิกปุ่ม chromeos規登録 (ลงชื่อสมัครใช้)

Android

iOS

หมายเหตุ: i-mobile ต้องอนุมัติการลงทะเบียนของคุณ เมื่อได้รับอนุมัติแล้ว คุณสามารถ สร้างสปอตโฆษณา

หากต้องการสร้างสปอตโฆษณาใหม่ ให้เลือกแอปใต้ แท็บ サイット/アプยิ管型 (การจัดการเว็บไซต์/แอปพลิเคชัน)

Android

iOS

ไปที่แท็บ 広告のポット管การรับส่งข้อความ (การจัดการสปอตโฆษณา) แล้วคลิก สี่เหลี่ยม規広告本ポット (สปอตโฆษณาใหม่)

จากนั้นกรอกแบบฟอร์มโดยระบุ 広告スポット名 (ชื่อช่องโฆษณา), 広告スポットサイズ (ขนาดช่องโฆษณา) และรายละเอียดอื่นๆ จากนั้นคลิกปุ่ม 新規登録 (ลงชื่อสมัครใช้)

ตําแหน่งโฆษณาใหม่พร้อมใช้งานแล้ว หากต้องการดูรายละเอียดการผสานรวม ให้คลิก ปุ่ม アプ 定取得 (รับการตั้งค่าแอป)

จดบันทึก パブリッシャーID (รหัสผู้เผยแพร่โฆษณา), メディアID (รหัสสื่อ) และ スポットID (รหัสโฆษณา) คุณต้องใช้พารามิเตอร์เหล่านี้ในภายหลังเมื่อกําหนดค่า i-mobile สําหรับสื่อกลางใน UI ของ AdMob

Android

iOS

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

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

Android

ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสําหรับ Android

iOS

โปรดดูวิธีการในขั้นตอนที่ 2 ในคู่มือสำหรับ iOS

ขั้นตอนที่ 3: นำเข้า SDK และอะแดปเตอร์ i-mobile

หมายเหตุ: ไม่สามารถผสานรวม SDK โฆษณาบนอุปกรณ์เคลื่อนที่ของ i-mobile และ Google ที่ใช้ร่วมกันได้ เวอร์ชันต่างๆ อาจทำให้เกิดปัญหาในการสร้างได้

การใช้ 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: ทดสอบการใช้งาน

เปิดใช้โฆษณาทดสอบ

อย่าลืม ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ AdMob i-mobile จะเตรียม Spot ID, รหัสสื่อ และ รหัสผู้เผยแพร่โฆษณา สำหรับการทดสอบไว้ทดสอบ ซึ่งคุณจะดูได้ที่นี่

สำคัญ: ปิดใช้โหมดทดสอบสำหรับ AdMob และ i-mobile ก่อนเปิดตัวแอป

ยืนยันโฆษณาทดสอบ

ในการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก i-mobile ให้เปิดใช้ การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้ i-mobile (Waterfall) แหล่งที่มาของโฆษณา

ขั้นตอนที่ไม่บังคับ

การใช้โฆษณาเนทีฟ

การแสดงโฆษณา

อะแดปเตอร์ i-mobile จะมีข้อมูลดังนี้ คำอธิบายช่องของโฆษณาเนทีฟขั้นสูง สำหรับ GADNativeAd

ช่อง	เนื้อหารวมอยู่โดยอะแดปเตอร์ i-mobile เสมอ
บรรทัดแรก
รูปภาพ
เนื้อความ
ไอคอนแอป	^1
คำกระตุ้นการตัดสินใจ
การให้ดาว
ร้านค้า
ราคา

¹ สำหรับโฆษณาเนทีฟ i-mobile SDK จะไม่มีเนื้อหาไอคอนแอป แต่ อะแดปเตอร์ i-mobile จะแสดงไอคอนแอปด้วยรูปภาพแบบโปร่งใส

รหัสข้อผิดพลาด

หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก i-mobile ผู้เผยแพร่โฆษณาสามารถตรวจสอบข้อผิดพลาดที่แท้จริงจากการตอบกลับโฆษณาโดยใช้ GADResponseInfo.adNetworkInfoArray ในคลาสต่อไปนี้

รูปแบบ	ชื่อชั้นเรียน
แบนเนอร์	IMobileAdapter
โฆษณาคั่นระหว่างหน้า	IMobileAdapter
เนทีฟ	GADMediationAdapterIMobile

นี่คือรหัสและข้อความประกอบที่อะแดปเตอร์ 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 ไม่รองรับคําขอโฆษณาคั่นระหว่างหน้าหลายรายการโดยใช้รหัสตำแหน่งโฆษณาเดียวกัน

บันทึกการเปลี่ยนแปลงอะแดปเตอร์สื่อกลาง i-mobile iOS

เวอร์ชัน 2.3.4.1

• อัปเดต CFBundleShortVersionString ให้มีคอมโพเนนต์ 3 รายการแทน 4 รายการ

สร้างและทดสอบด้วย:

• Google Mobile Ads SDK เวอร์ชัน 11.10.0
• i-mobile SDK เวอร์ชัน 2.3.4

เวอร์ชัน 2.3.4.0

• ยืนยันความเข้ากันได้กับ i-mobile SDK 2.3.4
• เพิ่มการรองรับเพื่อแสดงเวอร์ชัน i-mobile SDK ใน 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 ขึ้นไปอย่างไม่ผ่อนปรน

สร้างขึ้นและทดสอบด้วย

• Google Mobile Ads SDK เวอร์ชัน 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 ขึ้นไป

สร้างและทดสอบด้วย

• Google Mobile Ads SDK เวอร์ชัน 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