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

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

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

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

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

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

ข้อกำหนด

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

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

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

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

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

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

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

create_ad_spot

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

new_ad_spot_form

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

ad_spot_list

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

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

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

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

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

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

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

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

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

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

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


เลือกเพิ่มแหล่งที่มาของโฆษณาในการ์ด Waterfall ในส่วนแหล่งที่มาของโฆษณา จากนั้นเลือก i-mobile

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



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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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