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

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

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

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

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

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

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

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

• GMA Next-Gen SDK เวอร์ชันล่าสุด

• ตั้งค่าสื่อกลาง AdMob

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

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

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

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

หากต้องการสร้างสปอตโฆษณาใหม่ ให้เลือกแอปในแท็บ サイト／アプリ管理 (Site/Application Management)

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

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

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

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

อัปเดต app-ads.txt

ผู้ขายที่ได้รับอนุญาตสำหรับแอป app-ads.txt เป็นความคิดริเริ่มของ IAB Tech Lab ที่ช่วยตรวจสอบว่าคุณจะขายพื้นที่โฆษณาในแอปผ่านช่องทางที่คุณได้รับอนุญาตเท่านั้น คุณจะต้องใช้ไฟล์ app-ads.txt เพื่อป้องกันไม่ให้เสียรายได้จากโฆษณาเป็นจำนวนมาก หากยังไม่ได้ดำเนินการ ให้สร้างไฟล์ app-ads.txt สำหรับแอป

หากต้องการใช้ app-ads.txt สำหรับ i-mobile โปรดดูคำถามที่พบบ่อย

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

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

คุณต้องเพิ่ม i-mobile ลงในการกำหนดค่าสื่อกลางสำหรับหน่วยโฆษณา

ก่อนอื่น ให้ลงชื่อเข้าใช้บัญชี AdMob จากนั้นไปที่แท็บสื่อกลาง หากมีกลุ่มสื่อกลางอยู่แล้วและต้องการแก้ไข ให้คลิกชื่อกลุ่มสื่อกลางนั้นเพื่อแก้ไข แล้วข้ามไปที่หัวข้อเพิ่ม i-mobile เป็นแหล่งที่มาของโฆษณา

หากต้องการสร้างกลุ่มสื่อกลางใหม่ ให้เลือกสร้างกลุ่มสื่อกลาง

ป้อนรูปแบบโฆษณาและแพลตฟอร์ม แล้วคลิกต่อไป

ตั้งชื่อกลุ่มสื่อกลางและเลือกสถานที่ตั้งเป้าหมาย ถัดไป ให้ตั้งค่าสถานะกลุ่มสื่อกลางเป็นเปิดใช้ แล้วคลิกเพิ่มหน่วยโฆษณา

เชื่อมโยงกลุ่มสื่อกลางนี้กับหน่วยโฆษณา AdMob ที่มีอยู่อย่างน้อย 1 หน่วย จากนั้นคลิกเสร็จสิ้น

ตอนนี้คุณควรเห็นการ์ดหน่วยโฆษณาที่สร้างขึ้นพร้อมหน่วยโฆษณาที่คุณเลือก

เพิ่ม i-mobile เป็นแหล่งที่มาของโฆษณา

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

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

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

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

ในไฟล์ Gradle ระดับแอป ให้เพิ่มทรัพยากร Dependency และการกำหนดค่าการติดตั้งใช้งานต่อไปนี้

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0")
    implementation("com.google.ads.mediation:imobile:2.3.2.5")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0'
    implementation 'com.google.ads.mediation:imobile:2.3.2.5'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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

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

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

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

โหลดโฆษณาที่มีบริบทกิจกรรม

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

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

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

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

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

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

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

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

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

อะแดปเตอร์ i-mobile จะป้อนข้อมูลคำอธิบายช่องโฆษณาเนทีฟขั้นสูงต่อไปนี้สำหรับ NativeAd

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

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

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

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

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

เวอร์ชันถัดไป

• อัปเดตอะแดปเตอร์ให้ใช้ InitializationCompleteCallback.onInitializationFailed(AdError) API
• อัปเดตระดับ API ขั้นต่ำของ Android ที่จำเป็นเป็น 24
• แก้ไขปัญหาที่ระบบไม่ส่งต่อการเรียกกลับการโหลดและการแสดงโฆษณาคั่นระหว่างหน้าเนื่องจากมีการลงทะเบียน Listener ที่ว่างเปล่ากับ i-mobile SDK

เวอร์ชัน 2.3.2.5

• ปักหมุดทรัพยากร Dependency ของ Kotlin ของอะแดปเตอร์เป็น 1.9.0 (เวอร์ชัน Kotlin ขั้นต่ำที่ GMA NextGen SDK รองรับ)
• แก้ไขลักษณะการทำงานแบบ Fall-through ในสาขาที่ล้มเหลวเนื่องจากการจำกัดอายุผู้ชมระหว่างการเริ่มต้นโฆษณาและคำขอโหลดโฆษณา

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

• Google Mobile Ads SDK เวอร์ชัน 25.4.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.4.0
• IMobile SDK เวอร์ชัน 2.3.2

เวอร์ชัน 2.3.2.4

• กรองคำขอที่จำกัดอายุสำหรับ i-mobile SDK เมื่อตั้งค่า AgeRestrictedTreatment ใหม่เป็น CHILD

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

• Google Mobile Ads SDK เวอร์ชัน 25.4.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.2.0
• IMobile SDK เวอร์ชัน 2.3.2

เวอร์ชัน 2.3.2.3

• กรองคำขอที่มีการจำกัดอายุสำหรับ i-mobile SDK เนื่องจากไม่สามารถรับสัญญาณที่มีการจำกัดอายุได้

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

• Google Mobile Ads SDK เวอร์ชัน 25.1.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.1.0
• IMobile SDK เวอร์ชัน 2.3.2

เวอร์ชัน 2.3.2.2

• เพิ่มพร็อพเพอร์ตี้เพื่อสร้างอะแดปเตอร์ที่มีทรัพยากร Dependency ของ GMA Next-Gen SDK
• ย้ายข้อมูลการติดตั้งใช้งานโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า และโฆษณาเนทีฟจาก API เดิมไปยัง API ใหม่

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

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

เวอร์ชัน 2.3.2.1

• อัปเดตระดับ API ขั้นต่ำของ Android ที่จำเป็นเป็นระดับ 23
• อัปเดตเวอร์ชันขั้นต่ำของ Google Mobile Ads SDK ที่จำเป็นเป็น 24.0.0

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

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

เวอร์ชัน 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 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 เวอร์ชัน 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 v2.0.22
• อัปเดตอะแดปเตอร์เพื่อรองรับคำขอแบนเนอร์แบบปรับขนาดได้ในหน้า

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

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

เวอร์ชัน 2.0.21.0

• ยืนยันความเข้ากันได้กับ i-mobile SDK v2.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

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