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

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

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

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

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

ข้อกำหนด

• เป้าหมายการติดตั้งใช้งาน iOS 13.3 ขึ้นไป

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

• ล่าสุดจาก 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 สำหรับ Ad Manager

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

ขั้นตอนที่ 2: ตั้งค่าดีมานด์เครือข่ายโฆษณา LY ใน UI ของ Ad Manager

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

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

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

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

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

กำหนดค่าการเสนอราคา LY Ads Network

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

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

ใช้ Swift Package Manager

คุณต้องมีอะแดปเตอร์เวอร์ชันขั้นต่ำที่รองรับ 2.9.20251119 ก่อนจึงจะดำเนินการต่อได้

หากต้องการเพิ่มทรัพยากร Dependency ของแพ็กเกจ ในโปรเจ็กต์ ให้ทำตามขั้นตอนต่อไปนี้

1. ใน Xcode ให้ไปที่ไฟล์ > เพิ่มการขึ้นต่อกันของแพ็กเกจ...

2. ในข้อความแจ้งที่ปรากฏขึ้น ให้ค้นหา URL ของแพ็กเกจต่อไปนี้

   https://github.com/googleads/googleads-mobile-ios-mediation-line.git
   

3. ในกฎการขึ้นต่อกัน ให้เลือกสาขา

4. ป้อน main ในช่องข้อความ

ใช้ CocoaPods

เพิ่มบรรทัดต่อไปนี้ลงใน Podfile ของโปรเจ็กต์

pod 'GoogleMobileAdsMediationLine'

จากบรรทัดคำสั่ง ให้เรียกใช้คำสั่งต่อไปนี้

pod install --repo-update

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

• ดาวน์โหลด SDK ของเครือข่ายโฆษณา LY เวอร์ชันล่าสุดและลิงก์ FiveAd.framework ในโปรเจ็กต์
• ดาวน์โหลดอะแดปเตอร์ LY Ads Network เวอร์ชันล่าสุดจากลิงก์ดาวน์โหลด ในบันทึกการเปลี่ยนแปลงและลิงก์ LineAdapter.framework ในโปรเจ็กต์

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

ติดตั้งใช้งาน SKAdNetwork

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

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

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

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

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

import LineAdapter
// ...

GADMediationAdapterLine.testMode = true

#import <LineAdapter/LineAdapter.h>
// ...

GADMediationAdapterLine.testMode = YES;

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

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

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

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

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

adAudio

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

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

import LineAdapter
// ...

let request = GAMRequest()
let extras = GADMediationAdapterLineExtras()
extras.adAudio = GADMediationAdapterLineAdAudio.unmuted
// ...
request.register(extras)

#import <LineAdapter/LineAdapter.h>
// ...

GAMRequest *request = [GAMRequest request];
GADMediationAdapterLineExtras *extras = [[GADMediationAdapterLineExtras alloc] init];
extras.adAudio = GADMediationAdapterLineAdAudioUnmuted;
// ...
[request registerAdNetworkExtras:extras];

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

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

อะแดปเตอร์ LY Ads Network จะสร้างฟิลด์ต่อไปนี้ สำหรับ GADNativeAd

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

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

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

GADMediationAdapterLine

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

บันทึกการเปลี่ยนแปลงของตัวกลาง LINE iOS

เวอร์ชัน 3.0.1.2

• อัปเดตเวอร์ชัน iOS ขั้นต่ำเพื่อลดการพึ่งพา SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่ออนุญาตเวอร์ชันย่อย
• แก้ไขปัญหาที่ไอคอนตัวเลือกโฆษณาอื่นๆ สำหรับโฆษณาเนทีฟมีขนาดใหญ่เกินไป

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

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

เวอร์ชัน 3.0.1.1

• ตอนนี้อะแดปเตอร์จะส่งต่อageRestrictedTreatmentแฟล็ก Google Mobile Ads SDK ไปยัง API ของ COPPA ของ FiveAd SDK

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

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

เวอร์ชัน 3.0.1.0

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

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

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

เวอร์ชัน 3.0.0.1

• อัปเดตทรัพยากร Dependency ของ Google Mobile Ads SDK เป็นเวอร์ชัน 13.0.0

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

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

เวอร์ชัน 3.0.0.0

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

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

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

เวอร์ชัน 2.9.20251119.1

• เพิ่มการรองรับการส่งต่อพารามิเตอร์ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google สำหรับแท็ก tagForUnderAgeOfConsent ไปยัง SDK ของ FiveAd

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

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

เวอร์ชัน 2.9.20251119.0

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

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

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

เวอร์ชัน 2.9.20250930.0

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

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

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

เวอร์ชัน 2.9.20250912.0

• ตอนนี้อะแดปเตอร์จะเริ่มต้น SDK ของ FiveAd ก่อนคำขอโฆษณาแต่ละรายการ
• ยืนยันความเข้ากันได้กับ FiveAd SDK เวอร์ชัน 2.9.20250912

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

• Google Mobile Ads SDK เวอร์ชัน 12.11.0
• FiveAd SDK เวอร์ชัน 2.9.20250912

เวอร์ชัน 2.9.20250512.0

• ตอนนี้ต้องใช้ iOS เวอร์ชัน 13.0 เป็นอย่างน้อย
• ได้รับการยืนยันว่าใช้งานร่วมกับ FiveAd SDK เวอร์ชัน 2.9.20250512 ได้

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

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

เวอร์ชัน 2.9.20241106.3

• แก้ไขปัญหาที่ GADMediationAdapterLine.h ไม่ใช่ส่วนหัวสาธารณะ
• เปิดใช้ฟีเจอร์ทดลอง -fobjc-arc และ -fstack-protector-all
• นำการยืนยันขนาดแบนเนอร์สำหรับการเสนอราคาออกหลังจากโหลดสำเร็จ
  • โฆษณาแบนเนอร์แบบน้ำตกจะตรวจสอบขนาดโฆษณาแบนเนอร์ต่อไปเมื่อโหลดสำเร็จ

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

• Google Mobile Ads SDK เวอร์ชัน 12.2.0
• FiveAd SDK เวอร์ชัน 2.9.20241106

เวอร์ชัน 2.9.20241106.2

• เพิ่มพร็อพเพอร์ตี้ GADMediationAdapterLine.testMode เพื่อระบุว่าควรเริ่มต้น SDK ของ FiveAd ในโหมดทดสอบหรือไม่ ต้องตั้งค่า Flag นี้ก่อนเริ่มต้นใช้งาน Google Mobile Ads SDK
• นำการตรวจสอบสถานะการเริ่มต้น SDK ของ FiveAd ออกก่อนเริ่มต้น SDK ของ FiveAd
• นำการตรวจสอบสถานะโฆษณาเนทีฟที่เลิกใช้งานแล้วออกก่อนดาวน์โหลดชิ้นงานโฆษณาเนทีฟ
• ตอนนี้ต้องใช้ Google Mobile Ads SDK เวอร์ชัน 12.0.0 ขึ้นไป

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

• Google Mobile Ads SDK เวอร์ชัน 12.0.0
• FiveAd SDK เวอร์ชัน 2.9.20241106

เวอร์ชัน 2.9.20241106.1

• อัปเดตอแดปเตอร์เพื่อใช้ API จำนวนโฆษณาล่าสุดสําหรับโฆษณาแบนเนอร์ที่เสนอราคา
• แก้ไขปัญหาที่ทำให้ส่งต่อเหตุการณ์โฆษณาอย่างไม่ถูกต้องสำหรับโฆษณาคั่นระหว่างหน้าที่เสนอราคา

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

• Google Mobile Ads SDK เวอร์ชัน 11.12.0
• FiveAd SDK เวอร์ชัน 2.9.20241106

เวอร์ชัน 2.9.20241106.0

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

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

• Google Mobile Ads SDK เวอร์ชัน 11.12.0
• FiveAd SDK เวอร์ชัน 2.9.20241106

เวอร์ชัน 2.8.20240827.1

• อัปเดต CFBundleShortVersionString ให้มี 3 คอมโพเนนต์แทน 4 คอมโพเนนต์

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

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

เวอร์ชัน 2.8.20240827.0

• ได้รับการยืนยันว่าใช้งานร่วมกับ FiveAd SDK เวอร์ชัน 2.8.20240827 ได้
• เพิ่มการรองรับการเสนอราคาสำหรับรูปแบบโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า โฆษณาที่มีการให้รางวัล และโฆษณาเนทีฟ

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

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

เวอร์ชัน 2.8.20240612.0

• เพิ่มการควบคุมเสียงสำหรับโฆษณาเนทีฟผ่าน GADVideoOptions
• ได้รับการยืนยันว่าใช้งานร่วมกับ FiveAd SDK เวอร์ชัน 2.8.20240612 ได้

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

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

เวอร์ชัน 2.7.20240411.0

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

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

• Google Mobile Ads SDK เวอร์ชัน 11.3.0
• FiveAd SDK เวอร์ชัน 2.7.20240411

เวอร์ชัน 2.7.20240318.0

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

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

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

เวอร์ชัน 2.7.20240214.1

• ตอนนี้ต้องใช้ iOS เวอร์ชัน 12.0 เป็นอย่างน้อย
• ตอนนี้ต้องใช้ Google Mobile Ads SDK เวอร์ชัน 11.0 ขึ้นไป
• รวม Info.plist ไว้ในเฟรมเวิร์กภายใน LineAdapter.xcframework

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

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

เวอร์ชัน 2.7.20240214.0

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

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

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

เวอร์ชัน 2.7.20240126.0

• ได้รับการยืนยันว่าใช้งานร่วมกับ FiveAd SDK เวอร์ชัน 2.7.20240126 ได้
• อัปเดตการติดตั้งใช้งานอแดปเตอร์ด้วยโปรโตคอลผู้มอบสิทธิ์ใหม่ของ FiveAd SDK

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

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

เวอร์ชัน 2.7.20231115.0

• ยืนยันความเข้ากันได้กับ FiveAd SDK เวอร์ชัน 2.7.20231115
• รวมส่วนหัว GADMediationAdapterLineExtras ไว้ใน modulemap

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

• Google Mobile Ads SDK เวอร์ชัน 10.14.0
• FiveAd SDK เวอร์ชัน 2.7.20231115

เวอร์ชัน 2.6.20230609.1

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

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

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

เวอร์ชัน 2.6.20230609.0

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

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

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