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

เลือกแพลตฟอร์ม: Android (เบต้า) Android iOS Unity Flutter

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

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

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

Ad Mediation สำหรับ i-mobile มีความสามารถต่อไปนี้

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

ข้อกำหนด

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

• ล่าสุดจาก GMA Next-Gen SDK

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

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

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

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

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

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

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

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

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

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

ในการ์ดสื่อกลางตามลำดับขั้นในส่วนแหล่งที่มาของโฆษณา ให้เลือกเพิ่มแหล่งที่มาของโฆษณา

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

หมายเหตุ: คุณต้องตั้งค่าการเพิ่มประสิทธิภาพแหล่งที่มาของโฆษณาเพียงครั้งเดียวต่อเครือข่าย

หากมีการแมปสำหรับ i-mobile อยู่แล้ว คุณก็เลือกการแมปนั้นได้ หากไม่ ให้คลิกเพิ่มการแมป

จากนั้นป้อน รหัสผู้เผยแพร่โฆษณา รหัสสื่อ และรหัสสปอต ที่ได้รับในส่วนก่อนหน้า จากนั้นคลิกเสร็จสิ้น

หมายเหตุ: การเพิ่มประสิทธิภาพแหล่งที่มาของโฆษณาต้องใช้เวลา 2-3 วันในการรวบรวมข้อมูลให้เพียงพอเพื่อคำนวณ eCPM สำหรับเครือข่ายสื่อกลางได้อย่างแม่นยำ ในระหว่างนี้ สถานะการเพิ่มประสิทธิภาพแหล่งที่มาของโฆษณาคือ PENDING ดังนั้นคุณต้องตั้งค่า eCPM ของเครือข่ายด้วยตนเอง เมื่อคำนวณ eCPM ได้แล้ว แหล่งที่มาของโฆษณาจะเริ่มอัปเดต eCPM ในนามของคุณโดยอัตโนมัติ

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

หมายเหตุ: การไม่ผสานรวม i-mobile และGMA Next-Gen SDK เวอร์ชันที่เข้ากันได้อาจทำให้เกิดปัญหาในการสร้าง

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

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

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

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

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:imobile:2.3.2.1")
}

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:0.24.0-beta02'
    implementation 'com.google.ads.mediation:imobile:2.3.2.1'
}

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 มีรหัสสปอต, รหัสสื่อ และรหัสผู้เผยแพร่โฆษณาสำหรับทดสอบ คุณสามารถดูรหัสเหล่านี้ได้ที่นี่

สำคัญ: ปิดใช้โหมดทดสอบสำหรับ AdMob และ i-mobile ก่อนที่จะเปิดตัวแอป

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

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

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

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

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

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

ช่อง	i-mobile adapter จะรวมชิ้นงานเสมอ
บรรทัดแรก
รูปภาพ
เนื้อความ
ไอคอนแอป	^1
คำกระตุ้นการตัดสินใจ
การให้ดาว
ร้านค้า
ราคา

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

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

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

รูปแบบ	ชื่อชั้นเรียน
แบนเนอร์	com.google.ads.mediation.imobile.IMobileAdapter
โฆษณาคั่นระหว่างหน้า	com.google.ads.mediation.imobile.IMobileAdapter
เนทีฟ	com.google.ads.mediation.imobile.IMobileMediationAdapter

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

รหัสข้อผิดพลาด	เหตุผล
0-99	SDK ของ i-mobile แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ที่โค้ด
101	i-mobile ต้องมีบริบท Activity เพื่อโหลดโฆษณา
102	พารามิเตอร์เซิร์ฟเวอร์ i-mobile ที่กำหนดค่าไว้ใน UI ของ AdMob ขาดหายไป/ไม่ถูกต้อง
103	ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ i-mobile รองรับ
104	Callback การโหลดโฆษณาเนทีฟสําเร็จของ i-mobile แสดงรายการโฆษณาเนทีฟที่ว่างเปล่า