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

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

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

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

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

² การผสานรวม Waterfall อยู่ในรุ่นเบต้าแบบเปิด

³ รูปแบบนี้ใช้ได้ในการผสานรวม Waterfall เท่านั้น

ข้อกำหนด

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

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

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

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

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

เข้าสู่ระบบบัญชี LINE Ads Network

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

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

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

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

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

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

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

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

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

ขั้นตอนที่ 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

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

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

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 จะป้อนข้อมูลคำอธิบายช่องขั้นสูงของโฆษณาเนทีฟต่อไปนี้สำหรับ GADNativeAd

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

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

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

GADMediationAdapterLine

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

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

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

• นําตรรกะที่ตรวจสอบว่า FAD SDK ได้รับการลงทะเบียนในการตั้งค่าอะแดปเตอร์หรือไม่ออก
• อัปเดต API "show" ของโฆษณาคั่นระหว่างหน้าและโฆษณาที่มีการให้รางวัลด้วย API "showWithViewController:" ใหม่
• นําการตรวจสอบสถานะโฆษณาเนทีฟออกก่อนดาวน์โหลดชิ้นงานโฆษณาเนทีฟ เนื่องจากเลิกใช้งานแล้วและไม่มีชิ้นงานทดแทน

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