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

เลือกแพลตฟอร์ม: Android iOS Unity Flutter Android (เดิม)

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

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

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

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

ข้อกำหนดเบื้องต้น

ก่อนดำเนินการต่อ ให้ตรวจสอบสิ่งต่อไปนี้

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

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

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

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

    ไปที่แท็บแอป แล้วคลิกปุ่มการลงทะเบียนใหม่

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

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

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

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

    Android

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

    iOS

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

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

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

    เพิ่มช่อง

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

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

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

    รายละเอียดช่องโฆษณา

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

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

    สร้างคีย์ Reporting API

    ไปที่แท็บการจัดการคีย์ API การรายงาน แล้วคลิกปุ่มสร้างคีย์ API

    แท็บคีย์ API การรายงาน

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

    แบบฟอร์มคีย์ API สำหรับการรายงาน

    จดรหัสคีย์ API และรหัสลับคีย์ API ไว้

    แบบฟอร์มคีย์ 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 ใน UI ของ Ad Manager

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

    Android

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

    iOS

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

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

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

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

    dependencies:
  gma_mediation_line: ^2.2.1

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

    ดาวน์โหลดปลั๊กอินสื่อกลาง 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 ผู้เผยแพร่โฆษณาสามารถตรวจสอบข้อผิดพลาดที่เกี่ยวข้องจากการตอบกลับโฆษณาโดยใช้ ResponseInfo ในคลาสต่อไปนี้

    Android

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

    iOS

    GADMediationAdapterLine

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

    Android

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

    iOS

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

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

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

    • ตอนนี้ต้องใช้ iOS เวอร์ชัน 15.0 ขึ้นไป

    เวอร์ชัน 2.2.1

    เวอร์ชัน 2.2.0

    เวอร์ชัน 2.1.3

    เวอร์ชัน 2.1.2

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