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

หมายเหตุ: Vungle เปลี่ยนชื่อเป็น Liftoff Monetize แล้ว

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

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

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

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

² โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัลต้องการความช่วยเหลือในการตั้งค่า ติดต่อผู้จัดการฝ่ายดูแลลูกค้าที่ Liftoff Monetize หรือ [e-mail]

ข้อกำหนด

• 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

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

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

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

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

แบนเนอร์

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

แบนเนอร์ 300x250

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

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

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

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

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

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

หมายเหตุ: โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัลต้องการความช่วยเหลือในการตั้งค่า โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าที่ Liftoff Monetize หรือ [e-mail]

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

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

เนทีฟ

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

หมายเหตุ: ปุ่มสลับการเสนอราคาในแอปจะใช้ไม่ได้กับโฆษณาเนทีฟโดยค่าเริ่มต้น หากต้องการเปิดใช้ โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้า Liftoff Monetize

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

แบนเนอร์

แบนเนอร์ 300x250

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

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

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

เนทีฟ

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

การเสนอราคา

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

น้ำตก

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

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

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

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

Android

iOS

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

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

Android

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

iOS

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

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

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

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

หมายเหตุ: การไม่สามารถผสานรวมเวอร์ชัน SDK โฆษณา Google Mobile และ Vungle ที่เข้ากันได้อาจทำให้เกิดปัญหาในบิลด์

การผสานรวมผ่าน 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: ทดสอบการใช้งาน

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

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

สำคัญ: ปิดใช้โหมดทดสอบสำหรับ Ad Manager และ Liftoff Monetize ก่อนเปิดตัวแอป

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

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

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

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

iOS

รูปแบบ	ชื่อชั้นเรียน
แบนเนอร์	GADMAdapterVungleInterstitial
โฆษณาคั่นระหว่างหน้า	GADMAdapterVungleInterstitial
ได้รับรางวัลแล้ว	โฆษณาวิดีโอตามรูปแบบวิดีโอ GADMอะแดปเตอร์VungleReward

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

iOS

รหัสข้อผิดพลาด	เหตุผล
1-100	Vungle SDK แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมในรหัส
101	พารามิเตอร์เซิร์ฟเวอร์ Liftoff Monetize ที่กำหนดค่าใน Ad Manager 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