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

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

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

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

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

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

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

ข้อกำหนด

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

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

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

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

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

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

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

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

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

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

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

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

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

หมายเหตุ: ติดต่อผู้จัดการฝ่ายดูแลลูกค้าของเครือข่ายโฆษณาในไลน์เพื่อรับสิทธิ์เข้าถึงการสร้างตําแหน่งโฆษณาเนทีฟใน UI ของ Line

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

ขั้นตอนที่ 2: ตั้งค่าดีมานด์โฆษณาใน UI ของ AdMob

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

คุณต้องเพิ่ม Line ลงในการกำหนดค่าสื่อกลางสําหรับหน่วยโฆษณา

ก่อนอื่น ให้ลงชื่อเข้าใช้บัญชี AdMob จากนั้นไปที่แท็บสื่อกลาง หากมีกลุ่มสื่อกลางที่มีอยู่ซึ่งต้องการแก้ไข ให้คลิกชื่อกลุ่มสื่อกลางนั้นเพื่อแก้ไข แล้วข้ามไปเพิ่ม Line เป็นแหล่งที่มาของโฆษณา

หากต้องการสร้างกลุ่มสื่อกลางใหม่ ให้เลือกสร้างกลุ่มสื่อกลาง

ป้อนรูปแบบโฆษณาและแพลตฟอร์ม แล้วคลิกต่อไป

ตั้งชื่อกลุ่มสื่อกลาง แล้วเลือกสถานที่ที่จะกําหนดเป้าหมาย ถัดไป ให้ตั้งค่าสถานะกลุ่มสื่อกลางเป็นเปิดใช้ แล้วคลิกเพิ่มหน่วยโฆษณา

เชื่อมโยงกลุ่มสื่อกลางนี้กับหน่วยโฆษณา AdMob ที่มีอยู่อย่างน้อย 1 หน่วย จากนั้นคลิกเสร็จสิ้น

ตอนนี้คุณควรเห็นการ์ดหน่วยโฆษณาที่สร้างขึ้นด้วยหน่วยโฆษณาที่คุณเลือก

เพิ่ม Line เป็นแหล่งที่มาของโฆษณา

การเสนอราคา

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

สำคัญ: รหัสแอปพลิเคชันต้องเชื่อมโยงกับแอปเป้าหมายเช่นเดียวกับใน UI ของ Line

น้ำตก

เลือกเพิ่มแหล่งที่มาของโฆษณาในการ์ด Waterfall ในส่วนแหล่งที่มาของโฆษณา จากนั้นเลือกเส้น

เลือกบรรทัด จากนั้นป้อนค่า eCPM สำหรับบรรทัด แล้วคลิกต่อไป

หมายเหตุ: คุณตั้งค่าการเพิ่มประสิทธิภาพแหล่งที่มาของโฆษณาได้เพียงครั้งเดียวต่อเครือข่าย

หากมีการแมปสำหรับ Line อยู่แล้ว ให้เลือกการแมปนั้น หรือคลิกเพิ่มการแมป

จากนั้นป้อนรหัสแอปพลิเคชันและรหัสช่องที่ได้ในส่วนก่อนหน้า จากนั้นคลิกเสร็จสิ้น

สำคัญ: ต้องเชื่อมโยงรหัสแอปพลิเคชันกับแอปเป้าหมายเช่นเดียวกับใน UI ของ Line

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

หมายเหตุ: การผสานรวมเวอร์ชัน Line และ Google Mobile Ads SDK ที่เข้ากันได้ไม่สำเร็จอาจทําให้เกิดปัญหาการสร้าง

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

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

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

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

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

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

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

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

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

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

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

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

สำคัญ: ปิดใช้โหมดทดสอบสำหรับ AdMob และ Line ก่อนเผยแพร่แอป

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

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

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

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

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

enableAdSound

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

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

Java

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

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

Kotlin

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

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

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

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

ตัวแปลงโฆษณาบรรทัดจะป้อนข้อมูลคำอธิบายช่องขั้นสูงของโฆษณาเนทีฟต่อไปนี้สำหรับ NativeAd

ช่อง	ชิ้นงานที่อะแดปเตอร์บรรทัดรวมไว้เสมอ
บรรทัดแรก
รูปภาพ
เนื้อความ
ไอคอนแอป	^1
คำกระตุ้นการตัดสินใจ
การให้ดาว
ร้านค้า
ราคา

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

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

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

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

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

รหัสข้อผิดพลาด	โดเมน	เหตุผล
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	ขนาดโฆษณาที่ขอไม่ตรงกับขนาดโฆษณาแบนเนอร์ที่ Line รองรับ
104	com.google.ads.mediation.line	โหลดโฆษณาคั่นระหว่างหน้าหรือโฆษณาที่มีการให้รางวัลไม่สำเร็จเนื่องจากไม่มีบริบทกิจกรรม
105	com.google.ads.mediation.line	Line SDK แสดงโฆษณาคั่นระหว่างหน้าหรือโฆษณาที่มีการให้รางวัลไม่สำเร็จ
106	com.google.ads.mediation.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