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

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

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

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

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

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

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

³ การผสานรวม Waterfall สําหรับรูปแบบนี้อยู่ในเวอร์ชันเบต้าแบบปิด

ข้อกำหนด

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

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

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

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

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

Android

iOS

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

Android

iOS

จดรหัสแอป

Android

iOS

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

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

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

การเปิดแอป

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

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

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

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

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

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

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

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

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

เนทีฟ

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

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

การเปิดแอป

แบนเนอร์

แบนเนอร์ 300x250

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

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

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

เนทีฟ

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

การเสนอราคา

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

น้ำตก

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

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

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

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

Android

iOS

ขั้นตอนที่ 2: ตั้งค่าความต้องการสร้างรายได้จาก Liftoff ใน AdMob UI

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

Android

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

iOS

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

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

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

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

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

เพิ่มทรัพยากร Dependency ต่อไปนี้ด้วย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 หากคุณเลือกเรียกใช้วิธีการนี้ ขอแนะนำให้เรียกใช้ก่อนที่จะขอโฆษณาผ่าน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google

import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...

GmaMediationLiftoffmonetize.setGDPRStatus(true, "1.0.0");

ดูรายละเอียดเพิ่มเติมและค่าต่างๆ ที่ระบุได้ในวิธีการใช้งานที่ GDPR แนะนำสำหรับ Android และ iOS

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

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

ปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google สำหรับ 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 และเปิดใช้โหมดทดสอบใน 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 ส่งโค้ดเรียกกลับว่าโฆษณาเล่นไม่ได้

Liftoff Monetize Monetize Monetization Mediation Adapter เปลี่ยนแปลงบันทึก

เวอร์ชัน 1.0.0

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