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

เลือกแพลตฟอร์ม: Android iOS Unity Flutter Android (เดิม)

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

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

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

ข้อกำหนดเบื้องต้น

ก่อนดำเนินการต่อ ให้ตรวจสอบสิ่งต่อไปนี้

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

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

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

    เพิ่มแอปของคุณลงในแดชบอร์ด Liftoff Monetize โดยคลิกปุ่มเพิ่มแอปพลิเคชัน

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

    Android

    iOS

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

    Android

    iOS

    จดบันทึกรหัสแอป

    Android

    iOS

    เพิ่มตําแหน่งโฆษณาใหม่

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

    รายละเอียดการเพิ่มตําแหน่งโฆษณาใหม่มีดังนี้

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

    แบนเนอร์ขนาด 300x250

    เลือก MREC ป้อนชื่อตําแหน่งโฆษณา แล้วกรอกข้อมูลในแบบฟอร์มส่วนที่เหลือ [การเสนอราคาเท่านั้น] ในส่วนการสร้างรายได้ ให้สลับสวิตช์การเสนอราคาในแอป เป็นเปิดใช้ คลิกปุ่มต่อไปที่ด้านล่างของหน้า เพื่อสร้างตําแหน่งโฆษณา

    โฆษณาคั่นระหว่างหน้า

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

    ได้รับรางวัลแล้ว

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

    โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล

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

    เนทีฟ

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

    จดรหัสอ้างอิง แล้วคลิกตกลง

    แบนเนอร์ขนาด 300x250

    โฆษณาคั่นระหว่างหน้า

    ได้รับรางวัลแล้ว

    โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล

    เนทีฟ

    ค้นหาคีย์ Reporting API

    การเสนอราคา

    ขั้นตอนนี้ไม่จำเป็นสำหรับการผสานรวมการเสนอราคา

    การแสดงวิดีโอตามลำดับขั้น

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

    อัปเดต app-ads.txt

    ผู้ขายที่ได้รับอนุญาตสำหรับแอปหรือ app-ads.txt เป็นความคิดริเริ่มของ IAB Tech Lab ที่ช่วยตรวจสอบว่าคุณจะขายพื้นที่โฆษณาในแอปผ่านช่องทางที่คุณได้รับอนุญาตเท่านั้น คุณจะต้องใช้ไฟล์ app-ads.txt เพื่อป้องกันไม่ให้เสียรายได้จากโฆษณาเป็นจำนวนมาก หากยังไม่ได้ดำเนินการ ให้สร้างไฟล์ app-ads.txt สำหรับ Ad Manager

    หากต้องการใช้ app-ads.txt สำหรับ Liftoff Monetize ให้ดาวน์โหลดและต่อท้ายรายการ app-ads.txt ของ Liftoff Monetize ในไฟล์ app-ads.txt ที่มีอยู่ ดูข้อมูลเพิ่มเติมได้ที่ app-ads.txt

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

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

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

    Android

    iOS

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

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

    Android

    ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสำหรับ Android

    iOS

    ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสำหรับ iOS

    เพิ่ม Liftoff ลงในรายชื่อพาร์ทเนอร์โฆษณาตาม GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกา

    ทําตามขั้นตอนใน การตั้งค่ากฎระเบียบของยุโรป และ การตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกา เพื่อเพิ่ม Liftoff ลงใน รายชื่อพาร์ทเนอร์โฆษณาที่ปฏิบัติตามกฎระเบียบของยุโรปและรัฐในสหรัฐอเมริกาใน UI ของ Ad Manager

    ขั้นตอนที่ 3: นำเข้า SDK และอะแดปเตอร์ Liftoff Monetize

    การผสานรวมผ่าน pub.dev

    เพิ่มทรัพยากร Dependency ต่อไปนี้พร้อมกับ Liftoff Monetize SDK และอะแดปเตอร์เวอร์ชันล่าสุดในไฟล์ pubspec.yaml ของแพ็กเกจ

    dependencies:
  gma_mediation_liftoffmonetize: ^1.5.5

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

    ดาวน์โหลดปลั๊กอินสื่อกลาง Google Mobile Ads สำหรับ Liftoff Monetize เวอร์ชันล่าสุด แตกไฟล์ที่ดาวน์โหลดมา แล้วเพิ่มโฟลเดอร์ปลั๊กอินที่แตกออกมา (และเนื้อหาของโฟลเดอร์) ลงในโปรเจ็กต์ Flutter จากนั้นอ้างอิงปลั๊กอินในไฟล์ pubspec.yaml โดยเพิ่มทรัพยากร Dependency ต่อไปนี้

    dependencies:
  gma_mediation_liftoffmonetize:
    path: path/to/local/package

    ขั้นตอนที่ 4: ใช้การตั้งค่าความเป็นส่วนตัวใน SDK ของ Liftoff Monetize

    หากต้องการปฏิบัติตาม นโยบายความยินยอมของผู้ใช้ EU ของ Google คุณต้องเปิดเผยข้อมูลบางอย่างต่อ ผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA), สหราชอาณาจักร และสวิตเซอร์แลนด์ รวมถึงขอรับ ความยินยอมจากผู้ใช้สำหรับการใช้คุกกี้หรือพื้นที่เก็บข้อมูลอื่นๆ ในเครื่องตามที่กฎหมาย กำหนด และสำหรับการเก็บรวบรวม แชร์ และใช้ข้อมูลส่วนตัวเพื่อการปรับโฆษณา ตามโปรไฟล์ของผู้ใช้ นโยบายนี้เป็นผลมาจากข้อกำหนดด้าน ePrivacy และกฎระเบียบให้ความคุ้มครองข้อมูลส่วนบุคคลของผู้บริโภค (GDPR) ของสหภาพยุโรป คุณมีหน้าที่ ตรวจสอบว่ามีการส่งต่อความยินยอมไปยังแหล่งที่มาของโฆษณาแต่ละแห่งใน เชนสื่อกลาง (Mediation Chain)

    ตั้งแต่ Liftoff Monetize ปลั๊กอิน Flutter เวอร์ชัน 1.1.0 เป็นต้นไป Liftoff Monetize จะอ่านความยินยอมตาม GDPR ที่กำหนดโดยแพลตฟอร์มการจัดการความยินยอม ซึ่งรองรับข้อกำหนดความยินยอมเพิ่มเติมของ Google รวมถึง UMP SDK โดยอัตโนมัติ ดูข้อมูลเพิ่มเติมได้ที่ วิธีการใช้งานที่แนะนําของ GDPR สําหรับ Android และ iOS

    กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา

    กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา กำหนดให้ผู้ใช้มีสิทธิ เลือกไม่รับ "การขาย" "ข้อมูลส่วนบุคคล" (ตามที่กฎหมายให้คำจำกัดความ ไว้) โดยเว็บไซต์จะต้องให้ตัวเลือกไม่รับการขายผ่านลิงก์ "ไม่อนุญาตให้ขายข้อมูลส่วนบุคคลของฉัน" ที่แสดงไว้อย่างชัดเจนบนหน้าแรกของฝ่ายที่ทำ "การขาย" คู่มือการปฏิบัติตามกฎหมายความเป็นส่วนตัวของรัฐในสหรัฐอเมริกาช่วยให้คุณเปิดใช้การประมวลผลข้อมูลแบบจำกัด สำหรับการแสดงโฆษณา Google ได้ แต่ Google ไม่สามารถใช้การตั้งค่านี้กับเครือข่ายโฆษณาแต่ละเครือข่ายในเชนสื่อกลาง ดังนั้น คุณต้องระบุเครือข่ายโฆษณาแต่ละเครือข่าย ในเชนสื่อกลางที่อาจเข้าร่วมในการขายข้อมูลส่วนบุคคล และปฏิบัติตามคำแนะนำจากแต่ละเครือข่ายเพื่อให้มั่นใจ ว่าเป็นไปตามข้อกำหนด

    ปลั๊กอินสื่อกลาง Google Mobile Ads สำหรับ Liftoff Monetize มีเมธอด GmaMediationLiftoffmonetize.setCCPAStatus() โค้ดตัวอย่างต่อไปนี้แสดงวิธีส่งข้อมูลความยินยอมไปยัง Liftoff Monetize SDK หากเลือกเรียกใช้เมธอดนี้ เราขอแนะนำให้เรียกใช้ก่อนที่จะขอโฆษณาผ่าน Google Mobile Ads Flutter Plugin

    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: ทดสอบการติดตั้งใช้งาน

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

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

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

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

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

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

    Android

    รูปแบบ ชื่อประเภท
    โฆษณาเปิดแอป (การเสนอราคา) com.google.ads.mediation.vungle.VungleMediationAdapter
    โฆษณาเปิดแอป (การแสดงวิดีโอตามลำดับขั้น) com.google.ads.mediation.vungle.VungleMediationAdapter
    แบนเนอร์ (การเสนอราคา) com.google.ads.mediation.vungle.VungleMediationAdapter
    แบนเนอร์ (การแสดงวิดีโอตามลำดับขั้น) com.vungle.mediation.VungleInterstitialAdapter
    โฆษณาคั่นระหว่างหน้า (การเสนอราคา) com.google.ads.mediation.vungle.VungleMediationAdapter
    โฆษณาคั่นระหว่างหน้า (การแสดงวิดีโอตามลำดับขั้น) com.vungle.mediation.VungleInterstitialAdapter
    มีการให้รางวัล (การเสนอราคา) com.google.ads.mediation.vungle.VungleMediationAdapter
    มีการให้รางวัล (การแสดงวิดีโอตามลำดับขั้น) com.vungle.mediation.VungleAdapter
    โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล (การเสนอราคา) com.google.ads.mediation.vungle.VungleMediationAdapter
    โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล (การแสดงวิดีโอตามลำดับขั้น) com.google.ads.mediation.vungle.VungleMediationAdapter

    iOS

    รูปแบบ ชื่อประเภท
    โฆษณาเปิดแอป (การเสนอราคา) GADMediationAdapterVungle
    โฆษณาเปิดแอป (การแสดงวิดีโอตามลำดับขั้น) GADMediationAdapterVungle
    แบนเนอร์ (การเสนอราคา) GADMediationAdapterVungle
    แบนเนอร์ (การแสดงวิดีโอตามลำดับขั้น) GADMAdapterVungleInterstitial
    โฆษณาคั่นระหว่างหน้า (การเสนอราคา) GADMediationAdapterVungle
    โฆษณาคั่นระหว่างหน้า (การแสดงวิดีโอตามลำดับขั้น) GADMAdapterVungleInterstitial
    ที่มีการให้รางวัล (การเสนอราคา) GADMediationAdapterVungle
    มีการให้รางวัล (การแสดงวิดีโอตามลำดับขั้น) GADMAdapterVungleRewardBasedVideoAd
    โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล (การเสนอราคา) GADMediationAdapterVungle
    โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล (การแสดงวิดีโอตามลำดับขั้น) GADMediationAdapterVungle

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

    Android

    รหัสข้อผิดพลาด เหตุผล
    101 พารามิเตอร์เซิร์ฟเวอร์ไม่ถูกต้อง (เช่น รหัสแอปหรือรหัสตำแหน่งโฆษณา)
    102 ขนาดแบนเนอร์ที่ขอไม่ตรงกับขนาดโฆษณา Liftoff Monetize ที่ถูกต้อง
    103 Liftoff Monetize ต้องมีบริบท Activity เพื่อขอ โฆษณา
    104 Vungle SDK ไม่สามารถโหลดโฆษณาหลายรายการสำหรับรหัสตำแหน่งโฆษณาเดียวกัน
    105 เริ่มต้นใช้งาน Vungle SDK ไม่สำเร็จ
    106 Vungle SDK แสดงผล Callback การโหลดที่สําเร็จ แต่ 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 ส่ง Callback ที่ระบุว่าโฆษณาเล่นไม่ได้
    107 Vungle SDK ยังไม่พร้อมเล่นโฆษณา

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

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

    เวอร์ชัน 1.5.5

    เวอร์ชัน 1.5.4

    เวอร์ชัน 1.5.3

    รุ่น 1.5.2

    รุ่น 1.5.1

    เวอร์ชัน 1.5.0

    เวอร์ชัน 1.4.3

    เวอร์ชัน 1.4.2

    • อัปเดตเวอร์ชัน Flutter ขั้นต่ำเป็น 3.35.1
    • อัปเดตเพื่อรองรับปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 7.0.0

    เวอร์ชัน 1.4.1

    เวอร์ชัน 1.4.0

    เวอร์ชัน 1.3.0

    เวอร์ชัน 1.2.3

    เวอร์ชัน 1.2.2

    เวอร์ชัน 1.2.1

    เวอร์ชัน 1.2.0

    เวอร์ชัน 1.1.1

    เวอร์ชัน 1.1.0

    เวอร์ชัน 1.0.0