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

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

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

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

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

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

ข้อกำหนด

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

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

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

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

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

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

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

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

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

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

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

จดบันทึกรหัสช่อง

ขั้นตอนที่ 2: ตั้งค่าความต้องการสำหรับรายการโฆษณาใน AdMob UI

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

Android

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

iOS

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

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

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

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

จากนั้นเลือกเนื้อหา > ตัวแก้ไขบริการ Google Play > ตัวแก้ไข Android > บังคับแก้ไข ไลบรารีตัวแปลค่าบริการ Unity Play จะแก้ปัญหาการขึ้นต่อกันใหม่ตั้งแต่ต้นและคัดลอกทรัพยากร Dependency ที่ประกาศไว้ไปยังไดเรกทอรี Assets/Plugins/Android ของแอป Unity

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

Android

ไม่ต้องมีรหัสเพิ่มเติมสำหรับการผสานรวม Line

iOS

การผสานรวม SKAdNetwork

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

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

เวอร์ชัน 1.2.0

เวอร์ชัน 1.1.2

เวอร์ชัน 1.1.1

เวอร์ชัน 1.1.0

เวอร์ชัน 1.0.0