ผสานรวมเครือข่ายโฆษณา LINE เข้ากับสื่อกลาง

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

อินเทอร์เฟซแดชบอร์ดสำหรับเครือข่ายโฆษณา LINE ใช้ข้อความภาษาญี่ปุ่นสำหรับป้ายกำกับ ปุ่ม และคำอธิบาย ภาพหน้าจอในคู่มือนี้ยังไม่ได้ แปล อย่างไรก็ตาม ในคำอธิบายและวิธีการของคู่มือนี้ ป้ายกำกับและปุ่มจะได้รับการแปลโดยมีคำภาษาอังกฤษที่เทียบเท่าอยู่ในวงเล็บ

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

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

¹ โฆษณาเนทีฟ (สำหรับการเสนอราคา) อยู่ในโปรแกรมเบต้าแบบปิด โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อ ขอสิทธิ์เข้าถึง

ข้อกำหนด

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

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

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

• ทําตามคู่มือเริ่มต้นใช้งานสื่อกลางให้เสร็จสมบูรณ์

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

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

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

คลิก 広告枠管理 (Ad Slot Management) > メディア (Media) จากนั้นคลิก新規作成 (สร้างใหม่)

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

จดรหัสแอปพลิเคชัน

สร้างตำแหน่งโฆษณา

คลิกรหัสของแอปพลิเคชันที่ต้องการเพิ่มตําแหน่งโฆษณา จากนั้น เลือก詳細 (รายละเอียด)

คลิก スロット 追加 (เพิ่มสล็อต)

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

จดรหัสช่อง

อัปเดต app-ads.txt

ผู้ขายที่ได้รับอนุญาตสำหรับแอป app-ads.txt เป็นความคิดริเริ่มของ IAB Tech Lab ที่ช่วยตรวจสอบว่าคุณจะขาย พื้นที่โฆษณาในแอปผ่านช่องทางที่คุณได้รับอนุญาตเท่านั้น คุณจะต้องใช้ไฟล์ app-ads.txt เพื่อป้องกันไม่ให้เสียรายได้จากโฆษณาเป็นจำนวนมาก หากยังไม่ได้ดำเนินการ ให้สร้างไฟล์ app-ads.txt สำหรับแอป

หากต้องการใช้ app-ads.txt สำหรับเครือข่ายโฆษณา LINE โปรดดู เกี่ยวกับ app-ads.txt

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

กำหนดค่าการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา

คุณต้องเพิ่มเครือข่ายโฆษณา LINE ลงในการกำหนดค่าสื่อกลางสำหรับหน่วยโฆษณา

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

หากต้องการสร้างกลุ่มสื่อกลางใหม่ ให้เลือกสร้างกลุ่มสื่อกลาง

ป้อนรูปแบบโฆษณาและแพลตฟอร์ม แล้วคลิกต่อไป

ตั้งชื่อกลุ่มสื่อกลาง แล้วเลือกสถานที่ตั้งที่จะกำหนดเป้าหมาย จากนั้นตั้งค่าสถานะกลุ่มสื่อกลางเป็นเปิดใช้ แล้วคลิกเพิ่มหน่วยโฆษณา

เชื่อมโยงกลุ่มสื่อกลางนี้กับหน่วยโฆษณา AdMob ที่มีอยู่ อย่างน้อย 1 หน่วย จากนั้นคลิกเสร็จสิ้น

ตอนนี้คุณควรเห็นการ์ดหน่วยโฆษณาที่แสดงหน่วยโฆษณาที่คุณเลือก

เพิ่มเครือข่ายโฆษณา LINE เป็นแหล่งที่มาของโฆษณา

การเสนอราคา

ในส่วนแหล่งที่มาของโฆษณา ภายใต้การ์ดการเสนอราคา ให้เลือกเพิ่ม แหล่งที่มาของโฆษณา จากนั้นเลือกเครือข่ายโฆษณา LINE

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



คลิกรับทราบและยอมรับ แล้วคลิกต่อไป



หากมีการแมปสำหรับเครือข่ายโฆษณา LINE อยู่แล้ว คุณสามารถเลือกการแมปนั้นได้ หากไม่ ให้คลิกเพิ่มการแมป



จากนั้นป้อน รหัสแอปพลิเคชันและรหัสช่อง ที่ได้รับในส่วนก่อนหน้า จากนั้นคลิกเสร็จสิ้น

น้ำตก

ในการ์ด Waterfall ในส่วนแหล่งที่มาของโฆษณา ให้เลือกเพิ่มแหล่งที่มาของโฆษณา

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



หากมีการแมปสำหรับ เครือข่ายโฆษณา LINE อยู่แล้ว คุณสามารถเลือกการแมปนั้นได้ หากไม่ ให้คลิกเพิ่มการแมป

จากนั้นป้อน รหัสแอปพลิเคชันและรหัสสล็อต ที่ได้รับในส่วนก่อนหน้า จากนั้นคลิกเสร็จสิ้น

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

การใช้ CocoaPods (แนะนำ)

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

pod 'GoogleMobileAdsMediationLine'

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

pod install --repo-update

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

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

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

การผสานรวม SKAdNetwork

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

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

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

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

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

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

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

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

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

adAudio

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

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

import LineAdapter
// ...

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

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

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

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

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

อแดปเตอร์ LINE Ads Network จะป้อนข้อมูลต่อไปนี้ คำอธิบายช่องขั้นสูงของโฆษณาเนทีฟ สำหรับ GADNativeAd

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

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

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

GADMediationAdapterLine

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

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

เวอร์ชัน 2.9.20250825.0 (อยู่ระหว่างดำเนินการ)

เวอร์ชัน 2.9.20250805.0 (อยู่ระหว่างดำเนินการ)

• ตอนนี้พยายามลงทะเบียน SDK ของ FiveAd ก่อนคำขอโฆษณาแต่ละรายการ

เวอร์ชัน 2.9.20250512.0

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

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

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

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

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

เวอร์ชัน 2.6.20230609.0

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

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

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