คู่มือนี้จะแสดงวิธีใช้ GMA Next-Gen SDK เพื่อโหลดและแสดง โฆษณาจากเครือข่ายโฆษณา LINE โดยใช้สื่อกลาง AdMob ซึ่งครอบคลุมการผสานรวมแบบลำดับขั้น โดยจะครอบคลุมวิธีเพิ่มเครือข่ายโฆษณา LINE ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม SDK และอะแดปเตอร์ของเครือข่ายโฆษณา LINE เข้ากับแอป Android
อินเทอร์เฟซแดชบอร์ดของเครือข่ายโฆษณา LINE ใช้ข้อความภาษาญี่ปุ่นสำหรับป้ายกำกับ ปุ่ม และคำอธิบาย ภาพหน้าจอในคู่มือนี้ยังไม่ได้ แปล อย่างไรก็ตาม ในคำอธิบายและวิธีการของคู่มือนี้ เราจะแปลป้ายกำกับและปุ่มโดยใช้คำภาษาอังกฤษที่เทียบเท่าในวงเล็บ
การผสานรวมและรูปแบบโฆษณาที่รองรับ
อแดปเตอร์สื่อกลางสำหรับเครือข่ายโฆษณา LINE มีความสามารถดังนี้
| การผสานรวม | |
|---|---|
| การเสนอราคา | |
| การแสดงวิดีโอตามลำดับขั้น | |
| รูปแบบ | |
| แบนเนอร์ | |
| โฆษณาคั่นระหว่างหน้า | |
| ได้รับรางวัลแล้ว | |
| เนทีฟ | 1 |
1 โฆษณาเนทีฟ (สำหรับการเสนอราคา) อยู่ในโปรแกรมเบต้าแบบปิด โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อ ขอสิทธิ์เข้าถึง
ข้อกำหนด
API ระดับ 24 ขึ้นไปของ Android
[สำหรับการเสนอราคา]: หากต้องการผสานรวมรูปแบบโฆษณาที่รองรับทั้งหมดในการเสนอราคา ให้ใช้ อแดปเตอร์เครือข่ายโฆษณา LINE 2.9.20241129.0 ขึ้นไป (แนะนำให้ใช้เวอร์ชันล่าสุด)
ล่าสุดจาก GMA Next-Gen 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 สำหรับแอป
หากต้องการใช้ app-ads.txt สำหรับเครือข่ายโฆษณา LINE โปรดดู
เกี่ยวกับ app-ads.txt
ขั้นตอนที่ 2: ตั้งค่าดีมานด์เครือข่ายโฆษณา LINE ใน UI ของ AdMob
กำหนดค่าการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา
คุณต้องเพิ่มเครือข่ายโฆษณา LINE ลงในการกําหนดค่าสื่อกลางสําหรับหน่วยโฆษณา
ก่อนอื่น ให้ลงชื่อเข้าใช้บัญชี AdMob จากนั้นไปที่แท็บสื่อกลาง หากมีกลุ่มสื่อกลางอยู่แล้วที่ต้องการแก้ไข ให้คลิกชื่อกลุ่มสื่อกลางนั้นเพื่อแก้ไข แล้วข้ามไปที่ เพิ่มเครือข่ายโฆษณา LINE เป็นแหล่งที่มาของโฆษณา
หากต้องการสร้างกลุ่มสื่อกลางใหม่ ให้เลือกสร้างกลุ่มสื่อกลาง

ป้อนรูปแบบโฆษณาและแพลตฟอร์ม แล้วคลิกต่อไป

ตั้งชื่อกลุ่มสื่อกลาง แล้วเลือกสถานที่ตั้งที่จะกำหนดเป้าหมาย จากนั้นตั้งค่าสถานะกลุ่มสื่อกลางเป็นเปิดใช้ แล้วคลิกเพิ่มหน่วยโฆษณา

เชื่อมโยงกลุ่มสื่อกลางนี้กับหน่วยโฆษณา AdMob ที่มีอยู่ อย่างน้อย 1 หน่วย จากนั้นคลิกเสร็จสิ้น

ตอนนี้คุณควรเห็นการ์ดหน่วยโฆษณาที่แสดงหน่วยโฆษณาที่คุณเลือก

เพิ่มเครือข่ายโฆษณา LINE เป็นแหล่งที่มาของโฆษณา
การเสนอราคา
ในส่วนแหล่งที่มาของโฆษณา ภายใต้การ์ดการเสนอราคา ให้เลือกเพิ่ม แหล่งที่มาของโฆษณา จากนั้นเลือกเครือข่ายโฆษณา LINE
คลิกวิธีลงนามในข้อตกลงสำหรับพาร์ทเนอร์และ ตั้งค่าการเป็นพาร์ทเนอร์ด้านการเสนอราคากับ เครือข่ายโฆษณา LINE
คลิกรับทราบและยอมรับ แล้วคลิกต่อไป
หากมีการแมปสำหรับเครือข่ายโฆษณา LINE อยู่แล้ว คุณสามารถเลือกการแมปนั้นได้ หากไม่ ให้คลิกเพิ่มการแมป
จากนั้น ป้อน รหัสแอปพลิเคชันและรหัสสล็อต ที่ได้รับในส่วนก่อนหน้า จากนั้นคลิกเสร็จสิ้น

น้ำตก
ในการ์ดสื่อกลางตามลำดับขั้นในส่วนแหล่งที่มาของโฆษณา ให้เลือกเพิ่มแหล่งที่มาของโฆษณา
เลือกเครือข่ายโฆษณา LINE แล้วเปิดสวิตช์เพิ่มประสิทธิภาพ ป้อนชื่อเข้าสู่ระบบและรหัสผ่าน ที่ได้รับในส่วนก่อนหน้าเพื่อตั้งค่าการเพิ่มประสิทธิภาพแหล่งที่มาของโฆษณาสำหรับ เครือข่ายโฆษณา LINE จากนั้นป้อนค่า eCPM สำหรับ เครือข่ายโฆษณา LINE แล้วคลิกต่อไป

หากมีการแมปสำหรับ เครือข่ายโฆษณา LINE อยู่แล้ว คุณสามารถเลือกการแมปนั้นได้ หากไม่ ให้คลิกเพิ่มการแมป

จากนั้นป้อน รหัสแอปพลิเคชันและรหัสสล็อต ที่ได้รับในส่วนก่อนหน้า จากนั้นคลิกเสร็จสิ้น

ขั้นตอนที่ 3: นำเข้า SDK และอะแดปเตอร์เครือข่ายโฆษณา LINE
การผสานรวม Android Studio (แนะนํา)
ในไฟล์ Gradle ระดับแอป ให้เพิ่มการใช้งาน dependencies และการกำหนดค่าต่อไปนี้
Kotlin
dependencies { implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02") implementation("com.google.ads.mediation:line:3.0.1.1") } configurations.configureEach { exclude(group = "com.google.android.gms", module = "play-services-ads") exclude(group = "com.google.android.gms", module = "play-services-ads-lite") }
ดึงดูด
dependencies { implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02' implementation 'com.google.ads.mediation:line:3.0.1.1' } configurations.configureEach { exclude group: 'com.google.android.gms', module: 'play-services-ads' exclude group: 'com.google.android.gms', module: 'play-services-ads-lite' }
การผสานรวมด้วยตนเอง
ดาวน์โหลด
.aarไฟล์ SDK ของเครือข่ายโฆษณา LINE เวอร์ชันล่าสุด แล้วเพิ่มลงในโปรเจ็กต์ไปที่อาร์ติแฟกต์ของอะแดปเตอร์เครือข่ายโฆษณา LINE ในที่เก็บ Maven ของ Google เลือกเวอร์ชันล่าสุด ดาวน์โหลดไฟล์
.aarของอแดปเตอร์เครือข่ายโฆษณา LINE แล้วเพิ่มลงในโปรเจ็กต์
ขั้นตอนที่ 4: เพิ่มโค้ดที่จำเป็น
ไม่จำเป็นต้องใช้โค้ดเพิ่มเติมสำหรับการผสานรวมเครือข่ายโฆษณา LINE
ขั้นตอนที่ 5: ทดสอบการติดตั้งใช้งาน
เปิดใช้โฆษณาทดสอบ
ตรวจสอบว่าคุณได้ลงทะเบียนอุปกรณ์ทดสอบสำหรับ AdMob แล้ว
อแดปเตอร์เครือข่ายโฆษณา LINE มีเมธอดตัวช่วยในการเปิดใช้โหมดทดสอบสำหรับ เครือข่ายโฆษณา LINE คุณต้องตั้งค่าตัวเลือกนี้ก่อนที่จะเริ่มต้นGMA Next-Gen SDK เพื่อให้แน่ใจว่าระบบจะส่งต่อตัวเลือกเหล่านี้ไปยัง SDK เครือข่ายโฆษณา LINE อย่างถูกต้อง
Java
Kotlin
ยืนยันโฆษณาทดสอบ
หากต้องการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก เครือข่ายโฆษณา LINE ให้เปิดใช้การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้แหล่งที่มาของโฆษณา เครือข่ายโฆษณา LINE (Waterfall)
ขั้นตอนที่ไม่บังคับ
พารามิเตอร์เฉพาะเครือข่าย
อแดปเตอร์เครือข่ายโฆษณา LINE รองรับพารามิเตอร์คำขอเพิ่มเติมซึ่งส่งไปยังอแดปเตอร์ได้โดยใช้คลาส LineExtras ตัวสร้างคลาสนี้
มีพารามิเตอร์ต่อไปนี้
enableAdSoundbooleanเพื่อระบุสถานะเริ่มต้นของเสียงเริ่มต้นของโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า และโฆษณาที่มีการให้รางวัล
ต่อไปนี้เป็นตัวอย่างโค้ดวิธีสร้างคำขอโฆษณาที่ตั้งค่าพารามิเตอร์เหล่านี้
Java
Kotlin
การใช้โฆษณาเนทีฟ
การแสดงโฆษณา
อแดปเตอร์ LINE Ads Network จะป้อนข้อมูลต่อไปนี้
คำอธิบายช่องขั้นสูงของโฆษณาเนทีฟ
สำหรับ
NativeAd
| ช่อง | ชิ้นงานที่อะแดปเตอร์เครือข่ายโฆษณา LINE รวมไว้เสมอ |
|---|---|
| บรรทัดแรก | |
| รูปภาพ | |
| เนื้อความ | |
| ไอคอนแอป | 1 |
| คำกระตุ้นการตัดสินใจ | |
| การให้ดาว | |
| ร้านค้า | |
| ราคา |
1 สำหรับโฆษณาเนทีฟ SDK เครือข่ายโฆษณา LINE จะไม่มีชิ้นงานไอคอนแอป แต่ LINE Ads Network adapter จะแสดงไอคอนแอปเป็นรูปภาพโปร่งใสแทน
รหัสข้อผิดพลาด
หากอแดปเตอร์ไม่ได้รับโฆษณาจากเครือข่ายโฆษณา LINE คุณสามารถตรวจสอบ
ข้อผิดพลาดพื้นฐานจากการตอบกลับโฆษณาได้โดยใช้
ResponseInfo.getAdSourceResponses()
ภายใต้คลาสต่อไปนี้
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 | โหลดโฆษณาเนทีฟไม่สำเร็จเนื่องจากไม่มีชิ้นงาน |