คู่มือนี้แสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดง โฆษณาจาก Liftoff Monetize โดยใช้ สื่อกลาง ซึ่งครอบคลุมทั้งการเสนอราคาและ การผสานรวม Waterfall ซึ่งครอบคลุมถึงวิธีเพิ่ม Liftoff Monetize ไปยังหน่วยโฆษณา การกำหนดค่าสื่อกลาง และวิธีผสานรวม Vungle SDK และอะแดปเตอร์เข้ากับ Flutter แอป
การผสานรวมและรูปแบบโฆษณาที่รองรับ
การผสานรวม | |
---|---|
การเสนอราคา | |
น้ำตก | |
รูปแบบ | |
การเปิดแอป | 1 3 |
แบนเนอร์ | 2 |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว | |
โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล | 2 |
1 การเสนอราคา การผสานรวมสำหรับรูปแบบนี้อยู่ในรุ่นเบต้าแบบปิด
2 การเสนอราคา สำหรับรูปแบบนี้อยู่ในเวอร์ชันเบต้าแบบเปิด
3 การแสดงวิดีโอตามลำดับขั้น การผสานรวมสำหรับรูปแบบนี้อยู่ในรุ่นเบต้าแบบปิด
ข้อกำหนด
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุด
- Flutter 3.7.0 ขึ้นไป
- เพื่อทำให้ใช้งานได้ใน Android
- API ของ Android ระดับ 21 ขึ้นไป
- เพื่อทำให้ใช้งานได้บน iOS
- เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
- โครงการ Flutter ที่ใช้งานได้ซึ่งกำหนดค่าด้วย SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google โปรดดู เริ่มต้นใช้งานเพื่อดูรายละเอียด
- ดำเนินการสื่อกลางให้เสร็จสิ้น คู่มือเริ่มต้นใช้งาน
ขั้นตอนที่ 1: ตั้งการกำหนดค่าใน UI การสร้างรายได้ของ Liftoff
ลงชื่อสมัครใช้หรือเข้าสู่ระบบบัญชี Liftoff Monetize
เพิ่มแอปลงในหน้าแดชบอร์ดการสร้างรายได้ของ Liftoff โดยคลิกปุ่มเพิ่มแอปพลิเคชัน
กรอกแบบฟอร์มโดยป้อนรายละเอียดที่จำเป็นทั้งหมด
Android
iOS
เมื่อสร้างแอปแล้ว ให้เลือกแอปจากแดชบอร์ดแอปพลิเคชันการสร้างรายได้ของ Liftoff
Android
iOS
จดรหัสแอป
Android
iOS
เพิ่มตำแหน่งใหม่
หากต้องการสร้างตำแหน่งใหม่ที่จะใช้กับ AdMob สื่อกลาง ให้ไปที่ แดชบอร์ดการสร้างรายได้ของ Liftoff คลิกปุ่มเพิ่มตำแหน่ง แล้วเลือกแอปของคุณจากรายการแบบเลื่อนลง
รายละเอียดสำหรับการเพิ่มตำแหน่งใหม่มีดังนี้:
การเปิดแอป
เลือกโฆษณาคั่นระหว่างหน้า แล้วป้อนชื่อตำแหน่ง จากนั้นเลือกใช่สำหรับข้ามได้ และกรอกข้อมูลในแบบฟอร์มส่วนที่เหลือ [การเสนอราคาเท่านั้น] ในส่วนการสร้างรายได้ ให้สลับสวิตช์การเสนอราคาในแอปเป็นเปิดใช้ คลิกปุ่มต่อไปที่ด้านล่างของหน้าเพื่อสร้างตำแหน่ง
แบนเนอร์
เลือกแบนเนอร์ ป้อนชื่อตำแหน่ง และกรอกข้อมูลในแบบฟอร์มส่วนที่เหลือ [การเสนอราคาเท่านั้น] ในส่วนการสร้างรายได้ ให้สลับการเสนอราคาในแอปเป็นเปิดใช้ คลิกปุ่มดำเนินการต่อที่ด้านล่างของหน้าเพื่อสร้างตำแหน่ง
แบนเนอร์ 300x250
เลือก MREC ป้อนชื่อตำแหน่ง และกรอกแบบฟอร์มที่เหลือ [การเสนอราคาเท่านั้น] ในส่วนการสร้างรายได้ ให้สลับการเสนอราคาในแอปเป็นเปิดใช้ คลิกปุ่มดำเนินการต่อที่ด้านล่างของหน้าเพื่อสร้างตำแหน่ง
โฆษณาคั่นระหว่างหน้า
เลือกโฆษณาคั่นระหว่างหน้า ป้อนชื่อตำแหน่ง และกรอกข้อมูลในแบบฟอร์มส่วนที่เหลือ [การเสนอราคาเท่านั้น] ในส่วนการสร้างรายได้ ให้สลับสวิตช์การเสนอราคาในแอปเป็นเปิดใช้ คลิกปุ่มดำเนินการต่อที่ด้านล่างของหน้าเพื่อสร้างตำแหน่ง
ได้รับรางวัลแล้ว
เลือกโฆษณาที่มีการให้รางวัล ป้อนชื่อตำแหน่ง แล้วกรอกแบบฟอร์มที่เหลือ [การเสนอราคาเท่านั้น] ในส่วนการสร้างรายได้ ให้สลับการเสนอราคาในแอปเป็นเปิดใช้ คลิกปุ่มดำเนินการต่อที่ด้านล่างของหน้าเพื่อสร้างตำแหน่ง
โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล
เลือกโฆษณาที่มีการให้รางวัล ป้อนชื่อตำแหน่งโฆษณา เปิดใช้ข้ามได้ และกรอกข้อมูลในแบบฟอร์มส่วนที่เหลือ [การเสนอราคาเท่านั้น] ในส่วนการสร้างรายได้ ให้สลับสวิตช์การเสนอราคาในแอปเป็นเปิดใช้ คลิกปุ่มต่อไปที่ด้านล่างของหน้าเพื่อสร้างตำแหน่ง
เนทีฟ
เลือกโฆษณาเนทีฟ ป้อนชื่อตำแหน่ง และกรอกข้อมูลในส่วนที่เหลือของแบบฟอร์ม [การเสนอราคาเท่านั้น] ในส่วนการสร้างรายได้ ให้สลับการเสนอราคาในแอปเป็นเปิดใช้ คลิกปุ่มดำเนินการต่อที่ด้านล่างของหน้าเพื่อสร้างตำแหน่ง
จดรหัสอ้างอิงไว้ แล้วคลิกเสียงดี
การเปิดแอป
แบนเนอร์
แบนเนอร์ 300x250
โฆษณาคั่นระหว่างหน้า
ได้รับรางวัลแล้ว
โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล
เนทีฟ
ค้นหาคีย์ API การรายงาน
การเสนอราคา
ขั้นตอนนี้ไม่จำเป็นสำหรับการผสานรวมการเสนอราคา
น้ำตก
นอกเหนือจากรหัสแอปและรหัสอ้างอิงแล้ว คุณยังต้องใช้คีย์ API การรายงาน Liftoff Monetize เพื่อตั้งค่าAdMob รหัสหน่วยโฆษณาด้วย ไปที่หน้าแดชบอร์ดรายงานการสร้างรายได้ของ Liftoff และคลิกปุ่มคีย์ API การรายงานเพื่อดูคีย์ API การรายงาน
เปิดโหมดทดสอบ
หากต้องการเปิดใช้โฆษณาทดสอบ ให้ไปที่หน้าแดชบอร์ดการสร้างรายได้ของ Liftoff และไปที่แอปพลิเคชัน
เลือกแอปที่คุณต้องการเปิดใช้โฆษณาทดสอบในส่วน รหัสอ้างอิงตำแหน่งของแอป เปิดใช้โฆษณาทดสอบได้โดยเลือกโหมดทดสอบเพื่อแสดงโฆษณาทดสอบเท่านั้นในส่วนสถานะ
Android
iOS
ขั้นตอนที่ 2: ตั้งค่า Liftoff Monetize ใน AdMob UI
กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา
Android
ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสําหรับ Android
iOS
โปรดดูวิธีการในขั้นตอนที่ 2 ในคู่มือสำหรับ iOS
เพิ่ม Liftoff ลงในรายชื่อพาร์ทเนอร์โฆษณาตาม GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกา
ทำตามขั้นตอนใน การตั้งค่า GDPR และ การตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกา เพื่อเพิ่ม Liftoff ลงในรายชื่อพาร์ทเนอร์โฆษณาตามกฎระเบียบ GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกาใน AdMob
ขั้นตอนที่ 3: นำเข้า Vungle SDK และอะแดปเตอร์ Liftoff Monetize
การผสานรวมผ่าน pub.dev
เพิ่มการอ้างอิงต่อไปนี้ด้วยเวอร์ชันล่าสุดของ
Liftoff Monetize SDK และอะแดปเตอร์ในแพ็กเกจ
ไฟล์ pubspec.yaml
:
dependencies:
gma_mediation_liftoffmonetize: ^1.0.0
การผสานรวมด้วยตนเอง
ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุดสำหรับ
Liftoff Monetize
แยกไฟล์ที่ดาวน์โหลด และเพิ่มโฟลเดอร์ปลั๊กอินที่ดึงมา
(และเนื้อหาภายใน) ลงในโปรเจ็กต์ Flutter ของคุณ จากนั้นให้อ้างอิงปลั๊กอินใน
pubspec.yaml
ด้วยการเพิ่มทรัพยากร Dependency ต่อไปนี้
dependencies:
gma_mediation_liftoffmonetize:
path: path/to/local/package
ขั้นตอนที่ 4: ใช้การตั้งค่าความเป็นส่วนตัวใน Liftoff Monetize SDK
ความยินยอมของสหภาพยุโรปและ GDPR
ภายใต้ความยินยอมของผู้ใช้ EU ของ Google คุณต้องตรวจสอบว่าได้มีการเปิดเผยข้อมูลบางอย่าง และ ความยินยอมที่ได้รับจาก ผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA) เกี่ยวกับ การใช้ตัวระบุอุปกรณ์และข้อมูลส่วนตัว นโยบายนี้เป็นไปตาม ข้อกำหนดด้าน ePrivacy และการคุ้มครองข้อมูลทั่วไปของสหภาพยุโรป กฎระเบียบ (GDPR) เมื่อขอความยินยอม คุณต้องระบุเครือข่ายโฆษณาแต่ละเครือข่าย ในเชนสื่อกลางที่อาจรวบรวม ได้รับ หรือใช้ข้อมูลส่วนตัว และ ให้ข้อมูลเกี่ยวกับการใช้งานของแต่ละเครือข่าย ขณะนี้ Google ไม่สามารถ ส่งตัวเลือกความยินยอมของผู้ใช้ไปยังเครือข่ายดังกล่าวโดยอัตโนมัติ
ปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google สำหรับ Liftoff Monetize ประกอบด้วย
GmaMediationLiftoffmonetize.setGDPRStatus()
วิธี โค้ดตัวอย่างต่อไปนี้
แสดงวิธีส่งข้อมูลความยินยอมไปยัง Vungle SDK หากคุณเลือกที่จะ
เรียกใช้วิธีนี้ ขอแนะนำให้เรียกใช้ก่อนที่จะส่งคำขอโฆษณาผ่าน
Google Mobile Ads SDK
import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...
GmaMediationLiftoffmonetize.setGDPRStatus(true, "1.0.0");
ดูวิธีการนำไปใช้ที่ GDPR แนะนำสำหรับ Android และ iOS สำหรับรายละเอียดเพิ่มเติม และค่าที่ระบุไว้ในเมธอด
กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา
สหรัฐอเมริกา กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐ ต้องให้ผู้ใช้ได้รับ เพื่อเลือกไม่ใช้ "การลดราคา" ของ "ข้อมูลส่วนบุคคล" (ตามที่กฎหมายให้คำจำกัดความ ข้อกำหนดดังกล่าว) โดยการเลือกไม่ใช้ที่นำเสนอผ่านโฆษณาว่า "อย่าขายข้อมูลส่วนบุคคลของฉัน" ที่เห็นได้ชัด ข้อมูล" ลิงก์ในหน้า "การขาย" หน้าแรกของพรรคการเมือง สหรัฐอเมริกา สถานะความเป็นส่วนตัว คู่มือการปฏิบัติตามกฎหมายช่วยให้คุณ การประมวลผลข้อมูลแบบจำกัด สําหรับการแสดงโฆษณาของ Google แต่ Google ใช้การตั้งค่านี้กับโฆษณาแต่ละรายการไม่ได้ เครือข่ายในเชนสื่อกลาง (Mediation Chain) ดังนั้น คุณต้องระบุเครือข่ายโฆษณาแต่ละเครือข่าย ในเชนสื่อกลางที่สามารถเข้าร่วมการขาย และปฏิบัติตามคำแนะนำ จากเครือข่ายเหล่านั้นแต่ละเครือข่ายเพื่อ การปฏิบัติตามข้อกำหนด
ปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google สำหรับ Liftoff Monetize ประกอบด้วย
GmaMediationLiftoffmonetize.setCCPAStatus()
วิธี โค้ดตัวอย่างต่อไปนี้
แสดงวิธีส่งข้อมูลความยินยอมไปยัง Vungle SDK หากคุณเลือกที่จะ
เรียกใช้วิธีนี้ ขอแนะนำให้เรียกใช้ก่อนที่จะส่งคำขอโฆษณาผ่าน
Google Mobile Ads SDK
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 และเปิดใช้โหมดทดสอบใน Liftoff Monetize UI
ยืนยันโฆษณาทดสอบ
ในการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก Liftoff Monetize ให้เปิดใช้ การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้ Liftoff Monetize (Bidding) and Liftoff Monetize (Waterfall) แหล่งที่มาของโฆษณา
รหัสข้อผิดพลาด
หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก Liftoff Monetize ผู้เผยแพร่โฆษณาสามารถ
ตรวจสอบข้อผิดพลาดที่แท้จริงจากการตอบกลับโฆษณา
ResponseInfo
ภายใต้ชั้นเรียนต่อไปนี้
iOS
รูปแบบ | ชื่อชั้นเรียน |
---|---|
แบนเนอร์ | GADMAdapterVungleInterstitial |
โฆษณาคั่นระหว่างหน้า | GADMAdapterVungleInterstitial |
ได้รับรางวัลแล้ว | GADMAdapterVungleRewardBasedVideoAd |
รหัสและข้อความประกอบที่ส่งมาจาก Liftoff Monetize มีดังนี้ อะแดปเตอร์เมื่อโฆษณาโหลดไม่สำเร็จ
iOS
รหัสข้อผิดพลาด | เหตุผล |
---|---|
1-100 | Vungle SDK แสดงข้อผิดพลาด ดูรหัส เพื่อดูรายละเอียดเพิ่มเติม |
101 | พารามิเตอร์เซิร์ฟเวอร์ Liftoff Monetize ที่กำหนดค่าใน AdMob UI ขาดหายไป/ไม่ถูกต้อง |
102 | โหลดโฆษณาสำหรับการกำหนดค่าเครือข่ายนี้แล้ว Vungle SDK โหลดโฆษณารายการที่ 2 สำหรับรหัสตำแหน่งเดียวกันไม่ได้ |
103 | ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่รองรับ Liftoff Monetize |
104 | Vungle SDK แสดงผลโฆษณาแบนเนอร์ไม่ได้ |
105 | Vungle SDK รองรับการโหลดโฆษณาแบนเนอร์ 1 รายการต่อครั้งเท่านั้น โดยไม่คำนึงถึงรหัสตำแหน่ง |
106 | Vungle SDK ส่ง Callback ที่ระบุว่าโฆษณาเล่นไม่ได้ |
บันทึกการเปลี่ยนแปลงอะแดปเตอร์สื่อกลาง Flutter ของ Liftoff Monetize
เวอร์ชัน 1.0.0
- การเผยแพร่ครั้งแรก
- ยืนยันความเข้ากันได้กับอะแดปเตอร์ Liftoff Monetize Android เวอร์ชัน 7.3.1.0
- ตรวจสอบความเข้ากันได้กับอะแดปเตอร์ LiftoffMonetize iOS เวอร์ชัน 7.3.2.0 แล้ว
- สร้างและทดสอบด้วย Google Mobile Ads Flutter Plugin เวอร์ชัน 5.1.0