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

คู่มือนี้แสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดงโฆษณาจาก i-mobile โดยใช้ สื่อกลาง 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 ใน AdMob UI

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

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

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

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

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

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

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

ตอนนี้คุณควรจะเห็นการ์ดหน่วยโฆษณาเต็มไปด้วยหน่วยโฆษณาที่คุณเลือกไว้ ดังนี้

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

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

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

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

แล้วป้อน Publisher ID, Media ID and Spot ID ที่ได้รับในส่วนก่อนหน้า จากนั้นคลิกเสร็จสิ้น

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

ในไฟล์ 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 เสมอ
บรรทัดแรก
รูปภาพ
เนื้อความ
ไอคอนแอป 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 ที่กําหนดค่าใน AdMob UI ขาดหายไป/ไม่ถูกต้อง
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 แล้ว
  • อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 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

  • อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 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 เวอร์ชัน 2.0.21
  • อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 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

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