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

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

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

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

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

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

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

ข้อกำหนด

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

เพิ่มบรรทัดต่อไปนี้ลงใน 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