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

เลือกแพลตฟอร์ม: Android iOS Unity Flutter Android (เดิม)

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

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

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

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

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

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

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

  • เป้าหมายการติดตั้งใช้งาน iOS เวอร์ชัน 13.0 ขึ้นไป

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

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

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

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

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

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

create_ad_spot

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

new_ad_spot_form

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

ad_spot_list

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

อัปเดต app-ads.txt

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

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

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

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

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

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

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

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

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

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

เปิดการเก็บรวบรวมข้อมูลอัตโนมัติ แล้วป้อนชื่อเข้าสู่ระบบและรหัสผ่าน API

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

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

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

ใช้ Swift Package Manager

ก่อนดำเนินการต่อ คุณต้องมีอะแดปเตอร์เวอร์ชันขั้นต่ำที่รองรับคือ 2.3.4.2

หากต้องการเพิ่มทรัพยากร Dependency ของแพ็กเกจลงในโปรเจ็กต์ ให้ทำตามขั้นตอนต่อไปนี้

  1. ใน Xcode ให้ไปที่ไฟล์ > เพิ่มทรัพยากร Dependency ของแพ็กเกจ...

  2. ในข้อความแจ้งที่ปรากฏขึ้น ให้ค้นหา URL ของแพ็กเกจต่อไปนี้

    https://github.com/googleads/googleads-mobile-ios-mediation-imobile.git

  3. ในกฎการขึ้นต่อกัน ให้เลือกสาขา

  4. ป้อน main ในช่องข้อความ

ใช้ CocoaPods

  • เพิ่มบรรทัดต่อไปนี้ลงใน Podfile ของโปรเจ็กต์

    pod 'GoogleMobileAdsMediationIMobile'

  • เรียกใช้คำสั่งต่อไปนี้จากบรรทัดคำสั่ง

    pod install --repo-update

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

  • ดาวน์โหลด i-mobile SDK เวอร์ชันล่าสุดและลิงก์ ImobileSdkAds.framework ในโปรเจ็กต์
  • ดาวน์โหลดอะแดปเตอร์ i-mobile เวอร์ชันล่าสุดจากลิงก์ดาวน์โหลดในบันทึกการเปลี่ยนแปลง และลิงก์ IMobileAdapter.framework ในโปรเจ็กต์

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

ติดตั้งใช้งาน SKAdNetwork

ทำตามเอกสารประกอบของ i-mobile เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist ของโปรเจ็กต์

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

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

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

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

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

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

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

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

อะแดปเตอร์ i-mobile จะป้อนข้อมูลในช่องต่อไปนี้สำหรับ GADNativeAd

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

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

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

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

รูปแบบ ชื่อประเภท
แบนเนอร์ IMobileAdapter
โฆษณาคั่นระหว่างหน้า IMobileAdapter
เนทีฟ GADMediationAdapterIMobile

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

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

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

เวอร์ชัน 2.3.4.8

  • อัปเดตเวอร์ชัน iOS ขั้นต่ำเพื่อลดการพึ่งพา Google Mobile Ads SDK เพื่ออนุญาตเวอร์ชันย่อย

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

  • Google Mobile Ads SDK เวอร์ชัน 13.7.0
  • i-mobile SDK เวอร์ชัน 2.3.4

เวอร์ชัน 2.3.4.7

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

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

  • Google Mobile Ads SDK เวอร์ชัน 13.4.0
  • i-mobile SDK เวอร์ชัน 2.3.4

เวอร์ชัน 2.3.4.6

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

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

  • Google Mobile Ads SDK เวอร์ชัน 13.2.0
  • i-mobile SDK เวอร์ชัน 2.3.4

เวอร์ชัน 2.3.4.5

  • อัปเดตทรัพยากร Dependency ของ Google Mobile Ads SDK เป็นเวอร์ชัน 13.0.0

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

  • Google Mobile Ads SDK เวอร์ชัน 13.0.0
  • i-mobile SDK เวอร์ชัน 2.3.4

เวอร์ชัน 2.3.4.4

  • อัปเดตเวอร์ชัน iOS ขั้นต่ำของ CocoaPods เป็น 13.0

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

  • Google Mobile Ads SDK เวอร์ชัน 13.0.0
  • i-mobile SDK เวอร์ชัน 2.3.4

เวอร์ชัน 2.3.4.3

  • แก้ไขชื่อเฟรมเวิร์กและส่วนหัว Umbrella ใน modulemap ของ IMobileAdapter

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

  • Google Mobile Ads SDK เวอร์ชัน 12.12.0
  • i-mobile SDK เวอร์ชัน 2.3.4

เวอร์ชัน 2.3.4.2

  • ตอนนี้ต้องใช้ Google Mobile Ads SDK เวอร์ชัน 12.0.0 ขึ้นไป

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

  • Google Mobile Ads SDK เวอร์ชัน 12.0.0
  • i-mobile SDK เวอร์ชัน 2.3.4

เวอร์ชัน 2.3.4.1

  • อัปเดต CFBundleShortVersionString ให้มี 3 องค์ประกอบแทน 4 องค์ประกอบ

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

  • Google Mobile Ads SDK เวอร์ชัน 11.10.0
  • i-mobile SDK เวอร์ชัน 2.3.4

เวอร์ชัน 2.3.4.0

  • ยืนยันความเข้ากันได้กับ i-mobile SDK 2.3.4 แล้ว
  • เพิ่มการรองรับเพื่อแสดงเวอร์ชัน i-mobile SDK ใน adSDKVersion

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

  • Google Mobile Ads SDK เวอร์ชัน 11.2.0
  • i-mobile SDK เวอร์ชัน 2.3.4

เวอร์ชัน 2.3.3.0

  • ยืนยันความเข้ากันได้กับ i-mobile SDK 2.3.3 แล้ว

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

  • Google Mobile Ads SDK เวอร์ชัน 11.1.0
  • i-mobile SDK เวอร์ชัน 2.3.3

เวอร์ชัน 2.3.2.1

  • นำเมธอดผู้รับมอบสิทธิ์ willBackgroundApplication ที่เลิกใช้งานแล้วออกจากการใช้งานแบนเนอร์ โฆษณาคั่นระหว่างหน้า และโฆษณาเนทีฟ
  • ตอนนี้ต้องใช้ iOS เวอร์ชัน 12.0 ขึ้นไป
  • ตอนนี้ต้องใช้ Google Mobile Ads SDK เวอร์ชัน 11.0 ขึ้นไป
  • รวม Info.plist ไว้ในเฟรมเวิร์กภายใน IMobileAdapter.xcframework

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

  • Google Mobile Ads SDK เวอร์ชัน 11.0.1
  • i-mobile SDK เวอร์ชัน 2.3.2

เวอร์ชัน 2.3.2.0

  • ยืนยันความเข้ากันได้กับ i-mobile SDK 2.3.2 แล้ว
  • นำการรองรับสถาปัตยกรรม armv7 ออกแล้ว
  • ตอนนี้ต้องใช้ iOS เวอร์ชัน 11.0 ขึ้นไป
  • ตอนนี้ต้องใช้ Google Mobile Ads SDK เวอร์ชัน 10.4.0 ขึ้นไป

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

  • Google Mobile Ads SDK เวอร์ชัน 10.4.0
  • i-mobile SDK เวอร์ชัน 2.3.2

เวอร์ชัน 2.3.1.0

  • ยืนยันความเข้ากันได้กับ i-mobile SDK 2.3.1 แล้ว

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

  • Google Mobile Ads SDK เวอร์ชัน 10.3.0
  • i-mobile SDK เวอร์ชัน 2.3.1

เวอร์ชัน 2.3.0.1

  • ตอนนี้ต้องใช้ Google Mobile Ads SDK เวอร์ชัน 10.0.0 ขึ้นไป

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

  • Google Mobile Ads SDK เวอร์ชัน 10.0.0
  • i-mobile SDK เวอร์ชัน 2.3.0

เวอร์ชัน 2.3.0.0

  • ยืนยันความเข้ากันได้กับ i-mobile SDK 2.3.0
  • ตอนนี้ต้องใช้ Google Mobile Ads SDK เวอร์ชัน 9.8.0 ขึ้นไป

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

  • Google Mobile Ads SDK เวอร์ชัน 9.13.0
  • i-mobile SDK เวอร์ชัน 2.3.0

เวอร์ชัน 2.2.0.1

  • ตอนนี้ต้องใช้ Google Mobile Ads SDK เวอร์ชัน 9.0.0 ขึ้นไป

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

  • Google Mobile Ads SDK เวอร์ชัน 9.0.0
  • i-mobile SDK เวอร์ชัน 2.2.0

เวอร์ชัน 2.2.0.0

  • ยืนยันความเข้ากันได้กับ i-mobile SDK เวอร์ชัน 2.2.0 แล้ว

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

  • Google Mobile Ads SDK เวอร์ชัน 8.13.0
  • i-mobile SDK เวอร์ชัน 2.2.0

เวอร์ชัน 2.1.0.1

  • ลดการพึ่งพา Google Mobile Ads SDK เวอร์ชัน 8.0.0 ขึ้นไป

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

  • Google Mobile Ads SDK เวอร์ชัน 8.4.0
  • i-mobile SDK เวอร์ชัน 2.1.0

เวอร์ชัน 2.1.0.0

  • ยืนยันความเข้ากันได้กับ i-mobile SDK เวอร์ชัน 2.1.0
  • ตอนนี้ต้องใช้ Google Mobile Ads SDK เวอร์ชัน 8.1.0 ขึ้นไป
  • อัปเดตอะแดปเตอร์ให้ใช้รูปแบบ .xcframework

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

  • Google Mobile Ads SDK เวอร์ชัน 8.1.0
  • i-mobile SDK เวอร์ชัน 2.1.0

เวอร์ชัน 2.0.33.1

  • เพิ่มรหัสข้อผิดพลาดและข้อความของอะแดปเตอร์ที่ได้มาตรฐาน
  • ตอนนี้อะแดปเตอร์จะจำกัดการขอโฆษณาคั่นระหว่างหน้าหลายรายการโดยใช้รหัส i-mobile Spot เดียวกัน
  • ตอนนี้อะแดปเตอร์จะส่งต่อ Callback -nativeAdWillLeaveApplication: เมื่อมีการแตะโฆษณาเนทีฟ
  • ตอนนี้ต้องใช้ Google Mobile Ads SDK เวอร์ชัน 7.68.0 ขึ้นไป

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

  • Google Mobile Ads SDK เวอร์ชัน 7.68.0
  • i-mobile SDK เวอร์ชัน 2.0.33

เวอร์ชัน 2.0.33.0

  • ยืนยันความเข้ากันได้กับ i-mobile SDK เวอร์ชัน 2.0.33 แล้ว
  • ตอนนี้ต้องใช้ Google Mobile Ads SDK เวอร์ชัน 7.65.0 ขึ้นไป
  • ตอนนี้ต้องใช้ iOS เวอร์ชัน 9.0 ขึ้นไป

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

  • Google Mobile Ads SDK เวอร์ชัน 7.65.0
  • i-mobile SDK เวอร์ชัน 2.0.33

เวอร์ชัน 2.0.32.0

  • ยืนยันความเข้ากันได้กับ i-mobile SDK เวอร์ชัน 2.0.32 แล้ว
  • ตอนนี้ต้องใช้ Google Mobile Ads SDK เวอร์ชัน 7.60.0 ขึ้นไป
  • เพิ่มการรองรับการปรับขนาดโฆษณา 320x50 และ 320x100 เพื่อให้เหมาะกับขนาดคำขอแบนเนอร์แบบปรับขนาดได้มากขึ้น
  • นำการรองรับสถาปัตยกรรม i386 ออก

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

  • Google Mobile Ads SDK เวอร์ชัน 7.60.0
  • i-mobile SDK เวอร์ชัน 2.0.32

เวอร์ชัน 2.0.31.0

  • ยืนยันความเข้ากันได้กับ i-mobile SDK เวอร์ชัน 2.0.31 แล้ว

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

  • Google Mobile Ads SDK เวอร์ชัน 7.53.1
  • i-mobile SDK เวอร์ชัน 2.0.31

เวอร์ชัน 2.0.29.0

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

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

  • Google Mobile Ads SDK เวอร์ชัน 7.52.0
  • i-mobile SDK เวอร์ชัน 2.0.29