ผสานรวม Liftoff สร้างรายได้ด้วยสื่อกลาง

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

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

¹ การเสนอราคา การผสานรวมสำหรับรูปแบบนี้อยู่ในรุ่นเบต้าแบบปิด

² การเสนอราคา สำหรับรูปแบบนี้อยู่ในเวอร์ชันเบต้าแบบเปิด

³ การแสดงวิดีโอตามลำดับขั้น การผสานรวมสำหรับรูปแบบนี้อยู่ในรุ่นเบต้าแบบปิด

ข้อกำหนด

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

ขั้นตอนที่ 1: ตั้งการกำหนดค่าใน UI การสร้างรายได้ของ Liftoff

ลงชื่อสมัครใช้หรือเข้าสู่ระบบบัญชี Liftoff Monetize

เพิ่มแอปลงในหน้าแดชบอร์ดการสร้างรายได้ของ Liftoff โดยคลิกปุ่มเพิ่มแอปพลิเคชัน

กรอกแบบฟอร์มโดยป้อนรายละเอียดที่จำเป็นทั้งหมด

เมื่อสร้างแอปแล้ว ให้เลือกแอปจากแดชบอร์ดแอปพลิเคชันการสร้างรายได้ของ Liftoff

จดรหัสแอป

เพิ่มตำแหน่งใหม่

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

รายละเอียดสำหรับการเพิ่มตำแหน่งใหม่มีดังนี้:

จดรหัสอ้างอิงไว้ แล้วคลิกเสียงดี

ค้นหาคีย์ API การรายงาน

เปิดโหมดทดสอบ

หากต้องการเปิดใช้โฆษณาทดสอบ ให้ไปที่หน้าแดชบอร์ดการสร้างรายได้ของ Liftoff และไปที่แอปพลิเคชัน

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

ขั้นตอนที่ 2: ตั้งค่า Liftoff Monetize ใน AdMob UI

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

เพิ่ม 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 Mobile Ads สําหรับ 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: เพิ่มโค้ดที่จําเป็น

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

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

อย่าลืม ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ AdMob และเปิดใช้โหมดทดสอบใน Liftoff Monetize UI

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

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

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

หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก Liftoff Monetize ผู้เผยแพร่โฆษณาสามารถ ตรวจสอบข้อผิดพลาดที่แท้จริงจากการตอบกลับโฆษณา ResponseInfo ภายใต้ชั้นเรียนต่อไปนี้

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

สำหรับข้อผิดพลาดที่มาจาก Vungle SDK โปรดดูรหัสข้อผิดพลาด: Vungle SDK สำหรับ iOS และ Android

บันทึกการเปลี่ยนแปลงอะแดปเตอร์สื่อกลาง Flutter ของ Liftoff Monetize

เวอร์ชัน 1.0.0

• การเผยแพร่ครั้งแรก
• ยืนยันความเข้ากันได้กับอะแดปเตอร์ Liftoff Monetize Android เวอร์ชัน 7.3.1.0
• ยืนยันความเข้ากันได้กับอะแดปเตอร์ iOS เวอร์ชัน 7.3.2.0 ของ LiftoffMonetize
• สร้างและทดสอบด้วย Google Mobile Ads Flutter Plugin เวอร์ชัน 5.1.0