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

เลือกแพลตฟอร์ม: Android ใหม่ Android iOS Unity Flutter

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

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

อะแดปเตอร์สื่อกลางของ Ad Manager สำหรับ LINE Ads Network มีความสามารถดังนี้

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

ข้อกำหนด

  • ล่าสุด Google Mobile Ads Flutter Plugin
  • Flutter 3.7.0 ขึ้นไป
  • หากต้องการทำให้ใช้งานได้ใน Android
    • Android API ระดับ 23 ขึ้นไป
  • หากต้องการทำให้ใช้งานได้ใน iOS
    • เป้าหมายการทำให้ใช้งานได้ของ iOS คือ 13.0 ขึ้นไป
  • โปรเจ็กต์ Flutter ที่ใช้งานได้ซึ่งกำหนดค่าด้วย Google Mobile Ads Flutter Plugin ดูรายละเอียดได้ที่ ตั้งค่า Google Mobile Ads Flutter Plugin
  • ตั้งค่าสื่อกลาง

ขั้นตอนที่ 1: ตั้งค่าการกำหนดค่าใน UI ของ LINE Ads Network

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

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

ไปที่แท็บ アプリ (App) แล้วคลิกปุ่ม 新規登録 (New Registration)

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

กรอกแบบฟอร์มแล้วคลิก 登録 (Register)

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

จดบันทึกรหัสแอป (App ID)

Android

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

iOS

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

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

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

เพิ่มช่อง

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

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

จดบันทึกรหัสช่องโฆษณา (Slot ID)

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

อัปเดต app-ads.txt

ผู้ขายที่ได้รับอนุญาตสำหรับแอป app-ads.txt เป็นความคิดริเริ่มของ IAB Tech Lab ที่ช่วยตรวจสอบว่าคุณจะขายพื้นที่โฆษณาแอปผ่านช่องทางที่คุณระบุว่าได้รับอนุญาตเท่านั้น คุณจะต้องใช้ไฟล์ app-ads.txt เพื่อป้องกันไม่ให้เสียรายได้จากโฆษณาเป็นจำนวนมาก หากยังไม่ได้สร้างไฟล์ app-ads.txt สำหรับ Ad Manager ให้สร้างเลย

หากต้องการใช้ app-ads.txt สำหรับ LINE Ads Network โปรดดู ข้อมูลเกี่ยวกับ app-ads.txt

ขั้นตอนที่ 2: ตั้งค่าดีมานด์จาก LINE Ads Network ใน UI ของ Ad Manager

กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา

Android

ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสำหรับ Android

iOS

ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสำหรับ iOS

ขั้นตอนที่ 3: นำเข้า LINE Ads Network SDK และอะแดปเตอร์

การผสานรวมผ่าน pub.dev

เพิ่มทรัพยากร Dependency ต่อไปนี้ด้วย LINE Ads Network SDK และอะแดปเตอร์เวอร์ชันล่าสุดในไฟล์ pubspec.yaml ของแพ็กเกจ

dependencies:
  gma_mediation_line: ^2.1.0

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

ดาวน์โหลดปลั๊กอินสื่อกลาง Google Mobile Ads สำหรับ LINE Ads Networkเวอร์ชันล่าสุด แตกไฟล์ที่ดาวน์โหลดมา แล้วเพิ่มโฟลเดอร์ปลั๊กอินที่แตกออกมา (และเนื้อหาของโฟลเดอร์) ลงในโปรเจ็กต์ Flutter จากนั้นอ้างอิงปลั๊กอินในไฟล์ pubspec.yaml โดยเพิ่มทรัพยากร Dependency ต่อไปนี้

dependencies:
  gma_mediation_line:
    path: path/to/local/package

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

Android

ไม่จำเป็นต้องใช้โค้ดเพิ่มเติมสำหรับการผสานรวม LINE Ads Network

iOS

การผสานรวม SKAdNetwork

ทำตามเอกสารประกอบของ LINE Ads Network เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist ของโปรเจ็กต์

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

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

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

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

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

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

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

ปลั๊กอินสื่อกลาง Flutter ของ LINE Ads Network รองรับพารามิเตอร์คำขอเพิ่มเติมต่อไปนี้ ซึ่งส่งไปยังอะแดปเตอร์ผ่านคลาส LineMediationExtras ได้

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

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

LineMediationExtras lineExtras = LineMediationExtras(enableAdSound: true)

AdRequest request = AdRequest(
    keywords: <String>['foo', 'bar'],
    contentUrl: 'http://foo.com/bar.html',
    mediationExtras: [lineExtras],
);

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

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

Android

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

iOS

GADMediationAdapterLine

ต่อไปนี้เป็นรหัสและข้อความที่อะแดปเตอร์ LINE Ads Network แสดงขึ้นเมื่อโหลดโฆษณาไม่สำเร็จ

Android

รหัสข้อผิดพลาด โดเมน เหตุผล
1-10 com.five_corp.ad LINE Ads Network SDK แสดงข้อผิดพลาดเฉพาะของ 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 LINE Ads Network SDK แสดงโฆษณาคั่นระหว่างหน้าหรือโฆษณาที่มีการให้รางวัลไม่สำเร็จ
106 com.google.ads.mediation.line โหลดโฆษณาเนทีฟไม่สำเร็จเนื่องจากไม่มีชิ้นงาน

iOS

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

บันทึกการเปลี่ยนแปลงของอะแดปเตอร์สื่อกลาง Flutter ของ Line

เวอร์ชัน 2.1.0

เวอร์ชัน 2.0.0

เวอร์ชัน 1.0.6

เวอร์ชัน 1.0.5

เวอร์ชัน 1.0.4

เวอร์ชัน 1.0.3

เวอร์ชัน 1.0.2

เวอร์ชัน 1.0.1

เวอร์ชัน 1.0.0