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

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

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

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

สื่อกลางของ i-mobile มีความสามารถดังต่อไปนี้

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

ข้อกำหนด

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

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

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

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

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

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

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

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

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

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

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

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

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

อัปเดต app-ads.txt

ผู้ขายที่ได้รับอนุญาตสำหรับแอป app-ads.txt เป็นความคิดริเริ่มของ IAB Tech Lab ที่ช่วยตรวจสอบว่าคุณจะขาย พื้นที่โฆษณาในแอปผ่านช่องทางที่คุณได้รับอนุญาตเท่านั้น คุณจะต้องใช้ไฟล์ app-ads.txt เพื่อป้องกันไม่ให้เสียรายได้จากโฆษณาเป็นจำนวนมาก หากยังไม่ได้ดำเนินการ ให้ สร้างไฟล์ app-ads.txt สำหรับ Ad Manager

หากต้องการใช้ app-ads.txt สำหรับ i-mobile โปรดดู คำถามที่พบบ่อย

ขั้นตอนที่ 2: ตั้งค่าดีมานด์ของ i-mobile ใน UI ของ Ad Manager

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

ลงชื่อเข้าใช้บัญชี Ad Manager

ไปที่การแสดงโฆษณา > กลุ่มผลตอบแทน แล้วคลิกปุ่มกลุ่มผลตอบแทนใหม่

ป้อนชื่อที่ไม่ซ้ำกันสำหรับกลุ่มผลตอบแทน ตั้งสถานะเป็นใช้งานอยู่ เลือกรูปแบบโฆษณา และตั้งประเภทพื้นที่โฆษณาเป็นแอปบนอุปกรณ์เคลื่อนที่ ในส่วนการกำหนดเป้าหมาย > พื้นที่โฆษณา ให้เลือกหน่วยโฆษณาในส่วน พื้นที่โฆษณาและแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ที่คุณต้องการเพิ่มสื่อกลาง

จากนั้นคลิกปุ่มเพิ่มพาร์ทเนอร์ผลตอบแทน

หากมีพาร์ทเนอร์ผลตอบแทนสำหรับ i-mobile อยู่แล้ว คุณสามารถเลือกพาร์ทเนอร์รายนั้นได้ หรือเลือกสร้างพาร์ทเนอร์ผลตอบแทนใหม่

เลือก i-mobile เป็นเครือข่ายโฆษณา ป้อนชื่อที่ไม่ซ้ำกัน แล้วเปิดใช้สื่อกลาง

เปิดการเก็บรวบรวมข้อมูลอัตโนมัติ แล้วป้อน ชื่อสำหรับเข้าสู่ระบบและรหัสผ่าน API

เมื่อเลือกพาร์ทเนอร์ผลตอบแทนแล้ว ให้เลือกสื่อกลาง SDK บนอุปกรณ์เคลื่อนที่ เป็นประเภทการผสานรวม เลือก iOS เป็น แพลตฟอร์ม และเลือกใช้งานอยู่เป็นสถานะ ป้อนรหัสผู้เผยแพร่โฆษณา รหัสสื่อ และรหัสสปอต ที่ได้รับในส่วนก่อนหน้า จากนั้นป้อนค่า CPM เริ่มต้น

คลิกบันทึกที่ด้านล่างของหน้าเมื่อดำเนินการเสร็จ

หมายเหตุ: การรวบรวมข้อมูลอัตโนมัติต้องใช้เวลารวบรวมข้อมูล 2-3 วันก่อนที่จะคำนวณค่า CPM แบบไดนามิกสำหรับเครือข่ายสื่อกลางได้อย่างแม่นยำ เมื่อคำนวณ eCPM ได้แล้ว ระบบจะอัปเดตให้คุณโดยอัตโนมัติ

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

หมายเหตุ: การผสานรวม i-mobile และ Google Mobile Ads SDK เวอร์ชันที่เข้ากันไม่ได้อาจทำให้เกิดปัญหาในการบิลด์

การใช้ CocoaPods (แนะนำ)

เพิ่มบรรทัดต่อไปนี้ลงใน Podfile ของโปรเจ็กต์

pod 'GoogleMobileAdsMediationIMobile'

จากบรรทัดคำสั่ง ให้เรียกใช้คำสั่งต่อไปนี้

pod install --repo-update

การผสานรวมด้วยตนเอง

• ดาวน์โหลด SDK ของ i-mobile เวอร์ชันล่าสุดและลิงก์ ImobileSdkAds.framework ในโปรเจ็กต์
• ดาวน์โหลดอะแดปเตอร์ i-mobile เวอร์ชันล่าสุดจากลิงก์ดาวน์โหลดในบันทึกการเปลี่ยนแปลงและลิงก์ IMobileAdapter.framework ในโปรเจ็กต์

ขั้นตอนที่ 4: เพิ่มโค้ดที่จำเป็น

การผสานรวม SKAdNetwork

ทําตามเอกสารประกอบของ i-mobile เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist ของโปรเจ็กต์

ขั้นตอนที่ 5: ทดสอบการติดตั้งใช้งาน

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

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

สำคัญ: ปิดใช้โหมดทดสอบสำหรับ Ad Manager และ i-mobile ก่อนเผยแพร่แอป

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

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

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

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

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

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

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

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

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

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

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

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

รหัสข้อผิดพลาด	เหตุผล
0-10	SDK ของ i-mobile แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ที่โค้ด
101	พารามิเตอร์เซิร์ฟเวอร์ i-mobile ที่กำหนดค่าไว้ใน UI ของ Ad Manager ขาดหายไป/ไม่ถูกต้อง
102	ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ i-mobile รองรับ
103	i-mobile แสดงโฆษณาไม่สำเร็จ
104	i-mobile แสดงผลอาร์เรย์โฆษณาเนทีฟที่ว่างเปล่า
105	i-mobile ดาวน์โหลดชิ้นงานโฆษณาเนทีฟไม่สำเร็จ
106	i-mobile ไม่รองรับการขอโฆษณาคั่นหลายรายการโดยใช้รหัสสปอตเดียวกัน

บันทึกการเปลี่ยนแปลงของ i-mobile iOS Mediation Adapter

เวอร์ชันถัดไป

• เปิดใช้ -fobjc-arc และ -fstack-protector-all

เวอร์ชัน 2.3.4.2

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

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

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

เวอร์ชัน 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
• เพิ่มการรองรับเพื่อแสดงเวอร์ชัน 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เมธอด delegate ที่เลิกใช้งานแล้วออกจากการติดตั้งใช้งานโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า และโฆษณาเนทีฟ
• ตอนนี้ต้องใช้ 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

• ยืนยันความเข้ากันได้กับ 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 เดียวกันแล้ว
• ตอนนี้อแดปเตอร์จะส่งต่อ -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

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

• 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