ผสานรวมบรรทัดกับสื่อกลาง (เบต้า)

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

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

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

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

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

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

ข้อกำหนด

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

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

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

ขั้นตอนที่ 1: ตั้งค่าการกําหนดค่าใน UI ของ Line

เข้าสู่ระบบบัญชี Line

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

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

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

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

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

ทําตามขั้นตอนเดียวกันเพื่อสร้างตําแหน่งโฆษณาสําหรับทั้งการผสานรวมการเสนอราคาและการผสานรวม Waterfall ตำแหน่งโฆษณาแต่ละตำแหน่งสามารถใช้กับทั้ง 2 ประเภท

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

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

กรอกแบบฟอร์ม เมื่อกรอกเสร็จแล้ว ให้คลิก (登録) ลงทะเบียน

หมายเหตุ: ติดต่อผู้จัดการฝ่ายดูแลลูกค้าของเครือข่ายโฆษณาในไลน์เพื่อรับสิทธิ์เข้าถึงการสร้างตําแหน่งโฆษณาเนทีฟใน UI ของ Line

จดรหัสช่องไว้

ขั้นตอนที่ 2: ตั้งค่าดีมานด์ในบรรทัดใน Ad Manager UI

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

เพิ่ม Line ในบริษัท

การเสนอราคา

ขั้นตอนนี้ไม่จําเป็นสำหรับการผสานรวมการเสนอราคา

น้ำตก

ไปที่ผู้ดูแลระบบ > บริษัท แล้วคลิกปุ่มบริษัทใหม่ในแท็บบริษัททั้งหมด เลือกเครือข่ายโฆษณา

เลือก Line เป็นเครือข่ายโฆษณา ป้อนชื่อที่ไม่ซ้ำ และเปิดใช้สื่อกลาง

คุณไม่จำเป็นต้องป้อนชื่อผู้ใช้หรือรหัสผ่าน คลิกบันทึกเมื่อดำเนินการเสร็จสิ้น

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

การเสนอราคา

ไปที่ผู้ดูแลระบบ > การตั้งค่าส่วนกลาง ไปที่แท็บการตั้งค่าบัญชี Ad Exchange แล้วตรวจสอบและเปิดการแชร์สัญญาณที่ปลอดภัย คลิกบันทึก

น้ำตก

ขั้นตอนนี้ไม่จําเป็นสำหรับการผสานรวม Waterfall

กําหนดค่า Line การเสนอราคา

การเสนอราคา

ไปที่การแสดงโฆษณา > ผู้เสนอราคา แล้วคลิกผู้เสนอราคารายใหม่ในแท็บการเสนอราคา SDK

เลือก Line เป็นผู้เสนอราคา

สลับเพิ่มคลังสัญญาณของผู้เสนอราคารายนี้ลงในรายการสัญญาณที่อนุญาตและอนุญาตให้แชร์สัญญาณกับผู้เสนอราคารายนี้ จากนั้นคลิกดำเนินการต่อ

คลิกต่อไป

คลิกเสร็จสิ้น

น้ำตก

ขั้นตอนนี้ไม่จําเป็นสำหรับการผสานรวม Waterfall

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

การเสนอราคา

ไปที่การแสดงโฆษณา > ผู้เสนอราคา แล้วเลือกบริษัทสำหรับLine ในแท็บการเสนอราคา SDK

ไปที่แท็บการแมปหน่วยโฆษณา แล้วคลิกการแมปหน่วยโฆษณาใหม่

เลือกหน่วยโฆษณาที่เจาะจง เลือกหน่วยโฆษณาและรูปแบบ แอปบนอุปกรณ์เคลื่อนที่เป็นประเภทพื้นที่โฆษณา และแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ จากนั้นป้อนApplication ID and Slot ID ที่ได้ในส่วนก่อนหน้า สุดท้าย ให้คลิกบันทึก

สำคัญ: กําหนดเป้าหมายหน่วยโฆษณาที่เลือกตามกลุ่มผลตอบแทนอย่างน้อย 1 กลุ่ม และ Application ID ต้องเชื่อมโยงกับแอปเป้าหมายตามที่ระบุไว้ใน Line UI

น้ำตก

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

เลื่อนลงแล้วคลิกเพิ่มพาร์ทเนอร์ผลตอบแทน

เลือกบริษัทที่คุณสร้างสำหรับ Line ในส่วนก่อนหน้า เลือกสื่อกลาง SDK บนอุปกรณ์เคลื่อนที่เป็นประเภทการผสานรวม iOS เป็นแพลตฟอร์ม และใช้งานอยู่เป็นสถานะ

ป้อน Application ID and Slot ID ที่ได้ในส่วนก่อนหน้า และค่า CPM เริ่มต้น คลิกบันทึก

สำคัญ: Application ID ต้องเชื่อมโยงกับแอปเป้าหมายตามที่ระบุไว้ในLine UI

ขั้นตอนที่ 3: นําเข้า SDK และอะแดปเตอร์ของ Line

หมายเหตุ: การผสานรวมเวอร์ชัน Line และ Google Mobile Ads SDK ที่เข้ากันได้ไม่สำเร็จอาจทําให้เกิดปัญหาการสร้าง

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

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

pod 'GoogleMobileAdsMediationLine'

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

pod install --repo-update

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

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

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

การผสานรวม SKAdNetwork

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

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

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

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

ทําตามวิธีการในเอกสารประกอบของ Line เกี่ยวกับวิธีเปิดใช้โฆษณาทดสอบของ Line

สำคัญ: ปิดใช้โหมดทดสอบสําหรับ Ad Manager และ Line ก่อนเผยแพร่แอป

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

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

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

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

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

adAudio

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

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

Swift

import LineAdapter
// ...

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

Objective-C

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

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

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

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

ตัวแปลงโฆษณาในบรรทัดจะป้อนข้อมูลต่อไปนี้ ช่อง สําหรับ GADNativeAd

ช่อง	ชิ้นงานที่อะแดปเตอร์ของ Line รวมไว้เสมอ
บรรทัดแรก
รูปภาพ
เนื้อความ
ไอคอนแอป	^1
คำกระตุ้นการตัดสินใจ
การให้ดาว
ร้านค้า
ราคา

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

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

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

GADMediationAdapterLine

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

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

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

เวอร์ชัน 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