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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ใช้ Swift Package Manager

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

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

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

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

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

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

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

ใช้ CocoaPods

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

pod 'GoogleMobileAdsMediationLine'

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

pod install --repo-update

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

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

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

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

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

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

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

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

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

import LineAdapter
// ...

GADMediationAdapterLine.testMode = true

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

GADMediationAdapterLine.testMode = YES;

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

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

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

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

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

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

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

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

GADMediationAdapterLine

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

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

เวอร์ชัน 3.1.1.0

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

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

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

เวอร์ชัน 3.1.0.0

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

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

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

เวอร์ชัน 3.0.1.2

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

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

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

เวอร์ชัน 3.0.1.1

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

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

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

เวอร์ชัน 3.0.1.0

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

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

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

เวอร์ชัน 3.0.0.1

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

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

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

เวอร์ชัน 3.0.0.0

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

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

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

เวอร์ชัน 2.9.20251119.1

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

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

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

เวอร์ชัน 2.9.20251119.0

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

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

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

เวอร์ชัน 2.9.20250930.0

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

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

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

เวอร์ชัน 2.9.20250912.0

• ตอนนี้อะแดปเตอร์จะเริ่มต้น FiveAd SDK ก่อนคำขอโฆษณาแต่ละรายการ
• ยืนยันความเข้ากันได้กับ 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
• FiveAd SDK เวอร์ชัน 2.9.20250512

เวอร์ชัน 2.9.20241106.3

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

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

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

เวอร์ชัน 2.9.20241106.2

• เพิ่มพร็อพเพอร์ตี้ GADMediationAdapterLine.testMode เพื่อระบุว่าควรเริ่มต้น FiveAd SDK ในโหมดทดสอบหรือไม่ คุณต้องตั้งค่า Flag นี้ก่อนเริ่มต้นใช้งาน Google Mobile Ads SDK
• นําการตรวจสอบสถานะการเริ่มต้น FiveAd SDK ออกก่อนที่จะเริ่มต้น FiveAd SDK
• นำการตรวจสอบสถานะโฆษณาเนทีฟที่เลิกใช้งานแล้วออกก่อนที่จะดาวน์โหลดชิ้นงานโฆษณาเนทีฟ
• ตอนนี้ต้องใช้ 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
• FiveAd SDK เวอร์ชัน 2.8.20240827

เวอร์ชัน 2.8.20240827.0

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

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

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

เวอร์ชัน 2.8.20240612.0

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

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

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

เวอร์ชัน 2.7.20240214.0

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

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

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

เวอร์ชัน 2.6.20230609.0

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

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

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