แชร์ความคิดเห็นเกี่ยวกับ GMA Next-Gen SDK ในแชแนล #gma-next-gen-sdk ของเซิร์ฟเวอร์ชุมชนการโฆษณาและการวัดผลของ Google ใน Discord

ผสานรวม LINE กับสื่อกลาง

เลือกแพลตฟอร์ม: Android (เบต้า)

Android iOS Unity Flutter

คู่มือนี้จะแสดงวิธีใช้ GMA Next-Gen SDK เพื่อโหลดและแสดง โฆษณาจากเครือข่ายโฆษณา LINE โดยใช้สื่อกลาง ซึ่งครอบคลุมการผสานรวมแบบลำดับขั้น โดยจะครอบคลุมวิธีเพิ่มเครือข่ายโฆษณา LINE ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม SDK และอะแดปเตอร์ของเครือข่ายโฆษณา LINE เข้ากับแอป Android

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

การผสานรวมและรูปแบบโฆษณาที่รองรับ

อแดปเตอร์สื่อกลางสำหรับเครือข่ายโฆษณา LINE มีความสามารถดังนี้

การผสานรวม
การเสนอราคา
การแสดงวิดีโอตามลำดับขั้น
รูปแบบ
แบนเนอร์
โฆษณาคั่นระหว่างหน้า
ได้รับรางวัลแล้ว
เนทีฟ

ข้อกำหนด

API ระดับ 24 ขึ้นไปของ Android
[สำหรับการเสนอราคา]: หากต้องการผสานรวมรูปแบบโฆษณาที่รองรับทั้งหมดในการเสนอราคา ให้ใช้ อแดปเตอร์เครือข่ายโฆษณา LINE 2.9.20241129.0 ขึ้นไป (แนะนำให้ใช้เวอร์ชันล่าสุด)

ล่าสุดจาก GMA Next-Gen SDK
ทําตามคู่มือเริ่มต้นใช้งานสื่อกลางให้เสร็จสมบูรณ์

ขั้นตอนที่ 1: ตั้งค่าการกำหนดค่าใน UI ของเครือข่ายโฆษณา LINE

ลงชื่อสมัครใช้และเข้าสู่ระบบบัญชี LINE Ads Network

เพิ่มแอปพลิเคชันใหม่

ไปที่แท็บ アプリ (แอป) แล้วคลิกปุ่ม 新規登録 (ลงทะเบียนใหม่)

การจดทะเบียนใหม่

กรอกแบบฟอร์ม แล้วคลิก 登録 (ลงทะเบียน)

แบบฟอร์มการลงทะเบียนใหม่

จดรหัสแอปไว้

รายละเอียดการจดทะเบียน

สร้างช่องโฆษณา

ในแท็บアプリ (แอป) ให้เลือกแอปเพื่อดูรายละเอียดของแอป ในส่วนスロット (Slot) ให้คลิก 追加 (Add)

เพิ่มช่อง

กรอกแบบฟอร์มเพื่อดูรายละเอียดเกี่ยวกับช่อง สำหรับประเภทการเสนอราคา ให้เลือก มาตรฐานเพื่อกำหนดค่าช่องนี้สำหรับการแสดงโฆษณาตามลำดับขั้น หรือ การเสนอราคา SDK ของ Google เพื่อกำหนดค่าช่องนี้สำหรับการเสนอราคา คลิก 作成 (สร้าง) เมื่อกรอกแบบฟอร์มเสร็จแล้ว

เพิ่มแบบฟอร์มช่อง

จดรหัสสล็อต (Slot ID)

รายละเอียดสล็อต

อัปเดต 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 Bidding

คลิกบันทึก

น้ำตก

ขั้นตอนนี้ไม่จำเป็นสำหรับการผสานรวมแบบน้ำตก

กำหนดค่าการเสนอราคาเครือข่ายโฆษณา LINE

การเสนอราคา

ไปที่การแสดงโฆษณา > ผู้เสนอราคา แล้วคลิกไปที่การเสนอราคา SDK

คลิกผู้เสนอราคารายใหม่

เลือก LINE Ads Network เป็นผู้เสนอราคา

คลิกดำเนินการต่อเพื่อเปิดใช้การเสนอราคา SDK สำหรับผู้เสนอราคารายนี้

คลิกเสร็จสิ้น

น้ำตก

ขั้นตอนนี้ไม่จำเป็นสำหรับการผสานรวมแบบน้ำตก

กำหนดค่าการแมปหน่วยโฆษณา

การเสนอราคา

ไปที่การแสดงโฆษณา > ผู้เสนอราคา แล้วคลิกไปที่การเสนอราคา SDK

เลือกบริษัทสำหรับเครือข่ายโฆษณา LINE

ไปที่แท็บการแมปหน่วยโฆษณา แล้วคลิกการแมปหน่วยโฆษณาใหม่

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

น้ำตก

ไปที่การแสดงโฆษณา > กลุ่มผลตอบแทน แล้วคลิกปุ่มกลุ่มผลตอบแทนใหม่ เลือกแอปพลิเคชันบนอุปกรณ์เคลื่อนที่

เลื่อนลงแล้วคลิกเพิ่มพาร์ทเนอร์ผลตอบแทน

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

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

หมายเหตุ: การรวบรวมข้อมูลอัตโนมัติต้องใช้เวลารวบรวมข้อมูล 2-3 วันก่อนที่จะคำนวณค่า CPM แบบไดนามิกสำหรับเครือข่ายสื่อกลางได้อย่างแม่นยำ เมื่อคำนวณ eCPM ได้แล้ว ระบบจะอัปเดตให้คุณโดยอัตโนมัติ

ขั้นตอนที่ 3: นำเข้า SDK และอะแดปเตอร์เครือข่ายโฆษณา LINE

การผสานรวม Android Studio (แนะนํา)

ในไฟล์ Gradle ระดับแอป ให้เพิ่มการใช้งาน dependencies และการกำหนดค่าต่อไปนี้

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta03")
    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-beta03'
    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'
}

การผสานรวมด้วยตนเอง

ดาวน์โหลดเวอร์ชันล่าสุดของไฟล์ .aarSDK เครือข่ายโฆษณา LINE และเพิ่มลงในโปรเจ็กต์
ไปที่อาร์ติแฟกต์ของอะแดปเตอร์เครือข่ายโฆษณา LINE ในที่เก็บ Maven ของ Google เลือกเวอร์ชันล่าสุด ดาวน์โหลดไฟล์ .aar ของอแดปเตอร์เครือข่ายโฆษณา LINE แล้วเพิ่มลงในโปรเจ็กต์

ขั้นตอนที่ 4: เพิ่มโค้ดที่จำเป็น

ไม่จำเป็นต้องใช้โค้ดเพิ่มเติมสำหรับการผสานรวมเครือข่ายโฆษณา LINE

ขั้นตอนที่ 5: ทดสอบการติดตั้งใช้งาน

เปิดใช้โฆษณาทดสอบ

ตรวจสอบว่าคุณได้ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ Ad Manager

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

Java

LineMediationAdapter.Companion.setTestMode(true);LineMediationSnippets.java

Kotlin

LineMediationAdapter.setTestMode(true)LineMediationSnippets.kt

ยืนยันโฆษณาทดสอบ

หากต้องการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก เครือข่ายโฆษณา LINE ให้เปิดใช้การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้แหล่งที่มาของโฆษณา เครือข่ายโฆษณา LINE (Waterfall)

ขั้นตอนที่ไม่บังคับ

พารามิเตอร์เฉพาะเครือข่าย

อแดปเตอร์เครือข่ายโฆษณา LINE รองรับพารามิเตอร์คำขอเพิ่มเติมซึ่งส่งไปยังอแดปเตอร์ได้โดยใช้คลาส LineExtras ตัวสร้างคลาสนี้ มีพารามิเตอร์ต่อไปนี้

enableAdSound: boolean เพื่อระบุสถานะเริ่มต้นของเสียงเริ่มต้นของโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า และโฆษณาที่มีการให้รางวัล

ต่อไปนี้เป็นตัวอย่างโค้ดวิธีสร้างคำขอโฆษณาที่ตั้งค่าพารามิเตอร์เหล่านี้

Java

LineExtras lineExtras = new LineExtras(/* enableAdSound: */ true);
Bundle extras = lineExtras.build();

AdRequest request =
    new AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter.class, extras).build();LineMediationSnippets.java

Kotlin

val lineExtras = LineExtras(enableAdSound = true)
val extras = lineExtras.build()

val request =
  AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter::class.java, extras).build()LineMediationSnippets.kt

การใช้โฆษณาเนทีฟ

การแสดงโฆษณา

อะแดปเตอร์เครือข่ายโฆษณา LINE จะป้อนข้อมูลฟิลด์ต่อไปนี้ สำหรับ NativeAd

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

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

รหัสข้อผิดพลาด

หากอแดปเตอร์ไม่ได้รับโฆษณาจากเครือข่ายโฆษณา 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	โหลดโฆษณาเนทีฟไม่สำเร็จเนื่องจากไม่มีชิ้นงาน