หน้านี้ได้รับการแปลโดย Cloud Translation API

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

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

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

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

อะแดปเตอร์สื่อกลางสําหรับเครือข่ายโฆษณา LINE มีคุณสมบัติดังต่อไปนี้

การผสานรวม
การเสนอราคา	¹
น้ำตก
รูปแบบ
ป้ายประกาศ
โฆษณาคั่นระหว่างหน้า
ได้รับรางวัลแล้ว
เนทีฟ

¹ การผสานรวมการเสนอราคาอยู่ในโปรแกรมเบต้าแบบปิด โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อขอสิทธิ์เข้าถึง

ข้อกำหนด

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

Google Mobile Ads SDK เวอร์ชันล่าสุด
ทําตามคู่มือเริ่มต้นใช้งานของสื่อกลาง

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

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

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

คลิก 広告枠管理 (การจัดการช่องโฆษณา) > メディア (สื่อ) จากนั้นคลิก新規作成 (สร้างใหม่)

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

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

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

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

คลิก スロット追加 (เพิ่มช่อง)

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

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

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

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

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

pod 'GoogleMobileAdsMediationLine'

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

pod install --repo-update

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

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

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

การผสานรวม SKAdNetwork

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

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

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

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

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

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

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

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

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

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

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

Swift

import LineAdapter
// ...

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

Objective-C

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

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

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

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

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

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

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

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

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

GADMediationAdapterLine

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

รหัสข้อผิดพลาด	โดเมน	เหตุผล
1-10	ส่งโดย SDK เครือข่ายโฆษณา LINE	SDK เครือข่ายโฆษณา LINE แสดงข้อผิดพลาดเฉพาะ SDK ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบของ LINE Ads Network
101	com.google.ads.mediation.line	พารามิเตอร์เซิร์ฟเวอร์ไม่ถูกต้อง (เช่น ไม่มีรหัสแอปพลิเคชันหรือรหัสช่อง)
102	com.google.ads.mediation.line	ขนาดโฆษณาที่ขอไม่ตรงกับขนาดโฆษณาแบนเนอร์ที่ LINE Ads Network รองรับ
103	com.google.ads.mediation.line	โหลดชิ้นงานรูปภาพไอคอนข้อมูลในโฆษณาเนทีฟไม่สำเร็จ

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

เวอร์ชันถัดไป

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

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

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

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

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