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

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

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

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

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

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

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

• [สำหรับการเสนอราคา]: หากต้องการผสานรวมรูปแบบโฆษณาที่รองรับทั้งหมดในการเสนอราคา ให้ใช้ อแดปเตอร์เครือข่ายโฆษณา LY Ads 2.9.20241129.0 ขึ้นไป (แนะนำให้ใช้เวอร์ชันล่าสุด)

• GMA Next-Gen SDK เวอร์ชันล่าสุด

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

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

ลงชื่อสมัครใช้และเข้าสู่ระบบบัญชี 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 ใน UI ของ Ad Manager

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

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

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

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

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

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

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

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

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

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

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
    implementation("com.google.ads.mediation:line:3.1.1.2")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0'
    implementation 'com.google.ads.mediation:line:3.1.1.2'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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

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

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

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

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

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

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

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

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

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

LineMediationAdapter.setTestMode(true)
LineMediationSnippets.kt

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

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

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

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

อะแดปเตอร์ 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.getAdSourceResponses() ในคลาสต่อไปนี้

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

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

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

เวอร์ชัน 3.1.1.2

• ปักหมุดทรัพยากร Dependency ของ 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
• SDK ของ FiveAd เวอร์ชัน 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
• ได้รับการยืนยันว่าใช้งานร่วมกับ SDK ของ FiveAd เวอร์ชัน 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

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

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

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