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

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

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

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

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

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

• Android API ระดับ 24 ขึ้นไป

• Google Mobile Ads SDK (Legacy) เวอร์ชันล่าสุด

• ตั้งค่าสื่อกลาง

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

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

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

ไปที่แท็บ App แล้วคลิกปุ่ม New registration

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

จดรหัสแอป

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

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

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

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

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

สร้างคีย์ Reporting 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 Ads ใน UI ของ Ad Manager

ลงชื่อเข้าใช้บัญชี Ad Manager

เพิ่ม LY Ads Network ในบริษัท

เปิดใช้การแชร์สัญญาณที่ปลอดภัย

แชร์สัญญาณที่ปลอดภัยในคำขอราคาเสนอ

อนุญาตการแชร์สัญญาณที่ปลอดภัยสำหรับการเสนอราคา SDK

กำหนดค่าการเสนอราคาเครือข่ายโฆษณา LY

กำหนดค่าการแมปหน่วยโฆษณา

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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 จะป้อนข้อมูลในช่องต่อไปนี้สำหรับ NativeAd

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

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

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

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

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

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

เวอร์ชัน 3.1.1.2

• ปักหมุดการอ้างอิง Kotlin ของอแดปเตอร์เป็น 1.9.0 (เวอร์ชัน Kotlin ขั้นต่ำที่ GMA NextGen SDK รองรับ)

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

• Google Mobile Ads SDK เวอร์ชัน 25.4.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.4.0
• FiveAd SDK เวอร์ชัน 3.1.1.1

เวอร์ชัน 3.1.1.1

• แมป AgeRestrictedTreatment กับ ChildDirectedTreatment API ของ Line

สร้างขึ้นและทดสอบกับ

• Google Mobile Ads SDK เวอร์ชัน 25.4.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.2.1
• FiveAd SDK เวอร์ชัน 3.1.1.1

เวอร์ชัน 3.1.1.0

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

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

• Google Mobile Ads SDK เวอร์ชัน 25.2.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.2.1
• FiveAd SDK เวอร์ชัน 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
• FiveAd SDK เวอร์ชัน 3.0.1.2

เวอร์ชัน 3.0.1.1

• ตอนนี้ FiveAd SDK จะเขียนทับการแสดงโฆษณาเนทีฟเมื่อใช้ Google Mobile Ads SDK 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
• FiveAd SDK เวอร์ชัน 3.0.1.0

เวอร์ชัน 3.0.0.0

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

สร้างขึ้นและทดสอบกับ

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

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

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

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

เวอร์ชัน 2.7.20240214.0

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

สร้างขึ้นและทดสอบกับ

• Google Mobile Ads SDK เวอร์ชัน 22.6.0
• FiveAd SDK เวอร์ชัน 2.7.20240214.0

เวอร์ชัน 2.7.20240126.0

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

สร้างขึ้นและทดสอบกับ

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