คู่มือนี้แสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดง จากโฆษณาในบรรทัดโดยใช้สื่อกลาง การผสานรวม Waterfall ซึ่งครอบคลุมถึงวิธีเพิ่มบรรทัดลงในหน่วยโฆษณา การกำหนดค่าสื่อกลาง และวิธีผสานรวม Line SDK และอะแดปเตอร์ ลงในแอป Unity
การผสานรวมและรูปแบบโฆษณาที่รองรับ
Ad Manager อะแดปเตอร์สื่อกลางสำหรับ Line มี ความสามารถต่อไปนี้
การผสานรวม | |
---|---|
การเสนอราคา | |
น้ำตก | 1 |
รูปแบบ | |
แบนเนอร์ | |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว |
1 การผสานรวม Waterfall อยู่ใน รุ่นเบต้าแบบจำกัดผู้ใช้งาน โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อขอสิทธิ์เข้าถึง
ข้อกำหนด
- Unity 4 ขึ้นไป
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุด
- เพื่อทำให้ใช้งานได้ใน Android
- API ของ Android ระดับ 21 ขึ้นไป
- เพื่อทำให้ใช้งานได้บน iOS
- เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
- โปรเจ็กต์ Unity ที่ใช้งานได้ซึ่งกำหนดค่าด้วย SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google โปรดดู เริ่มต้นใช้งานเพื่อดูรายละเอียด
- ทําตามคู่มือเริ่มต้นใช้งานของสื่อกลาง
ขั้นตอนที่ 1: กำหนดค่าใน Line UI
ขั้นตอนที่ 2: ตั้งค่าอุปสงค์ต่อรายการใน Ad Manager UI
กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา
Android
ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสําหรับ Android
iOS
โปรดดูวิธีการในขั้นตอนที่ 2 ในคู่มือสำหรับ iOS
ขั้นตอนที่ 3: นําเข้า SDK และอะแดปเตอร์ของ Line
ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google สำหรับ Line เวอร์ชันล่าสุด
จากลิงก์ดาวน์โหลดใน
Changelog และดึงข้อมูล
GoogleMobileAdsLineMediation.unitypackage
จากไฟล์ ZIP
ในเครื่องมือแก้ไขโปรเจ็กต์ Unity ให้เลือกเนื้อหา > นำเข้าแพ็กเกจ >
แพ็กเกจที่กำหนดเอง แล้วค้นหา GoogleMobileAdsLineMediation.unitypackage
ที่คุณดาวน์โหลดไว้ ตรวจสอบว่าได้เลือกไฟล์ทั้งหมดแล้ว และคลิก
นำเข้า
จากนั้นเลือกชิ้นงาน > ตัวแก้ไขบริการ Google Play > รีโซลเวอร์ Android >
บังคับให้แก้ไข ไลบรารีตัวแปลค่าบริการ Unity Play จะทำงาน
การแก้ไขทรัพยากร Dependency ใหม่ตั้งแต่ต้นและคัดลอกทรัพยากร Dependency ที่ประกาศไว้ไปยัง
ไดเรกทอรี Assets/Plugins/Android
ของแอป Unity
ขั้นตอนที่ 4: เพิ่มโค้ดที่จำเป็น
Android
ไม่ต้องมีรหัสเพิ่มเติมสำหรับการผสานรวม Line
iOS
การผสานรวม SKAdNetwork
ทำตามเอกสารประกอบของ Line
เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist
ของโปรเจ็กต์
ขั้นตอนที่ 5: ทดสอบการใช้งาน
เปิดใช้โฆษณาทดสอบ
อย่าลืม ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ Ad Manager
ทำตามวิธีการใน เอกสาร 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 | ไม่มี ID แอปพลิเคชันหรือรหัสไม่ถูกต้อง |
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 | ขนาดโฆษณาที่ขอไม่ตรงกับขนาดโฆษณาแบนเนอร์ที่รองรับสำหรับบรรทัด |
103 | com.google.ads.mediation.line | โหลดชิ้นงานรูปภาพไอคอนข้อมูลในโฆษณาเนทีฟไม่สำเร็จ |
บันทึกการเปลี่ยนแปลงของปลั๊กอินสื่อกลาง Unity ของ Line
เวอร์ชัน 1.3.1
- รองรับอะแดปเตอร์ Line Android เวอร์ชัน 2.8.20240808.0
- รองรับอะแดปเตอร์ iOS ของ Line เวอร์ชัน 2.8.20240612.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 9.2.0
เวอร์ชัน 1.3.0
- รองรับอะแดปเตอร์ Line Android เวอร์ชัน 2.8.20240722.0
- รองรับอะแดปเตอร์ Line iOS เวอร์ชัน 2.8.20240612.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.2.0
เวอร์ชัน 1.2.0
- รองรับอะแดปเตอร์ Line Android เวอร์ชัน 2.7.20240515.0
- รองรับอะแดปเตอร์ iOS ของ Line เวอร์ชัน 2.8.20240612.0
- สร้างและทดสอบด้วยปลั๊กอิน Unity ของ Google Mobile Ads เวอร์ชัน 9.1.1
เวอร์ชัน 1.1.2
- รองรับอะแดปเตอร์ Line Android เวอร์ชัน 2.7.20240515.0
- รองรับอะแดปเตอร์ Line iOS เวอร์ชัน 2.7.20240411.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.1.0
เวอร์ชัน 1.1.1
- รองรับอะแดปเตอร์ Line Android เวอร์ชัน 2.7.20240214.1
- รองรับอะแดปเตอร์ Line iOS เวอร์ชัน 2.7.20240411.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.1.0
เวอร์ชัน 1.1.0
- เพิ่มคลาส
LineMediationExtras
ด้วยวิธีการต่อไปนี้เพื่อรองรับการส่งเพิ่มเติมสำหรับสื่อกลางSetEnabledAdSound(bool)
- รองรับอะแดปเตอร์ Line Android เวอร์ชัน 2.7.20240214.1
- รองรับอะแดปเตอร์ Line iOS เวอร์ชัน 2.7.20240318.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.0.0
เวอร์ชัน 1.0.0
- การเผยแพร่ครั้งแรก
- รองรับอะแดปเตอร์ Line Android เวอร์ชัน 2.6.20230607.0
- รองรับอะแดปเตอร์ iOS ของ Line เวอร์ชัน 2.6.20230609.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.5.1