คู่มือนี้แสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดงโฆษณาจาก Line โดยใช้สื่อกลาง ซึ่งครอบคลุมการผสานรวม Waterfall ซึ่งครอบคลุมถึงวิธีเพิ่ม Line ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม 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
เข้าสู่ระบบบัญชี Line
เพิ่มแอปพลิเคชันใหม่
คลิก 広告枠管理 (การจัดการช่องโฆษณา) > メデア (สื่อ) จากนั้นก็คลิก โปรดอย่าลืม規作成 (สร้างใหม่)
กรอกแบบฟอร์มแล้วคลิก 登録 (ลงทะเบียน)
จดรหัสแอปพลิเคชันไว้
สร้างตำแหน่งโฆษณา
คลิกรหัสของแอปพลิเคชันที่คุณต้องการเพิ่มตำแหน่งโฆษณา จากนั้นเลือก 詳細 (Detail)
คลิก ロット 追加 (เพิ่มช่อง)
กรอกแบบฟอร์มแล้วคลิก (登録) ลงทะเบียน
จดบันทึกรหัสช่อง
ขั้นตอนที่ 2: ตั้งค่าความต้องการสำหรับรายการโฆษณาใน Ad Manager 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: ทดสอบการใช้งาน
เปิดใช้โฆษณาทดสอบ
อย่าลืม ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ Ad Manager
ทำตามวิธีการใน เอกสาร Android และ iOS ของ Line เกี่ยวกับวิธีเปิดใช้โฆษณาทดสอบ Line
ยืนยันโฆษณาทดสอบ
ในการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก Line ให้เปิดใช้ การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้ Line (Waterfall) แหล่งที่มาของโฆษณา
รหัสข้อผิดพลาด
หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก 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.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