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

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

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

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

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

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

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

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

ข้อกำหนด

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

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

注册或登录您的 Liftoff Monetize 帐号。

点击添加应用按钮，将您的应用添加到 Liftoff Monetize 信息中心。

填写表单，输入所有必填的详细信息。

Android

iOS

创建应用后，从 Liftoff Monetize Applications 信息中心选择您的应用。

Android

iOS

记下应用 ID。

Android

iOS

添加新的展示位置

如需创建要与 AdMob中介结合使用的新展示位置，请前往 Liftoff“Monetize Placement”信息中心，点击添加展示位置按钮，然后从下拉列表中选择您的应用。

有关添加新展示位置的详情，请参见下文：

打开应用

选择插页式，然后输入展示位置名称。然后，针对可跳过选择是，并填写表单的其余部分。[仅出价] 在创收下，将应用内出价开关切换为已启用。点击页面底部的继续按钮以创建展示位置。

选择横幅，输入展示位置名称，然后填写表单的其余部分。[仅出价] 在创收下，将应用内出价开关切换为已启用。点击页面底部的继续按钮创建展示位置。

选择 MREC，输入展示位置名称，然后填写表单的其余部分。[仅出价] 在创收下，将应用内出价开关切换为已启用。点击页面底部的继续按钮创建展示位置。

插页式广告

选择 插页式广告，输入展示位置名称，然后填写表单的其余部分。[仅出价] 在创收下，将应用内出价开关切换为已启用。点击页面底部的继续按钮以创建展示位置。

已奖励

选择激励广告，输入展示位置名称并填写表单的其余部分。[仅出价] 在创收下，将应用内出价开关切换为已启用。点击页面底部的继续按钮创建展示位置。

插页式激励广告

选择激励广告。输入展示位置名称，启用可跳过并填写表单的其余部分。[仅出价] 在创收下，将应用内出价开关切换为已启用。点击页面底部的继续按钮以创建展示位置。

原生

选择原生，输入展示位置名称，然后填写表单的其余部分。[仅出价] 在创收下，将应用内出价开关切换为已启用。点击页面底部的继续按钮创建展示位置。

记下参考 ID，然后点击听起来不错。

打开应用

横幅

300 x 250 横幅

插页式广告

已奖励

插页式激励广告

原生

找到您的 Reporting API 密钥

出价

出价集成不需要执行此步骤。

瀑布

除了应用 ID 和参考 ID 之外，您还需要 Liftoff Monetize Reporting API 密钥才能设置AdMob 广告单元 ID。前往 Liftoff Monetize Reports 信息中心，然后点击 Reporting API Key 按钮，查看您的 Reporting API Key。

开启测试模式

如需启用测试广告，请转到 Liftoff Monetize 信息中心并导航到 Applications。

在应用的展示位置参考 ID 部分下，选择要启用测试广告的应用。在状态部分下，将测试模式选为仅显示测试广告即可启用测试广告。

Android

iOS

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

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

Android

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

iOS

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

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

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 ส่ง 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