ผสานรวม LY Ads Network กับสื่อกลาง

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

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

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

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

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

ข้อกำหนด

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

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

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

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

ไปที่แท็บแอป แล้วคลิกปุ่ม New registration (การจดทะเบียนใหม่)

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

กรอกแบบฟอร์ม แล้วคลิกการจดทะเบียน

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

จดบันทึกรหัสแอป

Android

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

iOS

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

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

ในแท็บแอป ให้เลือกแอปเพื่อดูรายละเอียดของแอป ในส่วนช่อง ให้คลิกเพิ่ม

เพิ่มช่อง

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

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

จดบันทึกรหัสช่อง

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

หลังจากสร้างช่องแรกแล้ว ให้คลิกตรวจทาน ในหน้ารายละเอียดของแอปเพื่อขออนุมัติจาก LY Ads Network ซึ่งอาจใช้เวลาสักครู่ โปรดติดต่อตัวแทนของ LY Ads Network หากมีข้อสงสัย

ขอรับการตรวจสอบ

สร้างคีย์ API สำหรับการรายงาน

ไปที่แท็บ Managing reporting API keys (การจัดการคีย์ API สำหรับการรายงาน) แล้วคลิกปุ่ม Create API key (สร้างคีย์ API)

แท็บคีย์ Reporting API

กรอกแบบฟอร์ม แล้วคลิกบันทึก

แบบฟอร์มคีย์ Reporting API

จดบันทึกรหัสคีย์ API และข้อมูลลับของคีย์ API

แบบฟอร์มคีย์ Reporting API

อัปเดต app-ads.txt

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

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

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

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

Android

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

iOS

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

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

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

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

dependencies:
  gma_mediation_line: ^2.1.0

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

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

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

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

Android

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

iOS

การผสานรวม SKAdNetwork

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

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

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

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

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

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

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

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

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

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

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

LineMediationExtras lineExtras = LineMediationExtras(enableAdSound: true)

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

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

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

Android

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

iOS

GADMediationAdapterLine

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

Android

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

iOS

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

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

เวอร์ชัน 2.1.1 (อยู่ระหว่างดำเนินการ)

เวอร์ชัน 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