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

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

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

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

อะแดปเตอร์สื่อกลางสําหรับ i-mobile มีคุณสมบัติดังต่อไปนี้

ข้อกำหนด

• API ของ Android ระดับ 21 ขึ้นไป

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

• สื่อกลางเสร็จสมบูรณ์ คู่มือเริ่มต้นใช้งาน

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

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

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

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

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

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

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

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

จดบันทึก パットテテーID (Publisher ID), จัดทำデテアID (Media ID) และ IDポットID (Spot ID) คุณต้องใช้พารามิเตอร์เหล่านี้ในภายหลังเมื่อกําหนดค่า i-mobile สําหรับสื่อกลางใน UI ของ AdMob

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

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

การผสานรวมกับ Android Studio (แนะนำ)

ในไฟล์ settings.gradle.kts ระดับโปรเจ็กต์ ให้เพิ่มที่เก็บต่อไปนี้

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

จากนั้นเพิ่มข้อกําหนดในการนําไปใช้และการกําหนดค่าต่อไปนี้ในไฟล์ build.gradle.kts ระดับแอป ใช้ SDK และอะแดปเตอร์ i-mobile เวอร์ชันล่าสุด

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.google.ads.mediation:imobile:2.3.2.0")
}

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

1. ดาวน์โหลด i-mobile SDK เวอร์ชันล่าสุดและแตกไฟล์ android-ad-sdk.aar ในโฟลเดอร์ sdk แล้วเพิ่มลงในโปรเจ็กต์

2. ไปที่อาร์ติแฟกต์อะแดปเตอร์ i-mobile ที่เก็บ Maven ของ Google เลือกเวอร์ชันล่าสุด ดาวน์โหลดไฟล์ .aar ของอะแดปเตอร์ i-mobile แล้วเพิ่มลงในโปรเจ็กต์

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

เวอร์ชัน 2.3.2.0

• ยืนยันความเข้ากันได้กับ i-mobile SDK v2.3.2

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

• Google Mobile Ads SDK เวอร์ชัน 23.1.0
• IMobile SDK เวอร์ชัน 2.3.2

เวอร์ชัน 2.3.1.2

• อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 23.0.0
• ยืนยันความเข้ากันได้กับ i-mobile SDK v2.3.1

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

• Google Mobile Ads SDK เวอร์ชัน 23.0.0
• IMobile SDK เวอร์ชัน 2.3.1

เวอร์ชัน 2.3.1.1

• อัปเดตอะแดปเตอร์เพื่อใช้คลาส VersionInfo ใหม่
• อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 22.0.0

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

• Google Mobile Ads SDK เวอร์ชัน 22.0.0
• IMobile SDK เวอร์ชัน 2.3.1

เวอร์ชัน 2.3.1.0

• ยืนยันความเข้ากันได้กับ i-mobile SDK v2.3.1
• อัปเดตเวอร์ชันขั้นต่ำของ Google Mobile Ads SDK เป็น 21.5.0

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

• Google Mobile Ads SDK เวอร์ชัน 21.5.0
• IMobile SDK เวอร์ชัน 2.3.1

เวอร์ชัน 2.3.0.0

• ยืนยันความเข้ากันได้กับ i-mobile SDK v2.3.0
• อัปเดตเวอร์ชันขั้นต่ำของ Google Mobile Ads SDK เป็น 21.3.0

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

• Google Mobile Ads SDK เวอร์ชัน 21.3.0
• IMobile SDK เวอร์ชัน 2.3.0

เวอร์ชัน 2.0.23.1

• อัปเดต compileSdkVersion และ targetSdkVersion เป็น API 31 แล้ว
• อัปเดตเวอร์ชันขั้นต่ำของ Google Mobile Ads SDK เป็น 21.0.0
• อัปเดตระดับ API ขั้นต่ำของ Android เป็น 19

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

• Google Mobile Ads SDK เวอร์ชัน 21.0.0
• IMobile SDK เวอร์ชัน 2.0.23

เวอร์ชัน 2.0.23.0

• ยืนยันความเข้ากันได้กับ i-mobile SDK v2.0.23
• อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 20.5.0

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

• Google Mobile Ads SDK เวอร์ชัน 20.5.0
• IMobile SDK เวอร์ชัน 2.0.23

เวอร์ชัน 2.0.22.2

• เพิ่มรหัสและข้อความแสดงข้อผิดพลาดมาตรฐานสำหรับอะแดปเตอร์
• อัปเดตเวอร์ชันขั้นต่ำของ Google Mobile Ads SDK เป็น 20.1.0

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

• Google Mobile Ads SDK เวอร์ชัน 20.1.0
• IMobile SDK เวอร์ชัน 2.0.22

เวอร์ชัน 2.0.22.1

• อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 20.0.0

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

• Google Mobile Ads SDK เวอร์ชัน 20.0.0
• IMobile SDK เวอร์ชัน 2.0.22

เวอร์ชัน 2.0.22.0

• ยืนยันความเข้ากันได้กับ i-mobile SDK เวอร์ชัน 2.0.22
• อัปเดตอะแดปเตอร์ให้รองรับคําขอแบนเนอร์แบบปรับขนาดได้แบบแทรกในบรรทัด

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

• Google Mobile Ads SDK เวอร์ชัน 19.1.0
• IMobile SDK เวอร์ชัน 2.0.22

เวอร์ชัน 2.0.21.0

• ยืนยันความเข้ากันได้กับ i-mobile SDK เวอร์ชัน 2.0.21
• อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 19.1.0
• เพิ่มการรองรับการปรับขนาดโฆษณาแบนเนอร์แบบปรับขนาดได้

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

• Google Mobile Ads SDK เวอร์ชัน 19.1.0
• IMobile SDK เวอร์ชัน 2.0.21

เวอร์ชัน 2.0.20.2

• เพิ่มการรองรับขนาดโฆษณาแบนเนอร์ที่ยืดหยุ่น
• อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 18.3.0

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

• Google Mobile Ads SDK เวอร์ชัน 18.3.0
• IMobile SDK เวอร์ชัน 2.0.20

เวอร์ชัน 2.0.20.1

• ตอนนี้อะแดปเตอร์จะแสดงผลสัดส่วนภาพ mediaContent ที่ไม่ใช่ 0

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

• Google Mobile Ads SDK เวอร์ชัน 18.2.0
• IMobile SDK เวอร์ชัน 2.0.20

เวอร์ชัน 2.0.20.0

• การเผยแพร่ครั้งแรก
• เพิ่มการรองรับโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า และโฆษณาเนทีฟ