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

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

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

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

อแดปเตอร์สื่อกลาง Ad Manager สำหรับ LY Ads Network มีความสามารถดังนี้

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

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

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

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

    OpenUPM-CLI

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

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

    OpenUPM

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

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

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

    รายละเอียด OpenUPM

    จากนั้นไปที่ Window > Package Manager เพื่อเปิดเครื่องมือจัดการแพ็กเกจ Unity แล้วเลือกMy Registries จากเมนูแบบเลื่อนลง

    Unity Registries

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

    ติดตั้งจาก OpenUPM

    แพ็กเกจ Unity

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

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

    นำเข้าจาก Unity

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

    บังคับให้แก้ไข

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

    Android

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

    iOS

    การผสานรวม SKAdNetwork

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

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

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

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

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

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

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

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

    ปลั๊กอินสื่อกลาง 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 จะแสดงเมื่อโหลดโฆษณาไม่สำเร็จมีดังนี้

    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