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

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

คู่มือนี้จะแสดงวิธีใช้ 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
  • Android API ระดับ 23 ขึ้นไป
• หากต้องการทำให้ใช้งานได้ใน iOS
  • เป้าหมายการทำให้ใช้งานได้ของ iOS คือ 13.0 ขึ้นไป
• โปรเจ็กต์ Flutter ที่ใช้งานได้ซึ่งกำหนดค่าด้วย Google Mobile Ads Flutter Plugin ดูรายละเอียดได้ที่ ตั้งค่า Google Mobile Ads Flutter Plugin
• ตั้งค่าสื่อกลาง

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

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

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

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

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

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

จากนั้นกรอกข้อมูลในแบบฟอร์มโดยระบุชื่อพื้นที่โฆษณา ขนาดพื้นที่โฆษณา และรายละเอียดอื่นๆ แล้วคลิกปุ่ม 新規登録 (ลงชื่อสมัครใช้)

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

จดบันทึกรหัสผู้เผยแพร่โฆษณา (パブリッシャー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

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

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

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

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

dependencies:
  gma_mediation_imobile: ^1.0.2

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• อัปเดต Flutter เวอร์ชันขั้นต่ำเป็น 3.35.1
• อัปเดตให้รองรับปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 7.0.0

เวอร์ชัน 1.0.2

• รองรับอะแดปเตอร์ i-mobile สำหรับ Android เวอร์ชัน 2.3.2.1
• รองรับอะแดปเตอร์ i-mobile สำหรับ iOS เวอร์ชัน 2.3.4.3
• สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 6.0.0

เวอร์ชัน 1.0.1

• รองรับอะแดปเตอร์ i-mobile สำหรับ Android เวอร์ชัน 2.3.2.1
• รองรับอะแดปเตอร์ i-mobile สำหรับ iOS เวอร์ชัน 2.3.4.2
• สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 6.0.0

เวอร์ชัน 1.0.0

• รุ่นแรก
• รองรับอะแดปเตอร์ i-mobile สำหรับ Android เวอร์ชัน 2.3.2.0
• รองรับอะแดปเตอร์ i-mobile สำหรับ iOS เวอร์ชัน 2.3.4.1
• สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 5.3.1