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

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

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

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

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

ข้อกำหนด

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

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

• สื่อกลางเสร็จสมบูรณ์ คู่มือเริ่มต้นใช้งาน

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

ลงชื่อสมัครใช้หรือเข้าสู่ระบบบัญชี i-mobile

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

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

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

ไปที่แท็บ 広告スポット管理 (การจัดการพื้นที่โฆษณา) แล้วคลิกปุ่ม新規広告スポット (พื้นที่โฆษณาใหม่)

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

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

จดบันทึก パットテテーID (Publisher ID), จัดทำデテアID (Media ID) และ IDポットID (Spot ID) คุณจะต้องใช้พารามิเตอร์เหล่านี้ในภายหลังเมื่อกำหนดค่า i-mobile สำหรับสื่อกลางใน AdMob UI

ขั้นตอนที่ 2: ตั้งค่าดีมานด์ i-mobile ใน 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: ทดสอบการใช้งาน

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

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

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

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

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

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

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

อะแดปเตอร์ i-mobile จะมีข้อมูลดังต่อไปนี้ ช่อง สำหรับ GADNativeAd

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

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

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

ต่อไปนี้คือรหัสและข้อความที่มาพร้อมกับข้อผิดพลาดที่อะแดปเตอร์ 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

• ลดความจําเป็นในการใช้ Google Mobile Ads SDK เวอร์ชัน 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

• เพิ่มรหัสและข้อความแสดงข้อผิดพลาดมาตรฐานสำหรับอะแดปเตอร์
• ตอนนี้อะแดปเตอร์จะจํากัดคําขอโฆษณาคั่นระหว่างหน้าหลายรายการโดยใช้รหัสจุดโฆษณา i-mobile เดียวกัน
• ตอนนี้อะแดปเตอร์จะส่งต่อ -nativeAdWillLeaveApplication: callback เมื่อมีการแตะโฆษณาเนทีฟ
• ตอนนี้ต้องใช้ 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

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

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

เวอร์ชัน 2.0.31.0

• ยืนยันความเข้ากันได้กับ i-mobile SDK เวอร์ชัน 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