คู่มือนี้แสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดงโฆษณาจาก Line โดยใช้ สื่อกลาง ครอบคลุมการผสานรวม Waterfall ซึ่งจะอธิบายวิธีเพิ่ม Line ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม SDK และอะแดปเตอร์ของ Line ลงใน iOS แอป
อินเทอร์เฟซของหน้าแดชบอร์ดสำหรับ "บรรทัด" จะใช้ข้อความภาษาญี่ปุ่นเป็นป้ายกำกับ ปุ่ม และคำอธิบาย ภาพหน้าจอในคู่มือนี้ไม่มีคำแปล แต่ในคำอธิบายและวิธีการของคู่มือนี้ ป้ายกำกับและปุ่มต่างๆ จะได้รับการแปลโดยเป็นภาษาอังกฤษในวงเล็บที่เทียบเท่ากัน
การผสานรวมและรูปแบบโฆษณาที่รองรับ
อะแดปเตอร์สื่อกลางสําหรับ Line มีความสามารถดังต่อไปนี้
การผสานรวม | |
---|---|
การเสนอราคา | |
น้ำตก | 1 |
รูปแบบ | |
แบนเนอร์ | |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว | |
เนทีฟ |
1 การผสานรวม Waterfall อยู่ในเวอร์ชันเบต้าแบบปิด โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อขอสิทธิ์เข้าถึง
ข้อกำหนด
- เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
Google Mobile Ads SDK เวอร์ชันล่าสุด
สื่อกลางเสร็จสมบูรณ์ คู่มือเริ่มต้นใช้งาน
ขั้นตอนที่ 1: ตั้งค่าการกําหนดค่าใน UI ของ Line
เข้าสู่ระบบบัญชี Line
เพิ่มแอปพลิเคชันใหม่
คลิก 広告枠管理 (การจัดการช่องโฆษณา) > メディア (สื่อ) จากนั้นคลิก ชุมชนออนไลน์規電成 (สร้างใหม่)
กรอกแบบฟอร์มและคลิก 登録 (ลงทะเบียน)
จดรหัสแอปพลิเคชันไว้
สร้างตําแหน่งโฆษณา
ทําตามขั้นตอนเดียวกันเพื่อสร้างตําแหน่งโฆษณาสําหรับทั้งการผสานรวมการเสนอราคาและการผสานรวม Waterfall ตำแหน่งโฆษณาแต่ละตำแหน่งสามารถใช้กับทั้ง 2 ประเภทคลิกรหัสของแอปพลิเคชันที่ต้องการเพิ่มตําแหน่งโฆษณา จากนั้นเลือก詳細 (รายละเอียด)
คลิก スロット 追加 (เพิ่มช่อง)
กรอกแบบฟอร์ม เมื่อกรอกเสร็จแล้ว ให้คลิก (登録) ลงทะเบียน
จดรหัสช่องไว้
ขั้นตอนที่ 2: ตั้งค่าความต้องการสำหรับรายการโฆษณาใน Ad Manager UI
ขั้นตอนที่ 3: นําเข้า SDK และอะแดปเตอร์ของ Line
การใช้ CocoaPods (แนะนำ)
เพิ่มบรรทัดต่อไปนี้ลงใน Podfile ของโปรเจ็กต์
pod 'GoogleMobileAdsMediationLine'
จากบรรทัดคำสั่ง ให้เรียกใช้คำสั่งต่อไปนี้
pod install --repo-update
การผสานรวมด้วยตนเอง
- ดาวน์โหลด Line
SDK เวอร์ชันล่าสุดและลิงก์
FiveAd.framework
ในโปรเจ็กต์ - ดาวน์โหลดอะแดปเตอร์ Line เวอร์ชันล่าสุดจากลิงก์ดาวน์โหลดในบันทึกการเปลี่ยนแปลงและลิงก์
LineAdapter.framework
ในโปรเจ็กต์
ขั้นตอนที่ 4: เพิ่มโค้ดที่จำเป็น
การผสานรวม SKAdNetwork
ทำตามเอกสารประกอบของ Line เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist
ของโปรเจ็กต์
ขั้นตอนที่ 5: ทดสอบการใช้งาน
เปิดใช้โฆษณาทดสอบ
ตรวจสอบว่าคุณได้ลงทะเบียนอุปกรณ์ทดสอบสำหรับ AdMob แล้ว
ทําตามวิธีการในเอกสารประกอบของ Line เกี่ยวกับวิธีเปิดใช้โฆษณาทดสอบของ 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 |
คำกระตุ้นการตัดสินใจ | |
การให้ดาว | |
ร้านค้า | |
ราคา |
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 | โหลดชิ้นงานรูปภาพไอคอนข้อมูลในโฆษณาเนทีฟไม่สำเร็จ |
บันทึกการเปลี่ยนแปลงของอะแดปเตอร์สื่อกลาง iOS สำหรับ LINE
เวอร์ชัน 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