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

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

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

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

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

ข้อกำหนด

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

• ล่าสุดจาก Google Mobile Ads SDK

• ทําตามคู่มือเริ่มต้นใช้งานสื่อกลางให้เสร็จสมบูรณ์

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

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

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

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

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

จดรหัสแอปไว้

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

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

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

จดรหัสช่อง

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

สร้างคีย์ API การรายงาน

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

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

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

อัปเดต app-ads.txt

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

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

ขั้นตอนที่ 2: ตั้งค่าดีมานด์เครือข่าย LY Ads ใน UI ของ AdMob

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

คุณต้องเพิ่ม LY Ads Network ลงในการกำหนดค่าสื่อกลางสำหรับหน่วยโฆษณา

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

หากต้องการสร้างกลุ่มสื่อกลางใหม่ ให้เลือกสร้างกลุ่มสื่อกลาง

ป้อนรูปแบบโฆษณาและแพลตฟอร์ม แล้วคลิกต่อไป

ตั้งชื่อกลุ่มสื่อกลาง แล้วเลือกสถานที่ตั้งที่จะกำหนดเป้าหมาย จากนั้นตั้งค่าสถานะกลุ่มสื่อกลางเป็นเปิดใช้ แล้วคลิกเพิ่มหน่วยโฆษณา

เชื่อมโยงกลุ่มสื่อกลางนี้กับหน่วยโฆษณา AdMob ที่มีอยู่ อย่างน้อย 1 หน่วย จากนั้นคลิกเสร็จสิ้น

ตอนนี้คุณควรเห็นการ์ดหน่วยโฆษณาที่แสดงหน่วยโฆษณาที่คุณเลือก

เพิ่ม LY Ads Network เป็นแหล่งที่มาของโฆษณา

การเสนอราคา

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

คลิกวิธีลงนามในข้อตกลงสำหรับพาร์ทเนอร์และ ตั้งค่าการเป็นพาร์ทเนอร์การเสนอราคากับ เครือข่ายโฆษณา LY



คลิกรับทราบและยอมรับ แล้วคลิกต่อไป



หากมีการแมปสำหรับ LY Ads Network อยู่แล้ว คุณก็เลือกการแมปนั้นได้ หากไม่ ให้คลิกเพิ่มการแมป



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

น้ำตก

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

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




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



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

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

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

ในไฟล์ Gradle ระดับแอป ให้เพิ่มทรัพยากร Dependency ในการติดตั้งใช้งานต่อไปนี้

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

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.4.0'
    implementation 'com.google.ads.mediation:line:3.1.0.0'
}

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

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

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

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

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

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

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

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

อะแดปเตอร์ LY Ads Network มีเมธอดตัวช่วยในการเปิดใช้โหมดทดสอบสำหรับ LY Ads Network คุณต้องตั้งค่าตัวเลือกนี้ก่อนที่จะเริ่มต้นGoogle Mobile Ads SDK เพื่อให้แน่ใจว่าระบบจะส่งต่อตัวเลือกอย่างถูกต้องไปยัง LY Ads Network SDK

LineMediationAdapter.Companion.setTestMode(true);
LineMediationSnippets.java

LineMediationAdapter.setTestMode(true)
LineMediationSnippets.kt

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

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

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

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

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

enableAdSound

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

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

LineExtras lineExtras = new LineExtras(/* enableAdSound: */ true);
Bundle extras = lineExtras.build();

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

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

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

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

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

อแดปเตอร์ LY Ads Network จะป้อนข้อมูลต่อไปนี้ คำอธิบายช่องขั้นสูงของโฆษณาเนทีฟ สำหรับ NativeAd

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

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

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

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

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

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

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

• แมป AgeRestrictedTreatment ไปยัง ChildDirectedTreatment API ของ LINE

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

เวอร์ชัน 3.1.0.0

• เพิ่มพร็อพเพอร์ตี้เพื่อสร้างอะแดปเตอร์ที่มีทรัพยากร Dependency ของ GMA Next-Gen SDK
• ได้รับการยืนยันว่าใช้งานร่วมกับ FiveAd SDK เวอร์ชัน 3.1.0.0 ได้

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

• Google Mobile Ads SDK เวอร์ชัน 25.1.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 0.25.0-beta01
• FiveAd SDK เวอร์ชัน 3.1.0.0

เวอร์ชัน 3.0.1.2

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

• Google Mobile Ads SDK เวอร์ชัน 25.1.0
• SDK ของ FiveAd เวอร์ชัน 3.0.1.2

เวอร์ชัน 3.0.1.1

• ตอนนี้ SDK ของ FiveAd จะเขียนทับการแสดงผลโฆษณาเนทีฟเมื่อใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google v24.4.0 ขึ้นไป

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

• Google Mobile Ads SDK เวอร์ชัน 24.9.0
• SDK ของ FiveAd เวอร์ชัน 3.0.1.1

เวอร์ชัน 3.0.1.0

• เพิ่มการรองรับการส่งต่อพารามิเตอร์ tagForUnderAgeOfConsent ของ Google Mobile Ads SDK ไปยัง FiveAd SDK
• ได้รับการยืนยันว่าใช้งานร่วมกับ FiveAd SDK เวอร์ชัน 3.0.1.0 ได้

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

• Google Mobile Ads SDK เวอร์ชัน 24.9.0
• SDK เวอร์ชัน 3.0.1.0 ของ FiveAd

เวอร์ชัน 3.0.0.0

• ได้รับการยืนยันว่าใช้งานร่วมกับ FiveAd SDK เวอร์ชัน 3.0.0.0 ได้

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

• Google Mobile Ads SDK เวอร์ชัน 24.9.0
• SDK ของ FiveAd เวอร์ชัน 3.0.0.0

เวอร์ชัน 2.9.20251028.0

• ได้รับการยืนยันว่าใช้งานร่วมกับ FiveAd SDK เวอร์ชัน 2.9.20251028 ได้

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

• Google Mobile Ads SDK เวอร์ชัน 24.7.0
• FiveAd SDK เวอร์ชัน 2.9.20251028.0

เวอร์ชัน 2.9.20250924.1

• นำการอ้างอิงบริบทระดับชั้นเรียนออกแล้ว ช่วยลดปัญหาหน่วยความจำรั่วไหลได้

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

• Google Mobile Ads SDK เวอร์ชัน 24.7.0
• SDK ของ FiveAd เวอร์ชัน 2.9.20250924.1

เวอร์ชัน 2.9.20250924.0

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

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

• Google Mobile Ads SDK เวอร์ชัน 24.6.0
• FiveAd SDK เวอร์ชัน 2.9.20250924.0

เวอร์ชัน 2.9.20250718.0

• ได้รับการยืนยันว่าใช้งานร่วมกับ FiveAd SDK เวอร์ชัน 2.9.20250718 ได้

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

• Google Mobile Ads SDK เวอร์ชัน 24.3.0
• FiveAd SDK เวอร์ชัน 2.9.20250718.0

เวอร์ชัน 2.9.20250519.0

• ได้รับการยืนยันว่าใช้งานร่วมกับ FiveAd SDK เวอร์ชัน 2.9.20250519 ได้

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

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

เวอร์ชัน 2.8.20240808.0

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

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

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

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