คู่มือนี้จะแสดงวิธีใช้ Google Mobile Ads SDK เพื่อโหลดและแสดงโฆษณาจาก Line โดยใช้สื่อกลาง ซึ่งครอบคลุมการผสานรวม Waterfall ซึ่งจะอธิบายวิธีเพิ่ม Line ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม SDK และอะแดปเตอร์ของ Line เข้ากับแอป Unity
การผสานรวมและรูปแบบโฆษณาที่รองรับ
Ad Manager Mediation Adapter สําหรับ Line มีคุณสมบัติดังต่อไปนี้
การผสานรวม | |
---|---|
การเสนอราคา | |
น้ำตก | 1 |
รูปแบบ | |
แบนเนอร์ | |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว |
1 การผสานรวม Waterfall อยู่ในรุ่นเบต้าแบบปิด โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อขอสิทธิ์เข้าถึง
ข้อกำหนด
- Unity 4 ขึ้นไป
- Google Mobile Ads SDK เวอร์ชันล่าสุด
- วิธีติดตั้งใช้งานใน Android
- Android API ระดับ 21 ขึ้นไป
- วิธีติดตั้งใช้งานใน iOS
- เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
- โปรเจ็กต์ Unity ที่ใช้งานได้ซึ่งกําหนดค่าด้วย Google Mobile Ads SDK ดูรายละเอียดได้ที่เริ่มต้นใช้งาน
- ทําตามคู่มือเริ่มต้นใช้งานของสื่อกลาง
ขั้นตอนที่ 1: ตั้งค่าการกําหนดค่าใน UI ของ Line
เข้าสู่ระบบบัญชี Line
เพิ่มแอปพลิเคชันใหม่
คลิก 広告枠管理 (การจัดการช่องโฆษณา) > メディア (สื่อ) จากนั้นคลิก新規作成 (สร้างใหม่)
กรอกแบบฟอร์มและคลิก登録 (ลงทะเบียน)
จดรหัสแอปพลิเคชันไว้
สร้างตําแหน่งโฆษณา
คลิกรหัสของแอปพลิเคชันที่ต้องการเพิ่มตําแหน่งโฆษณา จากนั้นเลือก詳細 (รายละเอียด)
คลิก スロット 追加 (เพิ่มช่อง)
กรอกแบบฟอร์ม เมื่อกรอกเสร็จแล้ว ให้คลิก (登録) ลงทะเบียน
จดรหัสช่องไว้
ขั้นตอนที่ 2: ตั้งค่าดีมานด์ในบรรทัดใน Ad Manager UI
กำหนดการตั้งค่าสื่อกลางสําหรับหน่วยโฆษณา
Android
โปรดดูวิธีการที่ขั้นตอนที่ 2 ในคู่มือสำหรับ Android
iOS
ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสำหรับ iOS
ขั้นตอนที่ 3: นําเข้า SDK และอะแดปเตอร์ของ Line
ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณา Google บนมือถือเวอร์ชันล่าสุดสําหรับ Line จากลิงก์ดาวน์โหลดในบันทึกการเปลี่ยนแปลง แล้วแตกไฟล์ GoogleMobileAdsLineMediation.unitypackage
จากไฟล์ ZIP
ในเครื่องมือแก้ไขโปรเจ็กต์ Unity ให้เลือกเนื้อหา > นําเข้าแพ็กเกจ > แพ็กเกจที่กําหนดเอง แล้วค้นหาGoogleMobileAdsLineMediation.unitypackage
ไฟล์ที่คุณดาวน์โหลด ตรวจสอบว่าได้เลือกไฟล์ทั้งหมดแล้ว แล้วคลิกนําเข้า
จากนั้นเลือกเนื้อหา > Play Services Resolver > Android Resolver >
บังคับแก้ไข ไลบรารี Resolver ของ Unity Play Services จะทำการแก้ไข Dependency ตั้งแต่ต้นและคัดลอก Dependency ที่ประกาศไว้ไปยังไดเรกทอรี Assets/Plugins/Android
ของแอป Unity
ขั้นตอนที่ 4: เพิ่มโค้ดที่จำเป็น
Android
ไม่ต้องใช้โค้ดเพิ่มเติมสำหรับการผสานรวมกับ Line
iOS
การผสานรวม SKAdNetwork
ทำตามเอกสารประกอบของ Line เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist
ของโปรเจ็กต์
ขั้นตอนที่ 5: ทดสอบการใช้งาน
เปิดใช้โฆษณาทดสอบ
ตรวจสอบว่าคุณได้ลงทะเบียนอุปกรณ์ทดสอบสำหรับ AdMob แล้ว
ทําตามวิธีการในเอกสารประกอบของ Android และ iOS ของ Line เกี่ยวกับวิธีเปิดใช้โฆษณาทดสอบของ Line
ยืนยันโฆษณาทดสอบ
หากต้องการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก Line ให้เปิดใช้การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียวในเครื่องมือตรวจสอบโฆษณาโดยใช้แหล่งที่มาของโฆษณา Line (Waterfall)
ขั้นตอนที่ไม่บังคับ
พารามิเตอร์เฉพาะเครือข่าย
ปลั๊กอินสื่อกลาง Line Unity รองรับพารามิเตอร์คําขอเพิ่มเติมต่อไปนี้ ซึ่งสามารถส่งไปยังอะแดปเตอร์ผ่านคลาส LineMediationExtras
SetEnableAdSound(boolean)
: ระบุสถานะเริ่มต้นของเสียงเริ่มต้นของโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า และโฆษณาที่มีการให้รางวัล
ต่อไปนี้เป็นตัวอย่างโค้ดในการสร้างคําขอโฆษณาซึ่งตั้งค่าพารามิเตอร์เหล่านี้
using GoogleMobileAds.Api;
using GoogleMobileAds.Mediation.Line.Api;
// ...
var adRequest = new AdRequest();
var lineExtras = new LineMediationExtras();
lineExtras.SetEnableAdSound(true);
adRequest.MediationExtras.Add(lineExtras);
รหัสข้อผิดพลาด
หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก Line ผู้เผยแพร่โฆษณาสามารถตรวจสอบข้อผิดพลาดพื้นฐานจากการตอบกลับโฆษณาได้โดยใช้ ResponseInfo
ในคลาสต่อไปนี้
Android
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
iOS
GADMediationAdapterLine
รหัสและข้อความที่แสดงโดยอะแดปเตอร์ของ Line เมื่อโหลดโฆษณาไม่สำเร็จมีดังนี้
Android
รหัสข้อผิดพลาด | โดเมน | เหตุผล |
---|---|---|
1-10 | com.five_corp.ad | Line SDK แสดงข้อผิดพลาดเฉพาะ SDK ดูรายละเอียดเพิ่มเติมในเอกสารประกอบของ Line |
101 | com.google.ads.mediation.line | ไม่มีรหัสแอปพลิเคชันหรือไม่ถูกต้อง |
102 | com.google.ads.mediation.line | รหัสช่องขาดหายไปหรือไม่ถูกต้อง |
103 | com.google.ads.mediation.line | ขนาดโฆษณาที่ขอไม่ตรงกับขนาดโฆษณาแบนเนอร์ที่ Line รองรับ |
104 | com.google.ads.mediation.line | โหลดโฆษณาคั่นระหว่างหน้าหรือโฆษณาที่มีการให้รางวัลไม่สำเร็จเนื่องจากไม่มีบริบทกิจกรรม |
105 | com.google.ads.mediation.line | Line SDK แสดงโฆษณาคั่นระหว่างหน้าหรือโฆษณาที่มีการให้รางวัลไม่สำเร็จ |
106 | com.google.ads.mediation.line | โหลดโฆษณาเนทีฟไม่สำเร็จเนื่องจากไม่มีชิ้นงาน |
iOS
รหัสข้อผิดพลาด | โดเมน | เหตุผล |
---|---|---|
1-10 | ส่งโดย Line SDK | Line SDK แสดงข้อผิดพลาดเฉพาะ SDK ดูรายละเอียดเพิ่มเติมในเอกสารประกอบของ Line |
101 | com.google.ads.mediation.line | พารามิเตอร์เซิร์ฟเวอร์ไม่ถูกต้อง (เช่น ไม่มีรหัสแอปพลิเคชันหรือรหัสช่อง) |
102 | com.google.ads.mediation.line | ขนาดโฆษณาที่ขอไม่ตรงกับขนาดโฆษณาแบนเนอร์ที่ Line รองรับ |
103 | com.google.ads.mediation.line | โหลดชิ้นงานรูปภาพไอคอนข้อมูลในโฆษณาเนทีฟไม่สำเร็จ |
บันทึกการเปลี่ยนแปลงของปลั๊กอินสื่อกลาง Unity ของ Line
เวอร์ชัน 1.4.0
- รองรับอะแดปเตอร์ Line สำหรับ Android เวอร์ชัน 2.8.20240827.0
- รองรับอะแดปเตอร์ iOS ของ Line เวอร์ชัน 2.9.20241106.1
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 9.4.0
เวอร์ชัน 1.3.1
- รองรับอะแดปเตอร์ Android ของ Line เวอร์ชัน 2.8.20240808.0
- รองรับอะแดปเตอร์ iOS ของ Line เวอร์ชัน 2.8.20240612.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 9.2.0
เวอร์ชัน 1.3.0
- รองรับอะแดปเตอร์ Android ของ Line เวอร์ชัน 2.8.20240722.0
- รองรับอะแดปเตอร์ iOS ของ Line เวอร์ชัน 2.8.20240612.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 9.2.0
เวอร์ชัน 1.2.0
- รองรับอะแดปเตอร์ Android ของ Line เวอร์ชัน 2.7.20240515.0
- รองรับอะแดปเตอร์ iOS ของ Line เวอร์ชัน 2.8.20240612.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 9.1.1
เวอร์ชัน 1.1.2
- รองรับอะแดปเตอร์ Android ของ Line เวอร์ชัน 2.7.20240515.0
- รองรับอะแดปเตอร์ iOS ของ Line เวอร์ชัน 2.7.20240411.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 9.1.0
เวอร์ชัน 1.1.1
- รองรับอะแดปเตอร์ Android ของ Line เวอร์ชัน 2.7.20240214.1
- รองรับอะแดปเตอร์ iOS ของ Line เวอร์ชัน 2.7.20240411.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 9.1.0
เวอร์ชัน 1.1.0
- เพิ่มคลาส
LineMediationExtras
ที่มีเมธอดต่อไปนี้เพื่อรองรับการส่งข้อมูลเพิ่มเติมของสื่อกลางSetEnabledAdSound(bool)
- รองรับอะแดปเตอร์ Android ของ Line เวอร์ชัน 2.7.20240214.1
- รองรับอะแดปเตอร์ iOS ของ Line เวอร์ชัน 2.7.20240318.0
- สร้างขึ้นและทดสอบด้วยปลั๊กอิน Google Mobile Ads Unity เวอร์ชัน 9.0.0
เวอร์ชัน 1.0.0
- การเผยแพร่ครั้งแรก
- รองรับอะแดปเตอร์ Android ของ Line เวอร์ชัน 2.6.20230607.0
- รองรับอะแดปเตอร์ iOS ของ Line เวอร์ชัน 2.6.20230609.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 8.5.1