Google ใช้เทคโนโลยี AI เพื่อแปลเนื้อหาเป็นภาษาที่คุณต้องการ การแปลโดย AI อาจมีข้อผิดพลาด

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

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

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

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

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

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

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

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

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

Google Mobile Ads Unity Plugin เวอร์ชันล่าสุด
Unity Editor เวอร์ชัน 5.6 ขึ้นไป
วิธีติดตั้งใช้งานใน Android
- Android API ระดับ 24 ขึ้นไป
วิธีติดตั้งใช้งานใน iOS
- เป้าหมายการติดตั้งใช้งาน iOS เวอร์ชัน 13.0 ขึ้นไป
โปรเจ็กต์ Unity ที่ใช้งานได้ซึ่งกำหนดค่าด้วย Google Mobile Ads Unity Plugin ดูรายละเอียดได้ที่ ตั้งค่า Google Mobile Ads Unity Plugin

ตั้งค่าสื่อกลาง

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

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

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

Android

iOS

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

Android

iOS

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

Android

iOS

ไปที่แท็บ 広告スポット管理 (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

Android

iOS

อัปเดต 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

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

Android

ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสำหรับ Android

iOS

ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสำหรับ iOS

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

OpenUPM-CLI

หากติดตั้ง OpenUPM-CLI ไว้ คุณสามารถติดตั้งปลั๊กอินสื่อกลาง i-mobile ของโฆษณาในอุปกรณ์เคลื่อนที่ของ Google สำหรับ Unity ลงในโปรเจ็กต์ได้โดยเรียกใช้คำสั่งต่อไปนี้จากไดเรกทอรีรากของโปรเจ็กต์

openupm add com.google.ads.mobile.mediation.imobile

OpenUPM

ในเครื่องมือแก้ไขโปรเจ็กต์ Unity ให้เลือกแก้ไข > การตั้งค่าโปรเจ็กต์ > เครื่องมือจัดการแพ็กเกจเพื่อเปิดการตั้งค่าเครื่องมือจัดการแพ็กเกจ Unity

ในแท็บ Scoped Registries ให้เพิ่ม OpenUPM เป็น Scoped Registry โดยระบุรายละเอียดต่อไปนี้

ชื่อ: OpenUPM
URL: https://package.openupm.com
ขอบเขต: com.google

รายละเอียด OpenUPM

จากนั้นไปที่หน้าต่าง > Package Manager เพื่อเปิด Unity Package Manager และ เลือกรีจิสทรีของฉันจากเมนูแบบเลื่อนลง

Unity Registry

เลือกแพ็กเกจ Google Mobile Ads IMobile Mediation แล้วคลิกติดตั้ง

ติดตั้งจาก OpenUPM

แพ็กเกจ Unity

ดาวน์โหลดปลั๊กอินสื่อกลาง Google Mobile Ads สำหรับ i-mobile เวอร์ชันล่าสุดจากลิงก์ดาวน์โหลดในบันทึกการเปลี่ยนแปลง แล้วแตกไฟล์ GoogleMobileAdsIMobileMediation.unitypackage จากไฟล์ ZIP

ในเครื่องมือแก้ไขโปรเจ็กต์ Unity ให้เลือกชิ้นงาน > นำเข้าแพ็กเกจ > แพ็กเกจที่กำหนดเอง แล้วค้นหาไฟล์ GoogleMobileAdsIMobileMediation.unitypackage ที่ดาวน์โหลดไว้ ตรวจสอบว่าได้เลือกไฟล์ทั้งหมดแล้ว แล้วคลิกนำเข้า

นำเข้าจาก Unity

จากนั้นเลือก Assets > External Dependency Manager > Android Resolver > Force Resolve ไลบรารี External Dependency Manager จะทำการแก้ไขทรัพยากร Dependency ตั้งแต่ต้นและคัดลอกทรัพยากร Dependency ที่ประกาศไว้ไปยังไดเรกทอรี Assets/Plugins/Android ของแอป Unity

บังคับแก้ไข

ขั้นตอนที่ 4: ต้องใช้โค้ดเพิ่มเติม

Android

ไม่จำเป็นต้องใช้โค้ดเพิ่มเติมสำหรับการผสานรวม i-mobile

iOS

การผสานรวม SKAdNetwork

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

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

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

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

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

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

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

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

Android

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

iOS

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

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

Android

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

iOS

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