หน้านี้ได้รับการแปลโดย Cloud Translation API

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

คู่มือนี้จะแสดงวิธีใช้ Google Mobile Ads SDK เพื่อโหลดและแสดงโฆษณาจาก i-mobile โดยใช้ mediation ซึ่งครอบคลุมการผสานรวม Waterfall ซึ่งจะอธิบายวิธีเพิ่ม 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 โดยคลิกแท็บサイト／アプリ管理 (การจัดการเว็บไซต์/แอปพลิเคชัน) และปุ่มสำหรับแพลตฟอร์มของแอป

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

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

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

create_ad_spot

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

new_ad_spot_form

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

ad_spot_list

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

รหัสข้อผิดพลาด	เหตุผล
0-10	i-mobile SDK แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมที่ code
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

เวอร์ชัน 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