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

คู่มือนี้จะแสดงวิธีใช้ 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

หมายเหตุ: ไม่สามารถผสานรวม 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: ทดสอบการใช้งาน

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

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

สำคัญ: ปิดใช้โหมดทดสอบสำหรับ Ad Manager และ 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 ที่กำหนดค่าใน 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