ผสานรวมเครือข่ายโฆษณา LINE กับสื่อกลาง (เบต้า)

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

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

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

อะแดปเตอร์สื่อกลางสําหรับเครือข่ายโฆษณา LINE มีคุณสมบัติดังต่อไปนี้

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

¹ การผสานรวม Waterfall อยู่ในรุ่นเบต้าแบบเปิด

ข้อกำหนด

• Android API ระดับ 21 ขึ้นไป

• Google Mobile Ads SDK เวอร์ชันล่าสุด

• ดำเนินการสื่อกลางให้เสร็จสิ้น คู่มือเริ่มต้นใช้งาน

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

เข้าสู่ระบบบัญชี LINE Ads Network

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

คลิก 広告枠管理 (การจัดการช่องโฆษณา) > メディア (สื่อ) จากนั้นคลิก新規作成 (สร้างใหม่)

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

จดรหัสแอปพลิเคชันไว้

สร้างตําแหน่งโฆษณา

คลิกรหัสของแอปพลิเคชันที่ต้องการเพิ่มตําแหน่งโฆษณา จากนั้นเลือก詳細 (รายละเอียด)

คลิก スロット 追加 (เพิ่มช่อง)

กรอกแบบฟอร์ม เมื่อกรอกเสร็จแล้ว ให้คลิก (登録) ลงทะเบียน

หมายเหตุ: ติดต่อผู้จัดการฝ่ายดูแลลูกค้าของ LINE Ads Network เพื่อขอสิทธิ์เข้าถึงการสร้างตําแหน่งโฆษณาเนทีฟใน UI ของ LINE Ads Network

จดรหัสช่องไว้

ขั้นตอนที่ 2: ตั้งค่าดีมานด์ของเครือข่ายโฆษณา LINE ใน UI ของ Ad Manager

ลงชื่อเข้าใช้บัญชี Ad Manager

เพิ่มเครือข่ายโฆษณา LINE ในบริษัท

การเสนอราคา

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

น้ำตก

ไปที่ผู้ดูแลระบบ > บริษัท แล้วคลิกปุ่มบริษัทใหม่ในแท็บบริษัททั้งหมด เลือกเครือข่ายโฆษณา

เลือก LINE Ads Network เป็นเครือข่ายโฆษณา ป้อนชื่อที่ไม่ซ้ำกัน และเปิดใช้สื่อกลาง

คุณไม่จำเป็นต้องป้อนชื่อผู้ใช้หรือรหัสผ่าน คลิกบันทึกเมื่อเสร็จแล้ว

เปิดใช้การแชร์สัญญาณที่ปลอดภัย

การเสนอราคา

ไปที่ผู้ดูแลระบบ > การตั้งค่าส่วนกลาง ไปที่แท็บการตั้งค่าบัญชี Ad Exchange แล้วตรวจสอบและเปิดการแชร์สัญญาณที่ปลอดภัย คลิกบันทึก

น้ำตก

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

แชร์สัญญาณที่ปลอดภัยในคำขอราคาเสนอ

การเสนอราคา

ไปที่พื้นที่โฆษณา > สัญญาณที่ปลอดภัย ในส่วนสัญญาณที่ปลอดภัย ให้ค้นหา LINE แล้วเปิดเปิดใช้การผสานรวมแอป

คลิกบันทึก

น้ำตก

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

อนุญาตการแชร์สัญญาณที่ปลอดภัยสําหรับการเสนอราคา SDK

การเสนอราคา

ไปที่การแสดงโฆษณา > การตั้งค่าแชแนลดีมานด์ ในแท็บการตั้งค่าเริ่มต้น ให้เปิดอนุญาตการแชร์สัญญาณที่ปลอดภัยสําหรับSDK bidding

คลิกบันทึก

น้ำตก

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

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

การเสนอราคา

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

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

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

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

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

น้ำตก

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

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

การเสนอราคา

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

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

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

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

สำคัญ: กําหนดเป้าหมายหน่วยโฆษณาที่เลือกตามกลุ่มผลตอบแทนอย่างน้อย 1 กลุ่ม และรหัสแอปพลิเคชันต้องเชื่อมโยงกับแอปเป้าหมายตามที่แสดงใน UI ของเครือข่ายโฆษณา LINE

น้ำตก

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

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

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

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

สำคัญ: รหัสแอปพลิเคชันต้องเชื่อมโยงกับแอปเป้าหมายตามที่แสดงใน UI ของเครือข่ายโฆษณา LINE

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

หมายเหตุ: การผสานรวม LINE Ads Network กับ Google Mobile Ads SDK เวอร์ชันที่เข้ากันได้ไม่สำเร็จอาจทําให้เกิดปัญหาการสร้าง

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

ในไฟล์ build.gradle.kts ระดับแอป ให้เพิ่มข้อกําหนดในการนําไปใช้และการกำหนดค่าต่อไปนี้ ใช้ LINE Ads Network SDK และอะแดปเตอร์เวอร์ชันล่าสุด

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.6.0")
    implementation("com.google.ads.mediation:line:2.9.20250110.0")
}

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

1. ดาวน์โหลดไฟล์ .aar ของ LINE Ads Network SDK เวอร์ชันล่าสุด แล้วเพิ่มลงในโปรเจ็กต์

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

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

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

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

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

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

สำคัญ: ปิดใช้โหมดทดสอบสําหรับ Ad Manager และเครือข่ายโฆษณา LINE ก่อนเผยแพร่แอป

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

หากต้องการยืนยันว่าคุณได้รับโฆษณาทดสอบจากเครือข่ายโฆษณา 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
คำกระตุ้นการตัดสินใจ
การให้ดาว
ร้านค้า
ราคา

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

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

หากอะแดปเตอร์ไม่ได้รับโฆษณาจากเครือข่ายโฆษณา LINE คุณสามารถตรวจสอบข้อผิดพลาดพื้นฐานจากการตอบกลับโฆษณาได้โดยใช้ ResponseInfo.getAdapterResponses() ในส่วนคลาสต่อไปนี้

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

ต่อไปนี้คือรหัสและข้อความที่มาพร้อมกับข้อผิดพลาดที่เกิดจากอะแดปเตอร์เครือข่ายโฆษณา LINE เมื่อโหลดโฆษณาไม่สําเร็จ

รหัสข้อผิดพลาด	โดเมน	เหตุผล
1-10	com.five_corp.ad	SDK เครือข่ายโฆษณา LINE แสดงข้อผิดพลาดเฉพาะ SDK ดูรายละเอียดเพิ่มเติมในเอกสารประกอบของ LINE Ads Network
101	com.google.ads.mediation.line	ไม่มีรหัสแอปพลิเคชันหรือรหัสแอปพลิเคชันไม่ถูกต้อง
102	com.google.ads.mediation.line	รหัสช่องขาดหายไปหรือไม่ถูกต้อง
103	com.google.ads.mediation.line	ขนาดโฆษณาที่ขอไม่ตรงกับขนาดโฆษณาแบนเนอร์ที่ LINE Ads Network รองรับ
104	com.google.ads.mediation.line	โหลดโฆษณาคั่นระหว่างหน้าหรือโฆษณาที่มีการให้รางวัลไม่สำเร็จเนื่องจากไม่มีบริบทกิจกรรม
105	com.google.ads.mediation.line	SDK เครือข่ายโฆษณา LINE แสดงโฆษณาคั่นระหว่างหน้าหรือโฆษณาที่มีการให้รางวัลไม่สำเร็จ
106	com.google.ads.mediation.line	โหลดโฆษณาเนทีฟไม่สำเร็จเนื่องจากไม่มีชิ้นงาน

บันทึกการเปลี่ยนแปลงของ LINE Android Mediation Adapter

เวอร์ชันถัดไป

• อัปเดตให้ใช้บริบทแทนกิจกรรมในการโหลดโฆษณาทุกรูปแบบ
• แก้ไขวิธีตั้งค่าโหมดทดสอบใน LINE SDK

เวอร์ชัน 2.9.20250110.0

• นำคลาส UnifiedNativeAdMapper ที่เลิกใช้งานแล้วออกเพื่อใช้ NativeAdMapper แทน
• แก้ไขกระบวนการรวบรวมสัญญาณ
• แก้ไขกระบวนการเริ่มต้นใช้งานสำหรับโฆษณาคั่นระหว่างหน้า Waterfall และโฆษณาที่มีการให้รางวัล
• ยืนยันความเข้ากันได้กับ FiveAd SDK เวอร์ชัน 2.9.20250110.0

สร้างขึ้นและทดสอบด้วย

• Google Mobile Ads SDK เวอร์ชัน 23.6.0
• FiveAd SDK เวอร์ชัน 2.9.20250110.0

เวอร์ชัน 2.9.20241129.0

• เพิ่มการรองรับการเสนอราคาสําหรับโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า โฆษณาที่มีการให้รางวัล และโฆษณาเนทีฟ
• ยืนยันความเข้ากันได้กับ FiveAd SDK เวอร์ชัน 2.9.20241129.0

สร้างขึ้นและทดสอบด้วย

• Google Mobile Ads SDK เวอร์ชัน 23.5.0
• FiveAd SDK เวอร์ชัน 2.9.20241129.0

เวอร์ชัน 2.8.20240827.0

• เข้ากันได้กับ FiveAd SDK เวอร์ชัน 2.8.20240827.0 แล้ว

สร้างขึ้นและทดสอบด้วย

• Google Mobile Ads SDK เวอร์ชัน 23.3.0
• FiveAd SDK เวอร์ชัน 2.8.20240827.0

เวอร์ชัน 2.8.20240808.0

• เข้ากันได้กับ FiveAd SDK เวอร์ชัน 2.8.20240808.0 แล้ว

สร้างขึ้นและทดสอบด้วย

• Google Mobile Ads SDK เวอร์ชัน 23.2.0
• FiveAd SDK เวอร์ชัน 2.8.20240808.0

เวอร์ชัน 2.8.20240722.0

• เข้ากันได้กับ FiveAd SDK เวอร์ชัน 2.8.20240722.0 แล้ว

สร้างขึ้นและทดสอบด้วย

• Google Mobile Ads SDK เวอร์ชัน 23.2.0
• FiveAd SDK เวอร์ชัน 2.8.20240722.0

เวอร์ชัน 2.7.20240515.0

• ยืนยันความเข้ากันได้กับ FiveAd SDK เวอร์ชัน 2.7.20240515.0

สร้างขึ้นและทดสอบด้วย

• Google Mobile Ads SDK เวอร์ชัน 23.1.0
• FiveAd SDK เวอร์ชัน 2.7.20240515.0

เวอร์ชัน 2.7.20240214.1

• อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 23.0.0
• ยืนยันความเข้ากันได้กับ FiveAd SDK เวอร์ชัน 2.7.20240214.0

สร้างขึ้นและทดสอบด้วย

• Google Mobile Ads SDK เวอร์ชัน 23.0.0
• FiveAd SDK เวอร์ชัน 2.7.20240214.0

เวอร์ชัน 2.7.20240214.0

• ยืนยันความเข้ากันได้กับ FiveAd SDK เวอร์ชัน 2.7.20240214.0

สร้างขึ้นและทดสอบด้วย

• Google Mobile Ads SDK เวอร์ชัน 22.6.0
• FiveAd SDK เวอร์ชัน 2.7.20240214.0

เวอร์ชัน 2.7.20240126.0

• ยืนยันความเข้ากันได้กับ FiveAd SDK เวอร์ชัน 2.7.20240126.0

สร้างขึ้นและทดสอบด้วย

• Google Mobile Ads SDK เวอร์ชัน 22.6.0
• FiveAd SDK เวอร์ชัน 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
• FiveAd SDK เวอร์ชัน 2.7.20240112

เวอร์ชัน 2.6.20230607.1

• เพิ่มคลาส LineExtras ให้ผู้เผยแพร่โฆษณากําหนดการตั้งค่าเสียงเริ่มต้นสําหรับรูปแบบโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า และโฆษณาที่มีการให้รางวัล
• อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 22.4.0

สร้างขึ้นและทดสอบด้วย

• Google Mobile Ads SDK เวอร์ชัน 22.4.0
• FiveAd SDK เวอร์ชัน 2.6.20230607

เวอร์ชัน 2.6.20230607.0

• การเผยแพร่ครั้งแรก
• เพิ่มการรองรับรูปแบบโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า โฆษณาที่มีการให้รางวัล และโฆษณาเนทีฟ
• ยืนยันความเข้ากันได้กับ FiveAd SDK เวอร์ชัน 2.6.20230607

สร้างขึ้นและทดสอบด้วย

• Google Mobile Ads SDK เวอร์ชัน 22.1.0
• FiveAd SDK เวอร์ชัน 2.6.20230607