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

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

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

AdMob Mediation Adapter สําหรับ Line มีคุณสมบัติดังต่อไปนี้

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

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

ข้อกำหนด

  • Unity 4 ขึ้นไป
  • SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุด
  • วิธีทำให้ใช้งานได้ใน Android
    • Android API ระดับ 21 ขึ้นไป
  • วิธีติดตั้งใช้งานใน iOS
    • เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
  • โปรเจ็กต์ Unity ที่ใช้งานได้ซึ่งกําหนดค่าด้วย Google Mobile Ads SDK ดูรายละเอียดได้ที่เริ่มต้นใช้งาน
  • ทำตามคู่มือเริ่มต้นใช้งานสื่อกลางให้เสร็จสมบูรณ์

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

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

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

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

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

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

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

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

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

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

จดรหัสช่องโฆษณาไว้

ขั้นตอนที่ 2: ตั้งค่าดีมานด์ในบรรทัดใน AdMob UI

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

Android

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

iOS

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

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

ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณา Google บนมือถือเวอร์ชันล่าสุดสําหรับ Line จากลิงก์ดาวน์โหลดในบันทึกการเปลี่ยนแปลง แล้วแตกไฟล์ GoogleMobileAdsLineMediation.unitypackage จากไฟล์ ZIP

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

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

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

Android

ไม่ต้องใช้โค้ดเพิ่มเติมสำหรับการผสานรวมกับ Line

iOS

การผสานรวม SKAdNetwork

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

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

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

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

ทําตามวิธีการในเอกสารประกอบของ Android และ iOS ของ Line เกี่ยวกับวิธีเปิดใช้โฆษณาทดสอบของ Line

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

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

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

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

ปลั๊กอินสื่อกลาง Line 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);

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

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

Android

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

iOS

GADMediationAdapterLine

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

Android

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

iOS

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

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

เวอร์ชัน 1.3.1

เวอร์ชัน 1.3.0

เวอร์ชัน 1.2.0

เวอร์ชัน 1.1.2

เวอร์ชัน 1.1.1

เวอร์ชัน 1.1.0

เวอร์ชัน 1.0.0