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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

จดรหัสแอป

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

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

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

จดรหัสช่อง

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

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

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

ใช้ 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

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

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

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

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

ทําตามเอกสารประกอบของ LY Ads Network เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist ของโปรเจ็กต์

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

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

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

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

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

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

GADMediationAdapterLine

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

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

เวอร์ชัน 3.1.1.0

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

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

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

เวอร์ชัน 3.1.0.0

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

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

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

เวอร์ชัน 3.0.1.2

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

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

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

เวอร์ชัน 3.0.1.1

• ตอนนี้อแดปเตอร์จะส่งต่อageRestrictedTreatmentแฟล็ก Google Mobile Ads SDK ไปยัง COPPA API ของ 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

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

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

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

เวอร์ชัน 2.9.20251119.1

• เพิ่มการรองรับการส่งต่อพารามิเตอร์ tagForUnderAgeOfConsent ของ Google Mobile Ads SDK ไปยัง FiveAd SDK

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

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

เวอร์ชัน 2.9.20241106.2

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

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

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

เวอร์ชัน 2.9.20241106.1

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

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

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

เวอร์ชัน 2.9.20241106.0

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

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

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

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

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

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