คู่มือนี้จะแสดงวิธีใช้ Google Mobile Ads SDK เพื่อโหลดและแสดง โฆษณาจากเครือข่ายโฆษณา LINE โดยใช้ สื่อกลาง ซึ่งครอบคลุมการผสานรวมแบบน้ำตก โดยจะครอบคลุมวิธีเพิ่มเครือข่ายโฆษณา LINE ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม SDK และอะแดปเตอร์ของเครือข่ายโฆษณา LINE เข้ากับแอป Android
อินเทอร์เฟซแดชบอร์ดสำหรับเครือข่ายโฆษณา LINE ใช้ข้อความภาษาญี่ปุ่นสำหรับป้ายกำกับ ปุ่ม และคำอธิบาย ภาพหน้าจอในคู่มือนี้ยังไม่ได้ แปล อย่างไรก็ตาม ในคำอธิบายและวิธีการของคู่มือนี้ ป้ายกำกับและปุ่มจะได้รับการแปลโดยมีคำภาษาอังกฤษที่เทียบเท่าอยู่ในวงเล็บ
การผสานรวมและรูปแบบโฆษณาที่รองรับ
อแดปเตอร์สื่อกลางสำหรับเครือข่ายโฆษณา LINE มีความสามารถดังนี้
การผสานรวม | |
---|---|
การเสนอราคา | |
น้ำตก | |
รูปแบบ | |
ป้ายประกาศ | |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว | |
เนทีฟ | 1 |
1 โฆษณาเนทีฟ (สำหรับการเสนอราคา) อยู่ในโปรแกรมเบต้าแบบปิด โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อ ขอสิทธิ์เข้าถึง
ข้อกำหนด
- API ระดับ 23 ขึ้นไปของ Android
Google Mobile Ads SDK เวอร์ชันล่าสุด
ทําตามคู่มือเริ่มต้นใช้งานสื่อกลางให้เสร็จสมบูรณ์
ขั้นตอนที่ 1: ตั้งค่าการกำหนดค่าใน UI ของเครือข่ายโฆษณา LINE
ลงชื่อสมัครใช้และ เข้าสู่ระบบบัญชี LINE Ads Network
เพิ่มแอปพลิเคชันใหม่
คลิก 広告枠管理 (Ad Slot Management) > メディア (Media) จากนั้นคลิก新規作成 (สร้างใหม่)
กรอกแบบฟอร์ม แล้วคลิก 登録 (ลงทะเบียน)
จดรหัสแอปพลิเคชัน
สร้างตำแหน่งโฆษณา
คลิกรหัสของแอปพลิเคชันที่ต้องการเพิ่มตําแหน่งโฆษณา จากนั้น เลือก詳細 (รายละเอียด)
คลิก スロット 追加 (เพิ่มสล็อต)
กรอกแบบฟอร์มเพื่อดูรายละเอียดเกี่ยวกับช่อง สำหรับประเภทการเสนอราคา ให้เลือก มาตรฐานเพื่อกำหนดค่าช่องนี้สำหรับการแสดงโฆษณาตามลำดับขั้น หรือ การเสนอราคา SDK ของ Google เพื่อกำหนดค่าช่องนี้สำหรับการเสนอราคา คลิก 登録 (ลงทะเบียน) เมื่อกรอกแบบฟอร์มเสร็จแล้ว
จดรหัสช่อง
อัปเดต app-ads.txt
ผู้ขายที่ได้รับอนุญาตสำหรับแอป app-ads.txt เป็นความคิดริเริ่มของ IAB Tech Lab ที่ช่วยตรวจสอบว่าคุณจะขาย
พื้นที่โฆษณาในแอปผ่านช่องทางที่คุณได้รับอนุญาตเท่านั้น คุณจะต้องใช้ไฟล์ app-ads.txt
เพื่อป้องกันไม่ให้เสียรายได้จากโฆษณาเป็นจำนวนมาก
หากยังไม่ได้ดำเนินการ ให้
สร้างไฟล์ app-ads.txt สำหรับ Ad Manager
หากต้องการใช้ app-ads.txt
สำหรับเครือข่ายโฆษณา LINE โปรดดู
เกี่ยวกับ app-ads.txt
ขั้นตอนที่ 2: ตั้งค่าดีมานด์เครือข่ายโฆษณา LINE ใน UI ของ Ad Manager
ลงชื่อเข้าใช้บัญชี Ad Manager
เพิ่มเครือข่ายโฆษณา LINE ในบริษัท
การเสนอราคา
ขั้นตอนนี้ไม่จำเป็นสำหรับการผสานรวมการเสนอราคา
น้ำตก
ไปที่ผู้ดูแลระบบ > บริษัท แล้วคลิกปุ่มบริษัทใหม่ ในแท็บบริษัททั้งหมด เลือกเครือข่ายโฆษณา
เลือก LINE Ads Network เป็นเครือข่ายโฆษณา ป้อนชื่อที่ไม่ซ้ำกัน แล้วเปิดใช้สื่อกลาง เปิดการเก็บรวบรวมข้อมูลอัตโนมัติ แล้วป้อนชื่อเข้าสู่ระบบและรหัสผ่านที่ได้รับในส่วนก่อนหน้า
คุณไม่จำเป็นต้องป้อนชื่อผู้ใช้หรือรหัสผ่าน คลิกบันทึกเมื่อเสร็จแล้ว
เปิดใช้การแชร์สัญญาณที่ปลอดภัย
การเสนอราคา
ไปที่ผู้ดูแลระบบ > การตั้งค่าส่วนกลาง ไปที่แท็บการตั้งค่าบัญชี Ad Exchange แล้วตรวจสอบและเปิดการแชร์สัญญาณที่ปลอดภัย คลิกบันทึก
น้ำตก
ขั้นตอนนี้ไม่จำเป็นสำหรับการผสานรวมแบบน้ำตก
แชร์สัญญาณที่ปลอดภัยในคำขอราคาเสนอ
การเสนอราคา
ไปที่พื้นที่โฆษณา > สัญญาณที่ปลอดภัย ในส่วนสัญญาณที่ปลอดภัย ให้ค้นหา LINE แล้ว เปิดเปิดใช้การผสานรวมแอป
คลิกบันทึก
น้ำตก
ขั้นตอนนี้ไม่จำเป็นสำหรับการผสานรวมแบบน้ำตก
อนุญาตการแชร์สัญญาณที่ปลอดภัยสำหรับการเสนอราคา SDK
การเสนอราคา
ไปที่การแสดงโฆษณา > การตั้งค่าแชแนลดีมานด์ ในแท็บการตั้งค่า เริ่มต้น ให้เปิดอนุญาตการแชร์สัญญาณที่ปลอดภัยสำหรับการเสนอราคา SDK
คลิกบันทึก
น้ำตก
ขั้นตอนนี้ไม่จำเป็นสำหรับการผสานรวมแบบน้ำตก
กำหนดค่าการเสนอราคาเครือข่ายโฆษณา LINE
การเสนอราคา
ไปที่การแสดงโฆษณา > ผู้เสนอราคา แล้วคลิกไปที่การเสนอราคา SDK
คลิกผู้เสนอราคารายใหม่
เลือก LINE Ads Network เป็นผู้เสนอราคา
คลิกดำเนินการต่อเพื่อเปิดใช้การเสนอราคา SDK สำหรับผู้เสนอราคารายนี้
คลิกเสร็จสิ้น
น้ำตก
ขั้นตอนนี้ไม่จำเป็นสำหรับการผสานรวมแบบน้ำตก
กำหนดค่าการแมปหน่วยโฆษณา
การเสนอราคา
ไปที่การแสดงโฆษณา > ผู้เสนอราคา แล้วคลิกไปที่การเสนอราคา SDK
เลือกบริษัทสำหรับเครือข่ายโฆษณา LINE
ไปที่แท็บการแมปหน่วยโฆษณา แล้วคลิกการแมปหน่วยโฆษณาใหม่
เลือกหน่วยโฆษณาที่เฉพาะเจาะจง เลือกหน่วยโฆษณาและรูปแบบ แอปบนอุปกรณ์เคลื่อนที่เป็น ประเภทพื้นที่โฆษณา และแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ จากนั้นป้อนรหัสแอปพลิเคชันและรหัสช่อง ที่ได้รับในส่วนก่อนหน้า สุดท้าย ให้คลิกบันทึก
น้ำตก
ไปที่การแสดงโฆษณา > กลุ่มผลตอบแทน แล้วคลิกปุ่มกลุ่มผลตอบแทนใหม่ เลือกแอปพลิเคชันบนอุปกรณ์เคลื่อนที่
เลื่อนลงแล้วคลิกเพิ่มพาร์ทเนอร์ผลตอบแทน
เลือกบริษัทที่คุณสร้างไว้สำหรับ เครือข่ายโฆษณา LINE ในส่วนก่อนหน้า เลือกสื่อกลาง SDK บนอุปกรณ์เคลื่อนที่เป็นประเภทการผสานรวม Android เป็นแพลตฟอร์ม และใช้งานอยู่เป็นสถานะ
ป้อนรหัสแอปพลิเคชันและรหัสสล็อต ที่ได้รับในส่วนก่อนหน้า รวมถึงค่า CPM เริ่มต้น คลิกบันทึก
หมายเหตุ: การรวบรวมข้อมูลอัตโนมัติต้องใช้เวลารวบรวมข้อมูล 2-3 วันก่อนที่จะคำนวณค่า CPM แบบไดนามิกสำหรับเครือข่ายสื่อกลางได้อย่างแม่นยำ เมื่อคำนวณ eCPM ได้แล้ว ระบบจะอัปเดตให้คุณโดยอัตโนมัติ
ขั้นตอนที่ 3: นำเข้า SDK และอะแดปเตอร์เครือข่ายโฆษณา LINE
การผสานรวม Android Studio (แนะนํา)
ในไฟล์ build.gradle.kts
ระดับแอป ให้เพิ่มการติดตั้งใช้งาน
การกำหนดค่าและการขึ้นต่อกันต่อไปนี้ ใช้ SDK และอะแดปเตอร์ของเครือข่ายโฆษณา LINE เวอร์ชันล่าสุด
dependencies {
implementation("com.google.android.gms:play-services-ads:24.5.0")
implementation("com.google.ads.mediation:line:2.9.20250718.0")
}
การผสานรวมด้วยตนเอง
ดาวน์โหลดเวอร์ชันล่าสุดของไฟล์
.aar
ของ SDK เครือข่ายโฆษณา LINE และเพิ่มลงในโปรเจ็กต์ไปที่อาร์ติแฟกต์ของอะแดปเตอร์เครือข่ายโฆษณา LINE ในที่เก็บ Maven ของ Google เลือกเวอร์ชันล่าสุด ดาวน์โหลดไฟล์
.aar
ของอแดปเตอร์เครือข่ายโฆษณา LINE แล้วเพิ่มลงในโปรเจ็กต์
ขั้นตอนที่ 4: เพิ่มโค้ดที่จำเป็น
ไม่จำเป็นต้องใช้โค้ดเพิ่มเติมสำหรับการผสานรวมเครือข่ายโฆษณา LINE
ขั้นตอนที่ 5: ทดสอบการติดตั้งใช้งาน
เปิดใช้โฆษณาทดสอบ
ตรวจสอบว่าคุณได้ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ Ad Manager
ยืนยันโฆษณาทดสอบ
หากต้องการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก เครือข่ายโฆษณา LINE ให้เปิดใช้การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้แหล่งที่มาของโฆษณาเครือข่ายโฆษณา LINE (Waterfall)
ขั้นตอนที่ไม่บังคับ
พารามิเตอร์เฉพาะเครือข่าย
อแดปเตอร์เครือข่ายโฆษณา LINE รองรับพารามิเตอร์คำขอเพิ่มเติมซึ่งส่งไปยังอแดปเตอร์ได้โดยใช้คลาส LineExtras
ตัวสร้างคลาสนี้มีพารามิเตอร์ต่อไปนี้
enableAdSound
boolean
เพื่อระบุสถานะเริ่มต้นของเสียงเริ่มต้นของโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า และโฆษณาที่มีการให้รางวัล
ต่อไปนี้เป็นตัวอย่างโค้ดวิธีสร้างคำขอโฆษณาที่ตั้งค่าพารามิเตอร์เหล่านี้
Java
LineExtras lineExtras = new LineExtras(true);
Bundle extras = lineExtras.build();
AdManagerAdRequest request = new AdManagerAdRequest.Builder()
.addNetworkExtrasBundle(LineMediationAdapter.class, extras)
.build();
Kotlin
val lineExtras = LineExtras(true)
val extras = lineExtras.build()
val request = AdManagerAdRequest.Builder()
.addNetworkExtrasBundle(LineMediationAdapter::class.java, extras)
.build()
การใช้โฆษณาเนทีฟ
การแสดงโฆษณา
อะแดปเตอร์เครือข่ายโฆษณา LINE จะป้อนข้อมูลฟิลด์ต่อไปนี้
สำหรับ
NativeAd
ช่อง | ชิ้นงานที่อะแดปเตอร์เครือข่ายโฆษณา LINE รวมไว้เสมอ |
---|---|
บรรทัดแรก | |
รูปภาพ | |
เนื้อความ | |
ไอคอนแอป | 1 |
คำกระตุ้นการตัดสินใจ | |
การให้ดาว | |
ร้านค้า | |
ราคา |
1 สำหรับโฆษณาเนทีฟ SDK เครือข่ายโฆษณา LINE จะไม่มีชิ้นงานไอคอนแอป แต่ตัวดัดแปลงเครือข่ายโฆษณา LINE จะแสดงไอคอนแอปเป็นรูปภาพโปร่งใสแทน
รหัสข้อผิดพลาด
หากอแดปเตอร์ไม่ได้รับโฆษณาจากเครือข่ายโฆษณา LINE คุณสามารถตรวจสอบ
ข้อผิดพลาดพื้นฐานจากการตอบกลับโฆษณาได้โดยใช้
ResponseInfo.getAdapterResponses()
ภายใต้คลาสต่อไปนี้
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
ต่อไปนี้คือรหัสและข้อความที่มาพร้อมกันซึ่งอแดปเตอร์เครือข่ายโฆษณา LINE แสดงเมื่อโหลดโฆษณาล้มเหลว
รหัสข้อผิดพลาด | โดเมน | เหตุผล |
---|---|---|
1-10 | com.five_corp.ad | SDK เครือข่ายโฆษณา LINE แสดงข้อผิดพลาดเฉพาะ 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 | SDK เครือข่ายโฆษณา LINE แสดงโฆษณาคั่นระหว่างหน้าหรือโฆษณาที่มีการให้รางวัลไม่สำเร็จ |
106 | com.google.ads.mediation.line | โหลดโฆษณาเนทีฟไม่สำเร็จเนื่องจากไม่มีชิ้นงาน |
บันทึกการเปลี่ยนแปลงของตัวกลาง Android ของ LINE
เวอร์ชัน 2.9.20250718.0
- ยืนยันความเข้ากันได้กับ FiveAd SDK เวอร์ชัน 2.9.20250718
สร้างและทดสอบด้วย
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 24.3.0
- FiveAd SDK เวอร์ชัน 2.9.20250718.0
เวอร์ชัน 2.9.20250519.0
- ยืนยันความเข้ากันได้กับ FiveAd SDK เวอร์ชัน 2.9.20250519
สร้างและทดสอบด้วย
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 24.3.0
- FiveAd SDK เวอร์ชัน 2.9.20250519.0
เวอร์ชัน 2.9.20250317.1
- แก้ไขขนาดการโหลดแบนเนอร์สำหรับโฆษณาที่เสนอราคาด้วย FiveAd API ใหม่
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 24.1.0
- FiveAd SDK เวอร์ชัน 2.9.20250317.0
เวอร์ชัน 2.9.20250317.0
- ยืนยันความเข้ากันได้กับ FiveAd SDK เวอร์ชัน 2.9.20250317
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 24.1.0
- FiveAd SDK เวอร์ชัน 2.9.20250317.0
เวอร์ชัน 2.9.20250110.1
- อัปเดตระดับ API ขั้นต่ำของ Android ที่จำเป็นเป็น 23
- อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำที่กำหนดเป็น 24.0.0
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 24.0.0
- FiveAd SDK เวอร์ชัน 2.9.20250110.0
เวอร์ชัน 2.9.20250110.0
- นำคลาส
UnifiedNativeAdMapper
ที่เลิกใช้งานแล้วออกเพื่อใช้NativeAdMapper
แทน - แก้ไขกระบวนการเก็บรวบรวมสัญญาณ
- กระบวนการเริ่มต้นคงที่สำหรับรูปแบบโฆษณาคั่นระหว่างหน้าและโฆษณาที่มีการให้รางวัลแบบ Waterfall
- ยืนยันความเข้ากันได้กับ FiveAd SDK เวอร์ชัน 2.9.20250110
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 23.6.0
- FiveAd SDK เวอร์ชัน 2.9.20250110.0
เวอร์ชัน 2.9.20241129.0
- เพิ่มการรองรับการเสนอราคาสำหรับรูปแบบโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า โฆษณาที่มีการให้รางวัล และโฆษณาเนทีฟ
- ยืนยันความเข้ากันได้กับ FiveAd SDK เวอร์ชัน 2.9.20241129
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 23.5.0
- FiveAd SDK เวอร์ชัน 2.9.20241129.0
เวอร์ชัน 2.8.20240827.0
- ได้รับการยืนยันว่าใช้งานร่วมกับ FiveAd SDK เวอร์ชัน 2.8.20240827 ได้
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 23.3.0
- FiveAd SDK เวอร์ชัน 2.8.20240827.0
เวอร์ชัน 2.8.20240808.0
- ได้รับการยืนยันว่าใช้งานร่วมกับ FiveAd SDK เวอร์ชัน 2.8.20240808 ได้
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 23.2.0
- SDK เวอร์ชัน 2.8.20240808.0 ของ FiveAd
เวอร์ชัน 2.8.20240722.0
- ยืนยันความเข้ากันได้กับ FiveAd SDK เวอร์ชัน 2.8.20240722
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 23.2.0
- FiveAd SDK เวอร์ชัน 2.8.20240722.0
เวอร์ชัน 2.7.20240515.0
- ยืนยันความเข้ากันได้กับ FiveAd SDK เวอร์ชัน 2.7.20240515
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 23.1.0
- SDK ของ FiveAd เวอร์ชัน 2.7.20240515.0
เวอร์ชัน 2.7.20240214.1
- อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำที่กำหนดเป็น 23.0.0
- ยืนยันความเข้ากันได้กับ FiveAd SDK เวอร์ชัน 2.7.20240214
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 23.0.0
- SDK ของ FiveAd เวอร์ชัน 2.7.20240214.0
เวอร์ชัน 2.7.20240214.0
- ยืนยันความเข้ากันได้กับ FiveAd SDK เวอร์ชัน 2.7.20240214
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 22.6.0
- SDK ของ FiveAd เวอร์ชัน 2.7.20240214.0
เวอร์ชัน 2.7.20240126.0
- ยืนยันความเข้ากันได้กับ FiveAd SDK เวอร์ชัน 2.7.20240126
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 22.6.0
- SDK ของ FiveAd เวอร์ชัน 2.7.20240126.0
เวอร์ชัน 2.7.20240112.0
- นำ
FiveAdViewEventListener
ที่เลิกใช้งานแล้วออกเพื่อใช้FiveAdCustomLayoutEventListener
,FiveAdVideoRewardEventListener
,FiveAdInterstitialEventListener
และFiveAdNativeEventListener
แทน - ยืนยันความเข้ากันได้กับ FiveAd SDK เวอร์ชัน 2.7.20240112
- อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำที่กำหนดเป็น 22.6.0
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 22.6.0
- SDK ของ FiveAd เวอร์ชัน 2.7.20240112
เวอร์ชัน 2.6.20230607.1
- เพิ่ม
LineExtras
คลาสสำหรับผู้เผยแพร่โฆษณาเพื่อกำหนดการตั้งค่าเสียงเริ่มต้นสำหรับ รูปแบบโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า และโฆษณาที่มีการให้รางวัล - อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำที่กำหนดเป็น 22.4.0
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 22.4.0
- SDK ของ FiveAd เวอร์ชัน 2.6.20230607
เวอร์ชัน 2.6.20230607.0
- รุ่นแรก
- เพิ่มการรองรับรูปแบบโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า โฆษณาที่มีการให้รางวัล และโฆษณาเนทีฟ
- ยืนยันความเข้ากันได้กับ FiveAd SDK เวอร์ชัน 2.6.20230607
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 22.1.0
- SDK ของ FiveAd เวอร์ชัน 2.6.20230607