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

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

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

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

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

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

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

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

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

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

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

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

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

ไปที่แท็บ 広告スポット管理 (Ad Spot Management) แล้วคลิกปุ่ม 新規広告スポット (New Ad Spot)

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

สปอตโฆษณาใหม่พร้อมใช้งานแล้ว หากต้องการดูรายละเอียดการผสานรวม ให้คลิกปุ่ม アプリ設定取得 (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

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

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

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

(Android เท่านั้น) เพิ่มที่เก็บต่อไปนี้ลงในไฟล์ build.gradle ภายในไดเรกทอรี android ของโปรเจ็กต์

  repositories {
      google()
      mavenCentral()
      maven {
          url = uri("https://imobile.github.io/adnw-sdk-android")
      }
  }

เพิ่มทรัพยากร Dependency ต่อไปนี้พร้อมกับ i-mobile SDK และอะแดปเตอร์เวอร์ชันล่าสุดในไฟล์ 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: ต้องใช้โค้ดเพิ่มเติม

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

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

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

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

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

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

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

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

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

เวอร์ชัน 1.0.6

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

เวอร์ชัน 1.0.5

• อัปเดตเพื่อรองรับปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 9.1.0
• เพิ่มการรองรับ Swift Package Manager
• รองรับอะแดปเตอร์ i-mobile Android เวอร์ชัน 2.3.2.4
• รองรับอะแดปเตอร์ i-mobile iOS เวอร์ชัน 2.3.4.8
• สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 9.1.0

เวอร์ชัน 1.0.4

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

เวอร์ชัน 1.0.3

• อัปเดตเวอร์ชัน Flutter ขั้นต่ำเป็น 3.38.1
• อัปเดตเพื่อรองรับปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 8.0.0
• รองรับอะแดปเตอร์ i-mobile Android เวอร์ชัน 2.3.2.3
• รองรับอะแดปเตอร์ i-mobile iOS เวอร์ชัน 2.3.4.6
• สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 8.0.0

เวอร์ชัน 1.0.2

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

เวอร์ชัน 1.0.1

• รองรับ i-mobile Android Adapter เวอร์ชัน 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