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

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

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

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

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

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

ข้อกำหนด

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

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

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

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

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

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

ไปที่แท็บ 広告ポット管理 (Ad Spot Management) แล้วคลิกปุ่ม ของคุณถูกจัด จำพวกนี้ได้ 広告ポット (New Ad Spot)

create_ad_spot

ขั้นตอนถัดไป ให้กรอกข้อมูลในแบบฟอร์มโดยระบุ 広告すポットホ (ชื่อ Ad Spot name), 広告ที่แสดงอยู่ในポットサイズ (ขนาดสปอตโฆษณา) และรายละเอียดอื่นๆ จากนั้นคลิกปุ่ม 䦏登録 (ลงชื่อสมัครใช้)

new_ad_spot_form

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

ad_spot_list

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

ขั้นตอนที่ 2: ตั้งค่าความต้องการสำหรับอุปกรณ์เคลื่อนที่ใน Ad Manager UI

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

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

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

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

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

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

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

เปิดการรวบรวมข้อมูลอัตโนมัติ แล้วป้อนLogin name and API Password

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

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

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

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

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

จากนั้นเพิ่มข้อมูลต่อไปนี้ในไฟล์ build.gradle.kts ระดับแอป ทรัพยากร Dependency และการกำหนดค่าของการติดตั้งใช้งาน ใช้เวอร์ชันล่าสุดของ SDK และอะแดปเตอร์ i-mobile:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.3.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 เลือกเวอร์ชันล่าสุด ดาวน์โหลด i-mobile .aar ของอะแดปเตอร์ แล้วเพิ่มลงในโปรเจ็กต์

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

ไม่ต้องมีรหัสเพิ่มเติมสำหรับการผสานรวม i-mobile

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

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

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

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

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

บันทึกการเปลี่ยนแปลงอะแดปเตอร์สื่อกลาง 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

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

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

  • Google Mobile Ads SDK เวอร์ชัน 20.5.0
  • IMobile SDK เวอร์ชัน 2.0.23

เวอร์ชัน 2.0.22.2

  • เพิ่มรหัสและข้อความแสดงข้อผิดพลาดของอะแดปเตอร์มาตรฐานแล้ว
  • อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 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 v2.0.21
  • อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 19.1.0
  • เพิ่มการรองรับการปรับขนาดโฆษณาแบนเนอร์แบบปรับขนาดได้

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

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

เวอร์ชัน 2.0.20.2

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

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