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

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

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

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

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

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

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

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

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

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

เวอร์ชัน Google Mobile Ads Unity Plugin ล่าสุด
Unity Editor เวอร์ชัน 5.6 ขึ้นไป
หากต้องการติดตั้งใช้งานใน Android
- ระดับ API 24 ขึ้นไปของ Android
หากต้องการติดตั้งใช้งานใน 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

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

create_ad_spot

จากนั้นกรอกข้อมูลในแบบฟอร์มโดยระบุ広告スポット名 (ชื่อ Ad Spot) 広告スポットサイズ (ขนาด 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 ไว้ คุณจะติดตั้งปลั๊กอินสื่อกลาง Google Mobile Ads i-mobile สำหรับ Unity ในโปรเจ็กต์ได้โดยเรียกใช้คำสั่งต่อไปนี้จาก ไดเรกทอรีรากของโปรเจ็กต์

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

OpenUPM

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

ในแท็บรีจิสทรีที่กำหนดขอบเขต ให้เพิ่ม OpenUPM เป็นรีจิสทรีที่กำหนดขอบเขตโดยใช้ รายละเอียดต่อไปนี้

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

รายละเอียด OpenUPM

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

Unity Registries

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

ติดตั้งจาก OpenUPM

แพ็กเกจ Unity

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

ในโปรเจ็กต์ Unity Editor ให้เลือก Assets > Import Package > Custom Package แล้วค้นหาไฟล์ 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	SDK ของ i-mobile แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ที่โค้ด
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 ไม่รองรับการขอโฆษณาคั่นระหว่างหน้าหลายรายการโดยใช้รหัสสปอตเดียวกัน