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

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

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

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

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

การผสานรวม
การเสนอราคา  1
น้ำตก  2
รูปแบบ
แบนเนอร์  3
โฆษณาคั่นระหว่างหน้า  3
ได้รับรางวัลแล้ว
เนทีฟ
1 การผสานรวมการเสนอราคาอยู่ในโปรแกรมเบต้าแบบปิด โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อขอสิทธิ์เข้าถึง

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

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

ข้อกำหนด

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

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

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

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

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

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

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

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

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

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

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

ขั้นตอนที่ 2: ตั้งค่าดีมานด์โฆษณาใน UI ของ AdMob

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

คุณต้องเพิ่ม Line ลงในการกำหนดค่าสื่อกลางสําหรับหน่วยโฆษณา

ก่อนอื่น ให้ลงชื่อเข้าใช้บัญชี AdMob จากนั้นไปที่แท็บสื่อกลาง หากมีกลุ่มสื่อกลางที่มีอยู่ซึ่งต้องการแก้ไข ให้คลิกชื่อกลุ่มสื่อกลางนั้นเพื่อแก้ไข แล้วข้ามไปเพิ่ม Line เป็นแหล่งที่มาของโฆษณา

หากต้องการสร้างกลุ่มสื่อกลางใหม่ ให้เลือกสร้างกลุ่มสื่อกลาง

ป้อนรูปแบบโฆษณาและแพลตฟอร์ม แล้วคลิกต่อไป

ตั้งชื่อกลุ่มสื่อกลาง แล้วเลือกสถานที่ที่จะกําหนดเป้าหมาย ถัดไป ให้ตั้งค่าสถานะกลุ่มสื่อกลางเป็นเปิดใช้ แล้วคลิกเพิ่มหน่วยโฆษณา

เชื่อมโยงกลุ่มสื่อกลางนี้กับหน่วยโฆษณา AdMob ที่มีอยู่อย่างน้อย 1 หน่วย จากนั้นคลิกเสร็จสิ้น

ตอนนี้คุณควรเห็นการ์ดหน่วยโฆษณาที่สร้างขึ้นด้วยหน่วยโฆษณาที่คุณเลือก

เพิ่ม Line เป็นแหล่งที่มาของโฆษณา

การเสนอราคา


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

น้ำตก


เลือกเพิ่มแหล่งที่มาของโฆษณาในการ์ด Waterfall ในส่วนแหล่งที่มาของโฆษณา จากนั้นเลือกเส้น

เลือกบรรทัด จากนั้นป้อนค่า eCPM สำหรับบรรทัด แล้วคลิกต่อไป



หากมีการแมปสำหรับ Line อยู่แล้ว ให้เลือกการแมปนั้น หรือคลิกเพิ่มการแมป

จากนั้นป้อนรหัสแอปพลิเคชันและรหัสช่องที่ได้ในส่วนก่อนหน้า จากนั้นคลิกเสร็จสิ้น


ขั้นตอนที่ 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 = GADRequest()
let extras = GADMediationAdapterLineExtras()
extras.adAudio = GADMediationAdapterLineAdAudio.unmuted
// ...
request.register(extras)

Objective-C

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

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

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

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

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

ช่อง ชิ้นงานที่อะแดปเตอร์บรรทัดรวมไว้เสมอ
บรรทัดแรก
รูปภาพ
เนื้อความ
ไอคอนแอป 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 โหลดชิ้นงานรูปภาพไอคอนข้อมูลในโฆษณาเนทีฟไม่สำเร็จ

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

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