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

เลือกแพลตฟอร์ม: Android (เบต้า) ใหม่ Android iOS Unity Flutter

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

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

อแดปเตอร์สื่อกลาง AdMob สำหรับเครือข่ายโฆษณา LINE มีความสามารถดังนี้

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

ข้อกำหนด

  • ล่าสุดจาก Google Mobile Ads Unity Plugin
  • Unity 4 ขึ้นไป
  • [สำหรับการเสนอราคา]: หากต้องการผสานรวมรูปแบบโฆษณาที่รองรับทั้งหมดในการเสนอราคา ให้ใช้ ปลั๊กอินสื่อกลาง Google Mobile Ads สำหรับ LINE Ads SDK 1.5.0 ขึ้นไป (แนะนำให้ใช้เวอร์ชันล่าสุด)
  • หากต้องการติดตั้งใช้งานใน Android
    • ระดับ API 23 ขึ้นไป ของ Android
  • หากต้องการทำให้ใช้งานได้ใน iOS
    • เป้าหมายการติดตั้งใช้งาน iOS 13.0 ขึ้นไป
  • โปรเจ็กต์ Unity ที่ใช้งานได้ซึ่งกำหนดค่าด้วย Google Mobile Ads Unity Plugin ดูรายละเอียดได้ที่ตั้งค่า Google Mobile Ads Unity Plugin
  • ตั้งค่าสื่อกลาง AdMob

ขั้นตอนที่ 1: ตั้งค่าการกำหนดค่าใน UI ของเครือข่ายโฆษณา LINE

ลงชื่อสมัครใช้และเข้าสู่ระบบบัญชี LINE Ads Network

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

ไปที่แท็บ アプリ (แอป) แล้วคลิกปุ่ม 新規登録 (ลงทะเบียนใหม่)

การจดทะเบียนใหม่

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

แบบฟอร์มการลงทะเบียนใหม่

จดรหัสแอปไว้

Android

รายละเอียดการจดทะเบียน

iOS

รายละเอียดการจดทะเบียน

สร้างช่องโฆษณา

ในแท็บアプリ (แอป) ให้เลือกแอปเพื่อดูรายละเอียดของแอป ในส่วนスロット (Slot) ให้คลิก 追加 (Add)

เพิ่มช่อง

กรอกแบบฟอร์มเพื่อดูรายละเอียดเกี่ยวกับช่อง สำหรับประเภทการเสนอราคา ให้เลือก มาตรฐานเพื่อกำหนดค่าช่องนี้สำหรับการแสดงโฆษณาสื่อกลางตามลำดับขั้น (Waterfall Mediation) หรือ การเสนอราคา SDK ของ Google เพื่อกำหนดค่าช่องนี้สำหรับการเสนอราคา คลิก 作成 (สร้าง) เมื่อกรอกแบบฟอร์มเสร็จแล้ว

เพิ่มแบบฟอร์มช่อง

จดรหัสสล็อต (Slot ID)

รายละเอียดสล็อต

อัปเดต app-ads.txt

ผู้ขายที่ได้รับอนุญาตสำหรับแอป app-ads.txt เป็นความคิดริเริ่มของ IAB Tech Lab ที่ช่วยตรวจสอบว่าคุณจะขาย พื้นที่โฆษณาในแอปผ่านช่องทางที่คุณได้รับอนุญาตเท่านั้น คุณจะต้องใช้ไฟล์ app-ads.txt เพื่อป้องกันไม่ให้เสียรายได้จากโฆษณาเป็นจำนวนมาก หากยังไม่ได้ดำเนินการ ให้สร้างไฟล์ app-ads.txt สำหรับแอป

หากต้องการติดตั้งใช้งาน app-ads.txt สำหรับเครือข่ายโฆษณา LINE โปรดดู เกี่ยวกับ app-ads.txt

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

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

Android

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

iOS

ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคำแนะนำสำหรับ iOS

ขั้นตอนที่ 3: นำเข้า SDK และอะแดปเตอร์เครือข่ายโฆษณา LINE

OpenUPM-CLI

หากคุณติดตั้ง OpenUPM-CLI แล้ว คุณจะติดตั้งปลั๊กอินสื่อกลางเครือข่ายโฆษณา Google Mobile Ads และ LINE สำหรับ Unity ลงในโปรเจ็กต์ได้โดยเรียกใช้คำสั่งต่อไปนี้จาก ไดเรกทอรีรากของโปรเจ็กต์

openupm add com.google.ads.mobile.mediation.line

OpenUPM

ในโปรแกรมแก้ไขโปรเจ็กต์ Unity ให้เลือกแก้ไข > การตั้งค่าโปรเจ็กต์ > Package Manager เพื่อเปิด การตั้งค่า Unity Package Manager

ในแท็บรีจิสทรีที่กำหนดขอบเขต ให้เพิ่ม OpenUPM เป็นรีจิสทรีที่กำหนดขอบเขตโดยใช้รายละเอียดต่อไปนี้

  • ชื่อ: OpenUPM
  • URL: https://package.openupm.com
  • ขอบเขต: com.google

รายละเอียด OpenUPM

จากนั้นไปที่หน้าต่าง > Package Manager เพื่อเปิด Unity Package Manager แล้ว เลือกรีจิสทรีของฉันจากเมนูแบบเลื่อนลง

รีจิสทรีของ Unity

เลือกแพ็กเกจ การสื่อกลางบรรทัดโฆษณา Google สำหรับอุปกรณ์เคลื่อนที่ แล้วคลิกติดตั้ง

ติดตั้งจาก OpenUPM

แพ็กเกจ Unity

ดาวน์โหลดปลั๊กอินสื่อกลาง Google Mobile Ads สำหรับ เครือข่ายโฆษณา LINE เวอร์ชันล่าสุดจากลิงก์ดาวน์โหลดใน บันทึกการเปลี่ยนแปลง และแตกไฟล์ GoogleMobileAdsLineMediation.unitypackage จากไฟล์ ZIP

ในโปรแกรมแก้ไขโปรเจ็กต์ Unity ให้เลือกชิ้นงาน > นำเข้าแพ็กเกจ > แพ็กเกจที่กำหนดเอง แล้วค้นหาไฟล์ GoogleMobileAdsLineMediation.unitypackage ที่คุณดาวน์โหลด ตรวจสอบว่าได้เลือกไฟล์ทั้งหมดแล้ว แล้วคลิกนำเข้า

นำเข้าจาก Unity

จากนั้นเลือกAssets > External Dependency Manager > Android Resolver > Force Resolve ไลบรารี External Dependency Manager จะทำการแก้ปัญหาทรัพยากร Dependency ตั้งแต่ต้นและคัดลอกทรัพยากร Dependency ที่ประกาศไว้ไปยังไดเรกทอรี Assets/Plugins/Android ของแอป Unity

บังคับแก้ไข

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

Android

ไม่จำเป็นต้องใช้โค้ดเพิ่มเติมสำหรับการผสานรวมเครือข่ายโฆษณา LINE

iOS

การผสานรวม SKAdNetwork

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

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

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

ตรวจสอบว่าคุณได้ ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ AdMob แล้ว

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

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

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

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

ปลั๊กอินสื่อกลาง Unity ของเครือข่ายโฆษณา LINE รองรับพารามิเตอร์คำขอเพิ่มเติมต่อไปนี้ ซึ่งส่งไปยังอแดปเตอร์ได้ผ่านคลาส LineMediationExtras

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

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

using GoogleMobileAds.Api;
using GoogleMobileAds.Mediation.Line.Api;
// ...

var adRequest = new AdRequest();
var lineExtras = new LineMediationExtras();
lineExtras.SetEnableAdSound(true);
adRequest.MediationExtras.Add(lineExtras);

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

หากอแดปเตอร์ไม่ได้รับโฆษณาจากเครือข่ายโฆษณา LINE ผู้เผยแพร่โฆษณาสามารถตรวจสอบข้อผิดพลาดพื้นฐานจากการตอบกลับโฆษณาได้โดยใช้ ResponseInfo ในคลาสต่อไปนี้

Android

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

iOS

GADMediationAdapterLine

ต่อไปนี้คือรหัสและข้อความที่มาพร้อมกันซึ่งอะแดปเตอร์เครือข่ายโฆษณา LINE แสดงเมื่อโหลดโฆษณาล้มเหลว

Android

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

iOS

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

บันทึกการเปลี่ยนแปลงของปลั๊กอินสื่อกลาง Unity

เวอร์ชัน 2.0.2

เวอร์ชัน 2.0.1

เวอร์ชัน 2.0.0

เวอร์ชัน 1.5.10

เวอร์ชัน 1.5.9

เวอร์ชัน 1.5.8

เวอร์ชัน 1.5.7

เวอร์ชัน 1.5.6

เวอร์ชัน 1.5.5

  • แก้ไขปัญหาที่การติดตั้งผ่าน OpenUPM ทำให้ปลั๊กอินนำเข้าแพ็กเกจไม่ถูกต้อง

เวอร์ชัน 1.5.4

เวอร์ชัน 1.5.3

เวอร์ชัน 1.5.2

เวอร์ชัน 1.5.1

เวอร์ชัน 1.5.0

เวอร์ชัน 1.4.0

เวอร์ชัน 1.3.1

เวอร์ชัน 1.3.0

เวอร์ชัน 1.2.0

เวอร์ชัน 1.1.2

เวอร์ชัน 1.1.1

เวอร์ชัน 1.1.0

เวอร์ชัน 1.0.0