คู่มือนี้แสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดงโฆษณาจาก Line โดยใช้สื่อกลาง ซึ่งครอบคลุมการผสานรวม Waterfall ซึ่งครอบคลุมถึงวิธีเพิ่ม Line ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม Line SDK และอะแดปเตอร์เข้ากับแอป Unity
การผสานรวมและรูปแบบโฆษณาที่รองรับ
AdMob อะแดปเตอร์สื่อกลางสำหรับ Line มีความสามารถดังต่อไปนี้
การผสานรวม | |
---|---|
การเสนอราคา | |
น้ำตก | 1 |
รูปแบบ | |
แบนเนอร์ | |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว |
1 การผสานรวม Waterfall อยู่ในเวอร์ชันเบต้าแบบเปิด
ข้อกำหนด
- Unity 4 ขึ้นไป
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุด
- เพื่อทำให้ใช้งานได้ใน Android
- API ของ Android ระดับ 21 ขึ้นไป
- เพื่อทำให้ใช้งานได้ใน iOS
- เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
- โปรเจ็กต์ Unity ที่ใช้งานได้ซึ่งมีการกำหนดค่าด้วย SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ดูรายละเอียดได้ที่ เริ่มต้นใช้งาน
- ทำตามคู่มือเริ่มต้นใช้งานสื่อกลางให้เสร็จสมบูรณ์
ขั้นตอนที่ 1: กำหนดค่าใน Line UI
เข้าสู่ระบบบัญชี Line
เพิ่มแอปพลิเคชันใหม่
คลิก 広告枠管理 (การจัดการช่องโฆษณา) > メデア (สื่อ) จากนั้นก็คลิก โปรดอย่าลืม規作成 (สร้างใหม่)
กรอกแบบฟอร์มแล้วคลิก 登録 (ลงทะเบียน)
จดรหัสแอปพลิเคชันไว้
สร้างตำแหน่งโฆษณา
คลิกรหัสของแอปพลิเคชันที่คุณต้องการเพิ่มตำแหน่งโฆษณา จากนั้นเลือก 詳細 (Detail)
คลิก ロット 追加 (เพิ่มช่อง)
กรอกแบบฟอร์มแล้วคลิก (登録) ลงทะเบียน
จดบันทึกรหัสช่อง
ขั้นตอนที่ 2: ตั้งค่าความต้องการสำหรับรายการโฆษณาใน AdMob UI
กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา
Android
ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสําหรับ Android
iOS
โปรดดูวิธีการในขั้นตอนที่ 2 ในคู่มือสำหรับ iOS
ขั้นตอนที่ 3: นำเข้า Line SDK และอะแดปเตอร์
ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google สำหรับ Line เวอร์ชันล่าสุด
จากลิงก์ดาวน์โหลดใน
Changelog และดึงข้อมูล
GoogleMobileAdsLineMediation.unitypackage
จากไฟล์ ZIP
ในตัวแก้ไขโปรเจ็กต์ Unity ให้เลือกเนื้อหา > นำเข้าแพ็กเกจ >
แพ็กเกจที่กำหนดเอง แล้วหาไฟล์ GoogleMobileAdsLineMediation.unitypackage
ที่คุณดาวน์โหลด ตรวจสอบว่าได้เลือกไฟล์ทั้งหมดแล้ว และคลิกนำเข้า
จากนั้นเลือกเนื้อหา > ตัวแก้ไขบริการ Google Play > ตัวแก้ไข Android >
บังคับแก้ไข ไลบรารีตัวแปลค่าบริการ Unity Play จะแก้ปัญหาการขึ้นต่อกันใหม่ตั้งแต่ต้นและคัดลอกทรัพยากร Dependency ที่ประกาศไว้ไปยังไดเรกทอรี Assets/Plugins/Android
ของแอป Unity
ขั้นตอนที่ 4: เพิ่มโค้ดที่จําเป็น
Android
ไม่ต้องมีรหัสเพิ่มเติมสำหรับการผสานรวม Line
iOS
การผสานรวม SKAdNetwork
ทําตามเอกสารประกอบของบรรทัดเพื่อเพิ่มตัวระบุ 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 | ไม่มี ID แอปพลิเคชันหรือรหัสไม่ถูกต้อง |
102 | com.google.ads.mediation.line | ไม่มีรหัสช่องโฆษณาหรือรหัสไม่ถูกต้อง |
103 | com.google.ads.mediation.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 | โหลดชิ้นงานรูปภาพไอคอนข้อมูลในโฆษณาเนทีฟไม่สำเร็จ |
บันทึกการเปลี่ยนแปลงปลั๊กอินของสื่อกลาง Line Unity
เวอร์ชัน 1.2.0
- รองรับอะแดปเตอร์ Line Android เวอร์ชัน 2.7.20240515.0
- รองรับอะแดปเตอร์ Line iOS เวอร์ชัน 2.8.20240612.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 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
- รองรับอะแดปเตอร์ Line iOS เวอร์ชัน 2.6.20230609.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.5.1