ผสานรวม LY Ads Network กับสื่อกลาง

เลือกแพลตฟอร์ม: Android iOS Unity Flutter Android (เดิม)

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

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

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

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

ข้อกำหนดเบื้องต้น

ก่อนดำเนินการต่อ โปรดตรวจสอบสิ่งต่อไปนี้

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

    • ขั้นตอนที่ 1: ตั้งค่าการกำหนดค่าใน UI ของ LY Ads Network

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

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

    ไปที่แท็บ App แล้วคลิกปุ่ม New registration

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

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

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

    จดบันทึกรหัสแอป

    Android

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

    iOS

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

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

    ในแท็บแอป ให้เลือกแอปเพื่อดูรายละเอียดของแอป ในส่วนช่อง ให้คลิกเพิ่ม

    เพิ่มช่อง

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

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

    จดรหัสช่อง

    รายละเอียดช่องโฆษณา

    หลังจากสร้างช่องแรกแล้ว ให้คลิกตรวจสอบในหน้ารายละเอียดของแอปเพื่อขอรับการอนุมัติจาก LY Ads Network อาจใช้เวลาสักครู่ โปรดติดต่อตัวแทนของ LY Ads Network หากมีข้อสงสัย

    ขอรับการตรวจสอบ

    สร้างคีย์ Reporting API

    ไปที่แท็บการจัดการคีย์ API การรายงาน แล้วคลิกปุ่มสร้างคีย์ API

    แท็บคีย์ Reporting API

    กรอกแบบฟอร์มแล้วคลิกบันทึก

    แบบฟอร์มคีย์ API สำหรับการรายงาน

    จดรหัสคีย์ API และรหัสลับคีย์ API

    แบบฟอร์มคีย์ API สำหรับการรายงาน

    อัปเดต app-ads.txt

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

    หากต้องการใช้ app-ads.txt สำหรับ LY Ads Network โปรดดูเกี่ยวกับ app-ads.txt

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

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

    Android

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

    iOS

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

    ขั้นตอนที่ 3: นำเข้า SDK และอะแดปเตอร์ LY Ads Network

    OpenUPM-CLI

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

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

    OpenUPM

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

    ในแท็บ Scoped Registries ให้เพิ่ม OpenUPM เป็น Scoped Registry โดยระบุรายละเอียดต่อไปนี้

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

    รายละเอียด OpenUPM

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

    Unity Registry

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

    ติดตั้งจาก OpenUPM

    แพ็กเกจ Unity

    ดาวน์โหลดปลั๊กอินสื่อกลาง Google Mobile Ads สำหรับ LY เครือข่ายโฆษณา เวอร์ชันล่าสุดจากลิงก์ดาวน์โหลดในบันทึกการเปลี่ยนแปลง แล้วแตกไฟล์ 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

    ไม่จำเป็นต้องใช้โค้ดเพิ่มเติมสำหรับการผสานรวม LY Ads Network

    iOS

    การผสานรวม SKAdNetwork

    ทำตามเอกสารประกอบของ LY Ads Network เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist ของโปรเจ็กต์

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

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

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

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

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

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

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

    ปลั๊กอินสื่อกลาง LY Ads Network Unity รองรับพารามิเตอร์คำขอเพิ่มเติมต่อไปนี้ซึ่งสามารถส่งไปยังอะแดปเตอร์ผ่านคลาส 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);

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

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

    Android

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

    iOS

    GADMediationAdapterLine

    รหัสและข้อความที่แสดงโดยอะแดปเตอร์ LY Ads Network เมื่อโหลดโฆษณาไม่สำเร็จมีดังนี้

    Android

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

    iOS

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

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

    เวอร์ชัน 2.2.1

    เวอร์ชัน 2.2.0

    เวอร์ชัน 2.1.1

    เวอร์ชัน 2.1.0

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