ผสานรวมบรรทัดกับสื่อกลาง (เบต้า)

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

อินเทอร์เฟซแดชบอร์ดสำหรับ Line ใช้ข้อความภาษาญี่ปุ่นสำหรับป้ายกำกับ ปุ่ม และคำอธิบาย ภาพหน้าจอในคู่มือนี้ไม่มีคำแปล อย่างไรก็ตาม คำอธิบายและวิธีการในคู่มือนี้จะแปลป้ายกำกับและปุ่มเป็นภาษาไทยพร้อมคำภาษาอังกฤษที่เทียบเท่าไว้ในวงเล็บ

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

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

¹ การผสานรวม Waterfall อยู่ในรุ่นเบต้าแบบปิด โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อขอสิทธิ์เข้าถึง

ข้อกำหนด

• Android API ระดับ 21 ขึ้นไป

• Google Mobile Ads SDK เวอร์ชันล่าสุด

• สื่อกลางเสร็จสมบูรณ์ คู่มือเริ่มต้นใช้งาน

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

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

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

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

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

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

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

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

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

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

จดรหัสช่องไว้

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

ลงชื่อเข้าใช้บัญชี Ad Manager

เพิ่มบรรทัดในบริษัท

เปิดใช้การแชร์สัญญาณที่ปลอดภัย

กำหนดค่าการเสนอราคาตามกลุ่ม

กำหนดค่าการแมปหน่วยโฆษณา

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

การผสานรวม Android Studio (แนะนำ)

ในไฟล์ build.gradle.kts ระดับแอป ให้เพิ่มข้อกําหนดในการนําไปใช้และการกำหนดค่าต่อไปนี้ ใช้ Line SDK และอะแดปเตอร์เวอร์ชันล่าสุด

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.google.ads.mediation:line:2.8.20240827.0")
}

การผสานรวมด้วยตนเอง

1. ดาวน์โหลดไฟล์ .aar ของ Line SDK เวอร์ชันล่าสุด แล้วเพิ่มลงในโปรเจ็กต์

2. ไปที่อาร์ติแฟกต์ของอะแดปเตอร์สายในที่เก็บ Maven ของ Google เลือกเวอร์ชันล่าสุด ดาวน์โหลดไฟล์ .aar ของอะแดปเตอร์ Line แล้วเพิ่มลงในโปรเจ็กต์

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

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

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

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

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

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

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

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

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

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

ตัวแปลงโฆษณา Line รองรับพารามิเตอร์คําขอเพิ่มเติมซึ่งสามารถส่งไปยังตัวแปลงโฆษณาได้โดยใช้คลาส LineExtras ตัวสร้างคลาสนี้มีพารามิเตอร์ต่อไปนี้

enableAdSound

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

ต่อไปนี้เป็นตัวอย่างโค้ดในการสร้างคําขอโฆษณาซึ่งตั้งค่าพารามิเตอร์เหล่านี้

LineExtras lineExtras = new LineExtras(true);
Bundle extras = lineExtras.build();

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(LineMediationAdapter.class, extras)
   .build();

val lineExtras = LineExtras(true)
val extras = lineExtras.build()

val request = AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(LineMediationAdapter::class.java, extras)
   .build()

การใช้โฆษณาเนทีฟ

การแสดงโฆษณา

ตัวแปลงโฆษณาในบรรทัดจะป้อนข้อมูลต่อไปนี้ ช่อง สําหรับ NativeAd

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

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

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

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

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

บันทึกการเปลี่ยนแปลงของ LINE Android Mediation Adapter

เวอร์ชันถัดไป

• ติดตั้งใช้งาน AdLoader เพื่อเปิดใช้ RTB สําหรับโฆษณาแบนเนอร์
• ติดตั้งใช้งาน AdLoader เพื่อเปิดใช้ RTB สําหรับโฆษณาคั่นระหว่างหน้า
• ติดตั้งใช้งาน AdLoader เพื่อเปิดใช้ RTB สําหรับโฆษณาที่มีการให้รางวัล
• ใช้ AdLoader เพื่อเปิดใช้ RTB สําหรับโฆษณาเนทีฟ

เวอร์ชัน 2.8.20240827.0

• ยืนยันความเข้ากันได้กับ FiveAd SDK เวอร์ชัน 2.8.20240827.0

สร้างขึ้นและทดสอบด้วย

• Google Mobile Ads SDK เวอร์ชัน 23.3.0
• FiveAd SDK เวอร์ชัน 2.8.20240827.0

เวอร์ชัน 2.8.20240808.0

• ยืนยันความเข้ากันได้กับ FiveAd SDK เวอร์ชัน 2.8.20240808.0

สร้างขึ้นและทดสอบด้วย

• Google Mobile Ads SDK เวอร์ชัน 23.2.0
• FiveAd SDK เวอร์ชัน 2.8.20240808.0

เวอร์ชัน 2.8.20240722.0

• เข้ากันได้กับ FiveAd SDK เวอร์ชัน 2.8.20240722.0 แล้ว

สร้างขึ้นและทดสอบด้วย

• Google Mobile Ads SDK เวอร์ชัน 23.2.0
• FiveAd SDK เวอร์ชัน 2.8.20240722.0

เวอร์ชัน 2.7.20240515.0

• ยืนยันความเข้ากันได้กับ FiveAd SDK เวอร์ชัน 2.7.20240515.0

สร้างขึ้นและทดสอบด้วย

• Google Mobile Ads SDK เวอร์ชัน 23.1.0
• FiveAd SDK เวอร์ชัน 2.7.20240515.0

เวอร์ชัน 2.7.20240214.1

• อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 23.0.0
• ยืนยันความเข้ากันได้กับ FiveAd SDK เวอร์ชัน 2.7.20240214.0

สร้างขึ้นและทดสอบด้วย

• Google Mobile Ads SDK เวอร์ชัน 23.0.0
• FiveAd SDK เวอร์ชัน 2.7.20240214.0

เวอร์ชัน 2.7.20240214.0

• ยืนยันความเข้ากันได้กับ FiveAd SDK เวอร์ชัน 2.7.20240214.0

สร้างขึ้นและทดสอบด้วย

• Google Mobile Ads SDK เวอร์ชัน 22.6.0
• FiveAd SDK เวอร์ชัน 2.7.20240214.0

เวอร์ชัน 2.7.20240126.0

• ยืนยันความเข้ากันได้กับ FiveAd SDK เวอร์ชัน 2.7.20240126.0

สร้างขึ้นและทดสอบด้วย

• Google Mobile Ads SDK เวอร์ชัน 22.6.0
• FiveAd SDK เวอร์ชัน 2.7.20240126.0

เวอร์ชัน 2.7.20240112.0

• นำ FiveAdViewEventListener ที่เลิกใช้งานแล้วออกแล้วแทนที่ด้วย FiveAdCustomLayoutEventListener, FiveAdVideoRewardEventListener, FiveAdInterstitialEventListener และ FiveAdNativeEventListener
• ยืนยันความเข้ากันได้กับ FiveAd SDK เวอร์ชัน 2.7.20240112
• อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 22.6.0

สร้างขึ้นและทดสอบด้วย

• Google Mobile Ads SDK เวอร์ชัน 22.6.0
• FiveAd SDK เวอร์ชัน 2.7.20240112

เวอร์ชัน 2.6.20230607.1

• เพิ่มคลาส LineExtras ให้ผู้เผยแพร่โฆษณากําหนดการตั้งค่าเสียงเริ่มต้นสําหรับรูปแบบโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า และโฆษณาที่มีการให้รางวัล
• อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 22.4.0

สร้างขึ้นและทดสอบด้วย

• Google Mobile Ads SDK เวอร์ชัน 22.4.0
• FiveAd SDK เวอร์ชัน 2.6.20230607

เวอร์ชัน 2.6.20230607.0

• การเผยแพร่ครั้งแรก
• เพิ่มการรองรับรูปแบบโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า โฆษณาที่มีการให้รางวัล และโฆษณาเนทีฟ
• ยืนยันความเข้ากันได้กับ FiveAd SDK เวอร์ชัน 2.6.20230607

สร้างขึ้นและทดสอบด้วย

• Google Mobile Ads SDK เวอร์ชัน 22.1.0
• FiveAd SDK เวอร์ชัน 2.6.20230607