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

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

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

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

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

ข้อกำหนด

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ขั้นตอนที่ 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 ระดับแอป ใช้ i-mobile SDK และอะแดปเตอร์เวอร์ชันล่าสุด

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

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

ตรวจสอบว่าคุณได้ลงทะเบียนอุปกรณ์ทดสอบสําหรับ Ad Manager แล้ว 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

• อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 23.0.0
• ยืนยันความเข้ากันได้กับ i-mobile SDK เวอร์ชัน 2.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 เวอร์ชัน 2.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 เวอร์ชัน 2.0.23
• อัปเดตเวอร์ชันขั้นต่ำของ Google Mobile Ads SDK เป็น 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

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