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

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

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

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

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

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

1 โฆษณาเนทีฟ (สำหรับการเสนอราคา) อยู่ในโปรแกรมเบต้าแบบปิด โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อ ขอสิทธิ์เข้าถึง

ข้อกำหนด

  • API ระดับ 23 ขึ้นไปของ Android

ขั้นตอนที่ 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 อยู่แล้ว คุณสามารถเลือกการแมปนั้นได้ หากไม่ ให้คลิกเพิ่มการแมป



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



น้ำตก


ในการ์ด Waterfall ในส่วนแหล่งที่มาของโฆษณา ให้เลือกเพิ่มแหล่งที่มาของโฆษณา

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



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

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


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

ในไฟล์ 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")
}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Java 

LineExtras lineExtras = new LineExtras(true);
Bundle extras = lineExtras.build();

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

Kotlin 

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

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

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

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

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