คู่มือนี้แสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดง โฆษณาจากบรรทัดที่ใช้ สื่อกลาง AdMob ซึ่งครอบคลุมการผสานรวม Waterfall ซึ่งครอบคลุมถึงวิธีเพิ่มบรรทัดลงในหน่วยโฆษณา การกำหนดค่าสื่อกลาง และวิธีผสานรวม Line SDK และอะแดปเตอร์เข้ากับ แอป
อินเทอร์เฟซของหน้าแดชบอร์ดสำหรับ Line จะใช้ข้อความภาษาญี่ปุ่นเป็นป้ายกำกับ และคำอธิบาย ภาพหน้าจอในคู่มือนี้ แปลแล้ว แต่ในคำอธิบายและวิธีการของคู่มือนี้ ป้ายกำกับและ ปุ่มต่างๆ จะได้รับการแปลโดยใส่เครื่องหมายภาษาอังกฤษไว้ในวงเล็บ
การผสานรวมและรูปแบบโฆษณาที่รองรับ
อะแดปเตอร์สื่อกลางสำหรับ Line มีความสามารถดังต่อไปนี้
การผสานรวม | |
---|---|
การเสนอราคา | |
น้ำตก | 1 |
รูปแบบ | |
แบนเนอร์ | |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว | |
เนทีฟ |
1 การผสานรวม Waterfall อยู่ในเวอร์ชันเบต้าแบบเปิด
ข้อกำหนด
- เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุด
ดำเนินการสื่อกลางให้เสร็จสิ้น คู่มือเริ่มต้นใช้งาน
ขั้นตอนที่ 1: กำหนดค่าใน Line UI
ขั้นตอนที่ 2: ตั้งค่าความต้องการรายการโฆษณาใน AdMob UI
กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา
Android
ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสําหรับ Android
iOS
โปรดดูวิธีการในขั้นตอนที่ 2 ในคู่มือสำหรับ iOS
ขั้นตอนที่ 3: นำเข้า Line SDK และอะแดปเตอร์
การใช้ CocoaPods (แนะนำ)
เพิ่มบรรทัดต่อไปนี้ลงใน Podfile ของโปรเจ็กต์
pod 'GoogleMobileAdsMediationLine'
จากบรรทัดคำสั่งให้เรียกใช้คำสั่งต่อไปนี้
pod install --repo-update
การผสานรวมด้วยตนเอง
- ดาวน์โหลดเวอร์ชันล่าสุดของ Line
SDK และลิงก์
FiveAd.framework
ในโปรเจ็กต์ของคุณ - ดาวน์โหลดอะแดปเตอร์ Line เวอร์ชันล่าสุดจากลิงก์ดาวน์โหลดใน
บันทึกการเปลี่ยนแปลงและ
ลิงก์
LineAdapter.framework
ในโปรเจ็กต์
ขั้นตอนที่ 4: เพิ่มโค้ดที่จําเป็น
การผสานรวม SKAdNetwork
ทำตามเอกสารประกอบของ Line
เพื่อเพิ่มตัวระบุ 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];
การใช้โฆษณาเนทีฟ
การแสดงโฆษณา
อะแดปเตอร์ Line จะแสดงข้อมูลต่อไปนี้
คำอธิบายช่องของโฆษณาเนทีฟขั้นสูง
สำหรับ
GADNativeAd
ช่อง | เนื้อหารวมอยู่โดยอะแดปเตอร์ Line เสมอ |
---|---|
บรรทัดแรก | |
รูปภาพ | |
เนื้อความ | |
ไอคอนแอป | 1 |
คำกระตุ้นการตัดสินใจ | |
การให้ดาว | |
ร้านค้า | |
ราคา |
1 สำหรับโฆษณาเนทีฟ Line SDK ไม่ได้ให้ชิ้นงานไอคอนแอป แต่อะแดปเตอร์ 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 | ขนาดโฆษณาที่ขอไม่ตรงกับขนาดโฆษณาแบนเนอร์ที่รองรับสำหรับบรรทัด |
103 | com.google.ads.mediation.line | โหลดชิ้นงานรูปภาพไอคอนข้อมูลในโฆษณาเนทีฟไม่สำเร็จ |
บันทึกการเปลี่ยนแปลงของอะแดปเตอร์สื่อกลาง iOS สำหรับ LINE
เวอร์ชัน 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
ในแผนที่โมดูลแล้ว
สร้างและทดสอบด้วย:
- 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