หน้านี้ได้รับการแปลโดย Cloud Translation API

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

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

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

การผสานรวม
การเสนอราคา
น้ำตก
รูปแบบ
การเปิดแอป	^{1, 2}
ป้ายประกาศ	¹
โฆษณาคั่นระหว่างหน้า
ได้รับรางวัลแล้ว
โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล	¹
เนทีฟ	^{1, 2}

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

² การผสานรวมการแสดงโฆษณาสื่อกลางตามลำดับขั้นสำหรับรูปแบบนี้อยู่ในเวอร์ชันเบต้าแบบเปิด

ข้อกำหนด

Google Mobile Ads SDK เวอร์ชันล่าสุด
Flutter 3.7.0 ขึ้นไป
[สําหรับการเสนอราคา]: หากต้องการผสานรวมรูปแบบโฆษณาที่รองรับทั้งหมดในการเสนอราคา ให้ใช้ปลั๊กอินสื่อกลาง Google Ads สําหรับ AppLovin 5.1.0 ขึ้นไป (แนะนําให้ใช้เวอร์ชันล่าสุด)
วิธีทำให้ใช้งานได้ใน Android
- Android API ระดับ 21 ขึ้นไป
วิธีติดตั้งใช้งานใน iOS
- เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
โปรเจ็กต์ Flutter ที่ใช้งานได้ซึ่งกําหนดค่าด้วย Google Mobile Ads SDK ดูรายละเอียดได้ที่เริ่มต้นใช้งาน
สื่อกลางเสร็จสมบูรณ์ คู่มือเริ่มต้นใช้งาน

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

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

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

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

AndroidiOS

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

AndroidiOS

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

AndroidiOS

เพิ่มตําแหน่งใหม่

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

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

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

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

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

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

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

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

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

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

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

การเปิดแอปป้ายประกาศแบนเนอร์ 300x250โฆษณาคั่นระหว่างหน้าได้รับรางวัลแล้วโฆษณาคั่นระหว่างหน้าที่มีการให้รางวัลเนทีฟ

ค้นหาคีย์ Reporting API

การเสนอราคาน้ำตก

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

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

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

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

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

AndroidiOS

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

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

AndroidiOS

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

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

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

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

ขั้นตอนที่ 3: นําเข้า Vungle SDK และอะแดปเตอร์การสร้างรายได้ของ Liftoff

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

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

dependencies:
  gma_mediation_liftoffmonetize: ^1.1.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 iOS

การผสานรวม Liftoff Monetize ไม่จำเป็นต้องใช้โค้ดเพิ่มเติม

การผสานรวม SKAdNetwork

ทำตามเอกสารประกอบของ Liftoff Monetize เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist ของโปรเจ็กต์

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

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

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

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

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

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

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

AndroidiOS

รูปแบบ	ชื่อชั้นเรียน
โฆษณาเปิดแอป (การเสนอราคา)	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

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

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

AndroidiOS

รหัสข้อผิดพลาด	เหตุผล
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 ส่งคืนโทเค็นการเสนอราคาที่ไม่ถูกต้อง

รหัสข้อผิดพลาด	เหตุผล
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

1.1.0

ตอนนี้ปลั๊กอิน iOS เป็นเฟรมเวิร์กแบบคงที่
ยืนยันความเข้ากันได้กับอะแดปเตอร์ Android ของ Liftoff Monetize เวอร์ชัน 7.4.3.0
ยืนยันความเข้ากันได้กับอะแดปเตอร์ iOS ของ Liftoff Monetize เวอร์ชัน 7.4.4.0
สร้างและทดสอบด้วยปลั๊กอิน Flutter ของ Google Mobile Ads เวอร์ชัน 5.3.1

1.0.0

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