คู่มือนี้จะแสดงวิธีใช้ Google Mobile Ads SDK เพื่อโหลดและแสดงโฆษณาจาก Liftoff Monetize โดยใช้สื่อกลาง ซึ่งครอบคลุมทั้งการผสานรวมการเสนอราคาและการผสานรวม Waterfall ซึ่งจะอธิบายวิธีเพิ่ม Liftoff Monetize ในการกําหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม Vungle SDK และอะแดปเตอร์ลงในFlutter แอป
การผสานรวมและรูปแบบโฆษณาที่รองรับ
| การผสานรวม | |
|---|---|
| การเสนอราคา | 1 |
| น้ำตก | |
| รูปแบบ | |
| การเปิดแอป | 2 |
| แบนเนอร์ | |
| โฆษณาคั่นระหว่างหน้า | |
| ได้รับรางวัลแล้ว | |
| โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล | |
| เนทีฟ | 2 |
1 การผสานรวมการเสนอราคาอยู่ในช่วงเบต้าแบบเปิด
2 การผสานรวม Waterfall สำหรับรูปแบบนี้อยู่ในเวอร์ชันเบต้าแบบเปิด
ข้อกำหนด
- Google Mobile Ads SDK เวอร์ชันล่าสุด
- Flutter 3.7.0 ขึ้นไป
- วิธีติดตั้งใช้งานใน Android
- Android API ระดับ 21 ขึ้นไป
- วิธีติดตั้งใช้งานใน iOS
- เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
- Flutter โปรเจ็กต์ที่ทํางานได้ซึ่งกําหนดค่าด้วย Google Mobile Ads SDK ดูรายละเอียดได้ที่เริ่มต้นใช้งาน
- สื่อกลางเสร็จสมบูรณ์ คู่มือเริ่มต้นใช้งาน
ขั้นตอนที่ 1: ตั้งค่าการกําหนดค่าใน UI การสร้างรายได้ของ Liftoff
ลงชื่อสมัครใช้หรือเข้าสู่ระบบบัญชี Liftoff Monetize
เพิ่มแอปลงในแดชบอร์ดการสร้างรายได้ของ Liftoff โดยคลิกปุ่มเพิ่มแอปพลิเคชัน
กรอกแบบฟอร์มโดยใส่รายละเอียดที่จำเป็นทั้งหมด
Android
iOS
เมื่อสร้างแอปแล้ว ให้เลือกแอปจากแดชบอร์ดแอปพลิเคชัน Liftoff Monetize
Android
iOS
จดบันทึกรหัสแอป
Android
iOS
เพิ่มตําแหน่งใหม่
หากต้องการสร้างตําแหน่งใหม่เพื่อใช้กับสื่อกลาง AdMob ให้ไปที่แดชบอร์ดตําแหน่งการสร้างรายได้ของ Liftoff คลิกปุ่มเพิ่มตําแหน่ง แล้วเลือกแอปจากรายการแบบเลื่อนลง
รายละเอียดในการเพิ่มตําแหน่งใหม่มีดังนี้
การเปิดแอป
เลือกโฆษณาคั่นระหว่างหน้า แล้วป้อนชื่อตำแหน่งโฆษณา จากนั้นเลือกใช่สำหรับข้ามได้ แล้วกรอกข้อมูลที่เหลือในแบบฟอร์ม [การเสนอราคาเท่านั้น] ในส่วนการสร้างรายได้ ให้สลับสวิตช์การเสนอราคาในแอปเป็นเปิดใช้ คลิกปุ่มต่อไปที่ด้านล่างของหน้าเพื่อสร้างตําแหน่ง
แบนเนอร์
เลือกแบนเนอร์ ป้อนชื่อตําแหน่ง แล้วกรอกข้อมูลที่เหลือในแบบฟอร์ม [การเสนอราคาเท่านั้น] ในส่วนการสร้างรายได้ ให้สลับสวิตช์การเสนอราคาในแอปเป็นเปิดใช้ คลิกปุ่มต่อไปที่ด้านล่างของหน้าเพื่อสร้างตําแหน่งโฆษณา
แบนเนอร์ 300x250
เลือก MREC ป้อนชื่อตำแหน่งโฆษณา แล้วกรอกข้อมูลที่เหลือในแบบฟอร์ม [การเสนอราคาเท่านั้น] ในส่วนการสร้างรายได้ ให้สลับสวิตช์การเสนอราคาในแอปเป็นเปิดใช้ คลิกปุ่มต่อไปที่ด้านล่างของหน้าเพื่อสร้างตําแหน่งโฆษณา
โฆษณาคั่นระหว่างหน้า
เลือกโฆษณาคั่นระหว่างหน้า ป้อนชื่อตำแหน่งโฆษณา แล้วกรอกข้อมูลที่เหลือในแบบฟอร์ม [การเสนอราคาเท่านั้น] ในส่วนการสร้างรายได้ ให้สลับสวิตช์การเสนอราคาในแอปเป็นเปิดใช้ คลิกปุ่มต่อไปที่ด้านล่างของหน้าเพื่อสร้างตําแหน่งโฆษณา
ได้รับรางวัลแล้ว
เลือกมีการให้รางวัล ป้อนชื่อตำแหน่งโฆษณา แล้วกรอกข้อมูลที่เหลือในแบบฟอร์ม [การเสนอราคาเท่านั้น] ในส่วนการสร้างรายได้ ให้สลับสวิตช์การเสนอราคาในแอปเป็นเปิดใช้ คลิกปุ่มต่อไปที่ด้านล่างของหน้าเพื่อสร้างตําแหน่งโฆษณา
โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล
เลือกมีการให้รางวัล ป้อนชื่อตำแหน่งโฆษณา เปิดใช้ข้ามได้ แล้วกรอกข้อมูลที่เหลือในแบบฟอร์ม [การเสนอราคาเท่านั้น] ในส่วนการสร้างรายได้ ให้สลับการเสนอราคาในแอปเป็นเปิดใช้ คลิกปุ่มต่อไปที่ด้านล่างของหน้าเพื่อสร้างตําแหน่งโฆษณา
เนทีฟ
เลือกเนทีฟ ป้อนชื่อตำแหน่ง แล้วกรอกข้อมูลที่เหลือในแบบฟอร์ม [การเสนอราคาเท่านั้น] ในส่วนการสร้างรายได้ ให้สลับสวิตช์การเสนอราคาในแอปเป็นเปิดใช้ คลิกปุ่มต่อไปที่ด้านล่างของหน้าเพื่อสร้างตําแหน่งโฆษณา
จดรหัสอ้างอิงไว้ แล้วคลิกตกลง
การเปิดแอป
แบนเนอร์
แบนเนอร์ 300x250
โฆษณาคั่นระหว่างหน้า
ได้รับรางวัลแล้ว
โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล
เนทีฟ
ค้นหาคีย์ Reporting API
การเสนอราคา
ขั้นตอนนี้ไม่จําเป็นสำหรับการผสานรวมการเสนอราคา
น้ำตก
นอกจากรหัสแอปและรหัสอ้างอิงแล้ว คุณจะต้องมีคีย์ Reporting API ของ Liftoff Monetize เพื่อตั้งค่ารหัสหน่วยโฆษณา AdMob ด้วย ไปที่แดชบอร์ดรายงานของ Liftoff Monetize แล้วคลิกปุ่มคีย์ Reporting API เพื่อดูคีย์ Reporting API
เปิดโหมดทดสอบ
หากต้องการเปิดใช้โฆษณาทดสอบ ให้ไปที่แดชบอร์ด Liftoff Monetize แล้วไปที่แอปพลิเคชัน
เลือกแอปที่ต้องการเปิดใช้โฆษณาทดสอบในส่วนรหัสอ้างอิงตําแหน่งโฆษณาของแอป คุณสามารถเปิดใช้โฆษณาทดสอบได้โดยเลือกโหมดทดสอบเป็นแสดงโฆษณาทดสอบเท่านั้นในส่วนสถานะ
Android
iOS
ขั้นตอนที่ 2: ตั้งค่าดีมานด์การสร้างรายได้ของ Liftoff ใน Ad Manager UI
กำหนดการตั้งค่าสื่อกลางสําหรับหน่วยโฆษณา
Android
โปรดดูวิธีการที่ขั้นตอนที่ 2 ในคู่มือสำหรับ Android
iOS
ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสำหรับ iOS
เพิ่ม Liftoff ลงในรายการพาร์ทเนอร์โฆษณาตาม GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกา
ทําตามขั้นตอนในการตั้งค่า GDPR และการตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกาเพื่อเพิ่ม Liftoff ลงในรายชื่อพาร์ทเนอร์โฆษณา GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกาใน UI ของ AdMob
ขั้นตอนที่ 3: นําเข้า Vungle SDK และอะแดปเตอร์การสร้างรายได้ของ Liftoff
การผสานรวมผ่าน pub.dev
เพิ่ม Dependency ต่อไปนี้ด้วยLiftoff Monetize SDK และอะแดปเตอร์เวอร์ชันล่าสุดในไฟล์pubspec.yamlของแพ็กเกจ
dependencies:
gma_mediation_liftoffmonetize: ^1.0.0
การผสานรวมด้วยตนเอง
ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณา Google Mobile เวอร์ชันล่าสุดสําหรับ Liftoff Monetize แตกไฟล์ที่ดาวน์โหลดมา และเพิ่มโฟลเดอร์ปลั๊กอินที่แตกไฟล์แล้ว (และเนื้อหาในโฟลเดอร์) ลงในโปรเจ็กต์ Flutter จากนั้นอ้างอิงปลั๊กอินในไฟล์ pubspec.yaml โดยเพิ่มข้อกําหนดต่อไปนี้
dependencies:
gma_mediation_liftoffmonetize:
path: path/to/local/package
ขั้นตอนที่ 4: ใช้การตั้งค่าความเป็นส่วนตัวใน Liftoff Monetize SDK
ความยินยอมของ EU และ GDPR
ภายใต้นโยบายความยินยอมของผู้ใช้ EU ของ Google คุณต้องเปิดเผยข้อมูลบางอย่างแก่ผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA) และต้องได้รับความยินยอมจากผู้ใช้เกี่ยวกับการใช้ตัวระบุอุปกรณ์และข้อมูลส่วนตัว นโยบายนี้เป็นผลมาจากข้อกำหนดด้าน ePrivacy และกฎระเบียบให้ความคุ้มครองข้อมูลส่วนบุคคลของผู้บริโภค (GDPR) ของสหภาพยุโรป เมื่อขอความยินยอม คุณต้องระบุเครือข่ายโฆษณาแต่ละเครือข่ายในเชนสื่อกลางที่อาจรวบรวม รับ หรือใช้ข้อมูลส่วนตัว และให้ข้อมูลเกี่ยวกับการใช้ของแต่ละเครือข่าย ปัจจุบัน Google ไม่สามารถส่งตัวเลือกความยินยอมของผู้ใช้ไปยังเครือข่ายดังกล่าวโดยอัตโนมัติ
ปลั๊กอินสื่อกลาง Google Mobile Ads สําหรับ Liftoff Monetize มีวิธีการ GmaMediationLiftoffmonetize.setGDPRStatus() โค้ดตัวอย่างต่อไปนี้แสดงวิธีส่งข้อมูลความยินยอมไปยัง Vungle SDK หากเลือกที่จะเรียกใช้เมธอดนี้ เราขอแนะนําให้เรียกใช้ก่อนส่งคําขอโฆษณาผ่าน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google
import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...
GmaMediationLiftoffmonetize.setGDPRStatus(true, "1.0.0");
ดูรายละเอียดเพิ่มเติมและค่าที่ระบุได้ในเมธอดได้จากวิธีการติดตั้งใช้งานที่แนะนำของ GDPR สำหรับ Android และ iOS
กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา
กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา กำหนดให้ผู้ใช้มีสิทธิเลือกไม่รับ "การขาย" "ข้อมูลส่วนบุคคล" (ตามที่กฎหมายให้คำจำกัดความไว้) โดยเว็บไซต์จะต้องให้ตัวเลือกไม่รับการขายผ่านลิงก์ "ไม่อนุญาตให้ขายข้อมูลส่วนบุคคลของฉัน" ที่แสดงไว้อย่างชัดเจนบนหน้าแรกของฝ่ายที่ทำ "การขาย" คู่มือการปฏิบัติตามกฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกาช่วยให้คุณเปิดใช้การประมวลผลข้อมูลแบบจำกัดสําหรับการแสดงโฆษณาของ Google ได้ แต่ Google ไม่สามารถใช้การตั้งค่านี้กับเครือข่ายโฆษณาแต่ละเครือข่ายในเชนสื่อกลาง ดังนั้น คุณต้องระบุเครือข่ายโฆษณาแต่ละเครือข่ายในเชนสื่อกลางที่อาจมีส่วนร่วมในการขายข้อมูลส่วนบุคคล และทำตามคำแนะนำจากเครือข่ายแต่ละเครือข่ายเพื่อให้เป็นไปตามข้อกําหนด
ปลั๊กอินสื่อกลาง Google Mobile Ads สําหรับ Liftoff Monetize มีวิธีการ GmaMediationLiftoffmonetize.setCCPAStatus() โค้ดตัวอย่างต่อไปนี้แสดงวิธีส่งข้อมูลความยินยอมไปยัง Vungle SDK หากเลือกที่จะเรียกใช้เมธอดนี้ เราขอแนะนําให้เรียกใช้ก่อนส่งคําขอโฆษณาผ่าน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google
import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...
GmaMediationLiftoffmonetize.setCCPAStatus(true);
ดูรายละเอียดเพิ่มเติมและค่าที่ระบุได้ในวิธีการติดตั้งใช้งานที่ CCPA แนะนำสำหรับ Android และ iOS
ขั้นตอนที่ 5: เพิ่มโค้ดที่จำเป็น
Android
การผสานรวม Liftoff Monetize ไม่จำเป็นต้องใช้โค้ดเพิ่มเติม
iOS
การผสานรวม SKAdNetwork
ทำตามเอกสารประกอบของ Liftoff Monetize เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist ของโปรเจ็กต์
ขั้นตอนที่ 6: ทดสอบการใช้งาน
เปิดใช้โฆษณาทดสอบ
อย่าลืมลงทะเบียนอุปกรณ์ทดสอบสำหรับ AdMob และเปิดใช้โหมดทดสอบใน UI การสร้างรายได้ของ Liftoff
ยืนยันโฆษณาทดสอบ
หากต้องการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก Liftoff Monetize (การเสนอราคา) และ Liftoff Monetize (Waterfall) ให้เปิดใช้การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียวในเครื่องมือตรวจสอบโฆษณา
รหัสข้อผิดพลาด
หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก Liftoff Monetize ผู้เผยแพร่โฆษณาจะตรวจสอบข้อผิดพลาดพื้นฐานจากการตอบกลับโฆษณาได้โดยใช้ ResponseInfo ในคลาสต่อไปนี้
Android
| รูปแบบ | ชื่อชั้นเรียน |
|---|---|
| โฆษณาเปิดแอป (การเสนอราคา) | com.google.ads.mediation.vungle.VungleMediationAdapter |
| การเปิดแอป (Waterfall) | com.google.ads.mediation.vungle.VungleMediationAdapter |
| แบนเนอร์ (การเสนอราคา) | com.google.ads.mediation.vungle.VungleMediationAdapter |
| แบนเนอร์ (การแสดงโฆษณาตามลำดับขั้น) | com.vungle.mediation.VungleInterstitialAdapter |
| โฆษณาคั่นระหว่างหน้า (การเสนอราคา) | com.google.ads.mediation.vungle.VungleMediationAdapter |
| โฆษณาคั่นระหว่างหน้า (Waterfall) | com.vungle.mediation.VungleInterstitialAdapter |
| ให้รางวัล (การเสนอราคา) | com.google.ads.mediation.vungle.VungleMediationAdapter |
| มีการให้รางวัล (Waterfall) | com.vungle.mediation.VungleAdapter |
| โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล (การเสนอราคา) | com.google.ads.mediation.vungle.VungleMediationAdapter |
| โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล (Waterfall) | com.google.ads.mediation.vungle.VungleMediationAdapter |
iOS
| รูปแบบ | ชื่อชั้นเรียน |
|---|---|
| โฆษณาเปิดแอป (การเสนอราคา) | GADMediationAdapterVungle |
| การเปิดแอป (Waterfall) | GADMediationAdapterVungle |
| แบนเนอร์ (การเสนอราคา) | GADMediationAdapterVungle |
| แบนเนอร์ (การแสดงโฆษณาตามลำดับขั้น) | GADMAdapterVungleInterstitial |
| โฆษณาคั่นระหว่างหน้า (การเสนอราคา) | GADMediationAdapterVungle |
| โฆษณาคั่นระหว่างหน้า (Waterfall) | GADMAdapterVungleInterstitial |
| ให้รางวัล (การเสนอราคา) | GADMediationAdapterVungle |
| มีการให้รางวัล (Waterfall) | GADMAdapterVungleRewardBasedVideoAd |
| โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล (การเสนอราคา) | GADMediationAdapterVungle |
| โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล (Waterfall) | GADMediationAdapterVungle |
ต่อไปนี้คือรหัสและข้อความที่มาพร้อมกับข้อผิดพลาดที่แสดงโดยอะแดปเตอร์การสร้างรายได้ของ Liftoff เมื่อโฆษณาโหลดไม่สำเร็จ
Android
| รหัสข้อผิดพลาด | เหตุผล |
|---|---|
| 101 | พารามิเตอร์เซิร์ฟเวอร์ไม่ถูกต้อง (เช่น รหัสแอปหรือรหัสตําแหน่งโฆษณา) |
| 102 | ขนาดแบนเนอร์ที่ขอไม่ตรงกับขนาดโฆษณา Liftoff Monetize ที่ถูกต้อง |
| 103 | Liftoff Monetize ต้องใช้Activityบริบทเพื่อขอโฆษณา
|
| 104 | Vungle SDK โหลดโฆษณาหลายรายการสําหรับรหัสตําแหน่งเดียวกันไม่ได้ |
| 105 | Vungle SDK เริ่มต้นไม่สำเร็จ |
| 106 | Vungle SDK แสดงการเรียกกลับการโหลดที่สำเร็จ แต่ Banners.getBanner() หรือ Vungle.getNativeAd() แสดงผลลัพธ์เป็น Null |
| 107 | Vungle SDK ไม่พร้อมที่จะเล่นโฆษณา |
| 108 | Vungle SDK ส่งคืนโทเค็นการเสนอราคาที่ไม่ถูกต้อง |
iOS
| รหัสข้อผิดพลาด | เหตุผล |
|---|---|
| 101 | พารามิเตอร์เซิร์ฟเวอร์ไม่ถูกต้อง (เช่น รหัสแอปหรือรหัสตําแหน่งโฆษณา) |
| 102 | โหลดโฆษณาสําหรับการกําหนดค่าเครือข่ายนี้แล้ว Vungle SDK โหลดโฆษณาที่ 2 สําหรับรหัสตําแหน่งเดียวกันไม่ได้ |
| 103 | ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ Liftoff Monetize รองรับ |
| 104 | Vungle SDK แสดงผลโฆษณาแบนเนอร์ไม่ได้ |
| 105 | Vungle SDK รองรับการโหลดโฆษณาแบนเนอร์ได้ครั้งละ 1 รายการเท่านั้น ไม่ว่ารหัสตําแหน่งโฆษณาจะเป็นอย่างไรก็ตาม |
| 106 | Vungle SDK ส่งการเรียกกลับที่ระบุว่าเล่นโฆษณาไม่ได้ |
| 107 | Vungle SDK ไม่พร้อมที่จะเล่นโฆษณา |
สําหรับข้อผิดพลาดที่มาจาก Vungle SDK โปรดดูรหัสข้อผิดพลาด: Vungle SDK สําหรับ iOS และ Android
บันทึกการเปลี่ยนแปลงของอะแดปเตอร์สื่อกลาง Flutter ของ Liftoff Monetize
เวอร์ชันถัดไป
- สร้างและทดสอบด้วยปลั๊กอิน Flutter ของ Google Mobile Ads เวอร์ชัน 5.2.0
เวอร์ชัน 1.1.0
- ยืนยันความเข้ากันได้กับอะแดปเตอร์ Android ของ Liftoff Monetize เวอร์ชัน 7.4.0.1
- ยืนยันความเข้ากันได้กับอะแดปเตอร์ iOS เวอร์ชัน 7.4.0.1 ของ LiftoffMonetize
- สร้างขึ้นและทดสอบด้วยปลั๊กอิน Flutter ของ Google Mobile Ads เวอร์ชัน 5.1.0
เวอร์ชัน 1.0.0
- การเผยแพร่ครั้งแรก
- ยืนยันความเข้ากันได้กับอะแดปเตอร์ Android ของ Liftoff Monetize เวอร์ชัน 7.3.1.0
- ยืนยันความเข้ากันได้กับอะแดปเตอร์ iOS เวอร์ชัน 7.3.2.0 ของ LiftoffMonetize
- สร้างขึ้นและทดสอบด้วยปลั๊กอิน Flutter ของ Google Mobile Ads เวอร์ชัน 5.1.0