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

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

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

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

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

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

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

¹ การผสานรวม Waterfall อยู่ในเวอร์ชันเบต้าแบบเปิด

ข้อกำหนด

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

SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุด
ทำตามสื่อกลาง คู่มือเริ่มต้นใช้งาน

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

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

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

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

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

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

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

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

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

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

จดบันทึกรหัสช่อง

ขั้นตอนที่ 2: ตั้งค่าความต้องการสำหรับรายการโฆษณาใน AdMob UI

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

Android

ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสําหรับ Android

iOS

โปรดดูวิธีการในขั้นตอนที่ 2 ในคู่มือสำหรับ iOS

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

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

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

pod 'GoogleMobileAdsMediationLine'

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

pod install --repo-update

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

ดาวน์โหลด SDK สำหรับ Line และลิงก์ FiveAd.framework เวอร์ชันล่าสุดในโปรเจ็กต์ของคุณ
ดาวน์โหลดอะแดปเตอร์ Line เวอร์ชันล่าสุดจากลิงก์ดาวน์โหลดใน Changelog และลิงก์ LineAdapter.framework ในโปรเจ็กต์

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

การผสานรวม SKAdNetwork

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

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

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

อย่าลืม ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ AdMob

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

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

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

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

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

อะแดปเตอร์ Line รองรับพารามิเตอร์คำขอเพิ่มเติม ซึ่งส่งผ่านไปยังอะแดปเตอร์โดยใช้คลาส GADMediationAdapterLineExtras ได้ คลาสนี้ประกอบด้วยพร็อพเพอร์ตี้ต่อไปนี้

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

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

Swift

import LineAdapter
// ...

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

Objective-C

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

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

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

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

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

ฟิลด์	เนื้อหารวมอยู่โดยอะแดปเตอร์ Line เสมอ
บรรทัดแรก
รูปภาพ
เนื้อความ
ไอคอนของแอป	¹
คำกระตุ้นให้ดำเนินการ (Call-To-Action)
Star rating
ร้านค้า
ราคา

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

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

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

GADMediationAdapterLine

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

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

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

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

เพิ่มการควบคุมเสียงสำหรับโฆษณาเนทีฟผ่าน GADVideoOptions

เวอร์ชัน 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 ในแผนที่โมดูลแล้ว

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

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