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

เลือกแพลตฟอร์ม: Android iOS Unity Flutter Android (เดิม)

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

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

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

อะแดปเตอร์สื่อกลางของ Ad Manager สำหรับ i-mobile มีความสามารถต่อไปนี้

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

ข้อกำหนดเบื้องต้น

ก่อนดำเนินการต่อ โปรดตรวจสอบสิ่งต่อไปนี้

  • เวอร์ชัน Google Mobile Ads Flutter Plugin ล่าสุด
  • เฟรมเวิร์ก Flutter เวอร์ชัน 3.7.0 ขึ้นไป
  • หากต้องการติดตั้งใช้งานใน Android
    • ระดับ API 24 ขึ้นไปของ Android
  • หากต้องการติดตั้งใช้งานใน iOS
    • เป้าหมายการติดตั้งใช้งาน iOS 13.0 ขึ้นไป
  • โปรเจ็กต์ Flutter ที่ใช้งานได้ซึ่งกำหนดค่าด้วย Google Mobile Ads Flutter Plugin ดูรายละเอียดได้ที่ ตั้งค่า Google Mobile Ads Flutter Plugin
  • ตั้งค่าสื่อกลาง

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

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

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

Android

iOS

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

Android

iOS

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

Android

iOS

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

create_ad_spot

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

new_ad_spot_form

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

ad_spot_list

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

Android

iOS

อัปเดต 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

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

Android

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

iOS

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

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

การผสานรวมผ่าน pub.dev

เพิ่มทรัพยากร Dependency ต่อไปนี้พร้อมกับ SDK และอะแดปเตอร์ i-mobile เวอร์ชันล่าสุดในไฟล์ pubspec.yaml ของแพ็กเกจ

dependencies:
  gma_mediation_imobile: ^1.0.6

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

ดาวน์โหลดปลั๊กอินสื่อกลาง Google Mobile Ads สำหรับ i-mobile เวอร์ชันล่าสุด แตกไฟล์ที่ดาวน์โหลดมา แล้วเพิ่มโฟลเดอร์ปลั๊กอินที่แตกออกมา (และเนื้อหาของโฟลเดอร์) ลงในโปรเจ็กต์ Flutter จากนั้นอ้างอิงปลั๊กอินในไฟล์ pubspec.yaml โดยเพิ่มทรัพยากร Dependency ต่อไปนี้

dependencies:
  gma_mediation_imobile:
    path: path/to/local/package

ขั้นตอนที่ 4: ต้องใช้โค้ดเพิ่มเติม

Android

ไม่จำเป็นต้องใช้โค้ดเพิ่มเติมสำหรับการผสานรวม i-mobile

iOS

การผสานรวม SKAdNetwork

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

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

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

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

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

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

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

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

Android

รูปแบบ ชื่อประเภท
แบนเนอร์ com.google.ads.mediation.imobile.IMobileAdapter
โฆษณาคั่นระหว่างหน้า com.google.ads.mediation.imobile.IMobileAdapter
เนทีฟ com.google.ads.mediation.imobile.IMobileMediationAdapter

iOS

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

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

Android

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

iOS

รหัสข้อผิดพลาด เหตุผล
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 ไม่รองรับการขอโฆษณาคั่นระหว่างหน้าหลายรายการโดยใช้รหัสสปอตเดียวกัน

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

เวอร์ชัน 1.0.6 (อยู่ระหว่างดำเนินการ)

เวอร์ชัน 1.0.5

เวอร์ชัน 1.0.4

เวอร์ชัน 1.0.3

เวอร์ชัน 1.0.2

เวอร์ชัน 1.0.1

เวอร์ชัน 1.0.0