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

ข้อกำหนดเบื้องต้น
ก่อนดำเนินการต่อ ให้ทำดังนี้
- ติดตั้งปลั๊กอิน Flutter เวอร์ชัน 0.13.6 ขึ้นไป
- ตั้งค่าGoogle Mobile Ads Flutter Plugin แอป Flutter ของคุณต้องมีการนำเข้า Google Mobile Ads Flutter Plugin
ทดสอบด้วยโฆษณาทดสอบเสมอ
เมื่อสร้างและทดสอบแอป โปรดใช้โฆษณาทดสอบแทนโฆษณาจริง หากไม่ปฏิบัติตาม อาจทำให้บัญชีของคุณถูกระงับ
วิธีที่ง่ายที่สุดในการโหลดโฆษณาทดสอบคือการใช้รหัสหน่วยโฆษณาทดสอบเฉพาะสำหรับโฆษณาที่มีการให้รางวัลใน Android และ iOS ดังนี้
/21775744923/example/app-open
รหัสเหล่านี้ได้รับการกำหนดค่าเป็นพิเศษให้แสดงโฆษณาทดสอบสำหรับทุกคำขอ และคุณสามารถใช้รหัสเหล่านี้ในแอปของคุณเองได้อย่างอิสระขณะเขียนโค้ด ทดสอบ และแก้ไขข้อบกพร่อง เพียงตรวจสอบว่าคุณได้แทนที่รหัสเหล่านี้ด้วยรหัสหน่วยโฆษณาของคุณเองก่อนที่จะเผยแพร่แอป
การใช้งาน
ขั้นตอนหลักในการผสานรวมโฆษณาเปิดแอปมีดังนี้
- สร้างคลาสยูทิลิตีที่จะโหลดโฆษณาก่อนที่คุณจะแสดงโฆษณา
- โหลดโฆษณา
- ลงทะเบียนเพื่อรับการเรียกกลับและแสดงโฆษณา
- สมัครใช้บริการ
AppStateEventNotifier.appStateStreamเพื่อแสดงโฆษณาในระหว่างเหตุการณ์การนำแอปมาไว้เบื้องหน้า
สร้างคลาสยูทิลิตี
สร้างคลาสใหม่ชื่อ AppOpenAdManager เพื่อโหลดโฆษณา คลาสนี้จะจัดการตัวแปรอินสแตนซ์เพื่อติดตามโฆษณาที่โหลดแล้วและรหัสหน่วยโฆษณาสำหรับแต่ละแพลตฟอร์ม
import 'package:google_mobile_ads/google_mobile_ads.dart';
import 'dart:io' show Platform;
class AppOpenAdManager {
String adUnitId = '/21775744923/example/app-open';
AppOpenAd? _appOpenAd;
bool _isShowingAd = false;
/// Load an AppOpenAd.
void loadAd() {
// We will implement this below.
}
/// Whether an ad is available to be shown.
bool get isAdAvailable {
return _appOpenAd != null;
}
}
โหลดโฆษณา
โฆษณาเปิดแอปต้องพร้อมแสดงก่อนที่ผู้ใช้จะเข้าแอปของคุณ ให้ติดตั้งใช้งานคลาสยูทิลิตีเพื่อส่งคำขอโฆษณาล่วงหน้าก่อนที่คุณจะต้องการแสดงโฆษณา
การโหลดโฆษณาทำได้โดยใช้เมธอด loadWithAdManagerAdRequest ในคลาส AppOpenAd เมธอดโหลดต้องใช้รหัสหน่วยโฆษณา โหมดการวางแนว ออบเจ็กต์ AdManagerAdRequest และตัวแฮนเดิลการเสร็จสมบูรณ์ซึ่งจะเรียกใช้เมื่อโหลดโฆษณาสำเร็จหรือไม่สำเร็จ ระบบจะระบุออบเจ็กต์ AppOpenAd ที่โหลดแล้วเป็นพารามิเตอร์ในตัวแฮนเดิลการเสร็จสมบูรณ์ ตัวอย่างต่อไปนี้แสดงวิธีโหลด AppOpenAd
public class AppOpenAdManager {
...
/// Load an AppOpenAd.
void loadAd() {
AppOpenAd.loadWithAdManagerAdRequest(
adUnitId: adUnitId,
adManagerAdRequest: AdManagerAdRequest(),
adLoadCallback: AppOpenAdLoadCallback(
onAdLoaded: (ad) {
_appOpenAd = ad;
},
onAdFailedToLoad: (error) {
print('AppOpenAd failed to load: $error');
// Handle the error.
},
),
);
}
}
แสดงโฆษณาและจัดการการเรียกกลับแบบเต็มหน้าจอ
ก่อนแสดงโฆษณา ให้ลงทะเบียน FullScreenContentCallback สำหรับเหตุการณ์โฆษณาแต่ละรายการที่คุณต้องการรอรับ
public class AppOpenAdManager {
...
public void showAdIfAvailable() {
if (!isAdAvailable) {
print('Tried to show ad before available.');
loadAd();
return;
}
if (_isShowingAd) {
print('Tried to show ad while already showing an ad.');
return;
}
// Set the fullScreenContentCallback and show the ad.
_appOpenAd!.fullScreenContentCallback = FullScreenContentCallback(
onAdShowedFullScreenContent: (ad) {
_isShowingAd = true;
print('$ad onAdShowedFullScreenContent');
},
onAdFailedToShowFullScreenContent: (ad, error) {
print('$ad onAdFailedToShowFullScreenContent: $error');
_isShowingAd = false;
ad.dispose();
_appOpenAd = null;
},
onAdDismissedFullScreenContent: (ad) {
print('$ad onAdDismissedFullScreenContent');
_isShowingAd = false;
ad.dispose();
_appOpenAd = null;
loadAd();
},
);
}
}
หากผู้ใช้กลับมาที่แอปของคุณหลังจากออกจากแอปโดยคลิกโฆษณาเปิดแอป ให้ตรวจสอบว่าระบบไม่ได้แสดงโฆษณาเปิดแอปอื่นให้ผู้ใช้เห็น
รอเหตุการณ์การนำแอปมาไว้เบื้องหน้า
หากต้องการรับการแจ้งเตือนเกี่ยวกับเหตุการณ์การนำแอปมาไว้เบื้องหน้า คุณต้องสมัครใช้บริการ AppStateEventNotifier.appStateStream และรอเหตุการณ์ foreground
import 'package:app_open_example/app_open_ad_manager.dart';
import 'package:google_mobile_ads/google_mobile_ads.dart';
/// Listens for app foreground events and shows app open ads.
class AppLifecycleReactor {
final AppOpenAdManager appOpenAdManager;
AppLifecycleReactor({required this.appOpenAdManager});
void listenToAppStateChanges() {
AppStateEventNotifier.startListening();
AppStateEventNotifier.appStateStream
.forEach((state) => _onAppStateChanged(state));
}
void _onAppStateChanged(AppState appState) {
// Try to show an app open ad if the app is being resumed and
// we're not already showing an app open ad.
if (appState == AppState.foreground) {
appOpenAdManager.showAdIfAvailable();
}
}
}
ตอนนี้คุณสามารถเพิ่มการเริ่มต้น AppLifecycleReactor และเริ่มรอการเปลี่ยนแปลงวงจรการทำงานของแอปได้แล้ว เช่น จากหน้าแรก
import 'package:app_open_example/app_open_ad_manager.dart';
import 'package:flutter/material.dart';
import 'package:google_mobile_ads/google_mobile_ads.dart';
import 'app_lifecycle_reactor.dart';
void main() {
WidgetsFlutterBinding.ensureInitialized();
MobileAds.instance.initialize();
runApp(MyApp());
}
class MyApp extends StatelessWidget {
@override
Widget build(BuildContext context) {
return MaterialApp(
title: 'App Open Example',
theme: ThemeData(
primarySwatch: Colors.blue,
),
home: MyHomePage(title: 'App Open Demo Home Page'),
);
}
}
class MyHomePage extends StatefulWidget {
MyHomePage({Key? key, required this.title}) : super(key: key);
final String title;
@override
_MyHomePageState createState() => _MyHomePageState();
}
/// Example home page for an app open ad.
class _MyHomePageState extends State<MyHomePage> {
int _counter = 0;
late AppLifecycleReactor _appLifecycleReactor;
@override
void initState() {
super.initState();
AppOpenAdManager appOpenAdManager = AppOpenAdManager()..loadAd();
_appLifecycleReactor = AppLifecycleReactor(
appOpenAdManager: appOpenAdManager);
}
พิจารณาการหมดอายุของโฆษณา
หากต้องการให้แน่ใจว่าคุณจะไม่แสดงโฆษณาที่หมดอายุแล้ว ให้เพิ่มการประทับเวลาลงใน AppOpenAdManager เพื่อให้คุณตรวจสอบได้ว่าโฆษณาโหลดมานานเท่าใดแล้ว
จากนั้นใช้การประทับเวลาดังกล่าวเพื่อตรวจสอบว่าโฆษณายังคงมีสิทธิ์แสดงอยู่หรือไม่
/// Utility class that manages loading and showing app open ads.
class AppOpenAdManager {
...
/// Maximum duration allowed between loading and showing the ad.
final Duration maxCacheDuration = Duration(hours: 4);
/// Keep track of load time so we don't show an expired ad.
DateTime? _appOpenLoadTime;
...
/// Load an AppOpenAd.
void loadAd() {
AppOpenAd.loadWithAdManagerAdRequest(
adUnitId: adUnitId,
orientation: AppOpenAd.orientationPortrait,
adManagerAdRequest: AdManagerAdRequest(),
adLoadCallback: AppOpenAdLoadCallback(
onAdLoaded: (ad) {
print('$ad loaded');
_appOpenLoadTime = DateTime.now();
_appOpenAd = ad;
},
onAdFailedToLoad: (error) {
print('AppOpenAd failed to load: $error');
},
),
);
}
/// Shows the ad, if one exists and is not already being shown.
///
/// If the previously cached ad has expired, this just loads and caches a
/// new ad.
void showAdIfAvailable() {
if (!isAdAvailable) {
print('Tried to show ad before available.');
loadAd();
return;
}
if (_isShowingAd) {
print('Tried to show ad while already showing an ad.');
return;
}
if (DateTime.now().subtract(maxCacheDuration).isAfter(_appOpenLoadTime!)) {
print('Maximum cache duration exceeded. Loading another ad.');
_appOpenAd!.dispose();
_appOpenAd = null;
loadAd();
return;
}
// Set the fullScreenContentCallback and show the ad.
_appOpenAd!.fullScreenContentCallback = FullScreenContentCallback(...);
_appOpenAd!.show();
}
}
Cold Start และหน้าจอโหลด
เอกสารนี้สันนิษฐานว่าคุณจะแสดงโฆษณาเปิดแอปก็ต่อเมื่อผู้ใช้นำแอปมาไว้เบื้องหน้าเมื่อแอปถูกระงับในหน่วยความจำ "Cold Start" จะเกิดขึ้นเมื่อมีการเปิดแอปแต่แอปไม่ได้ถูกระงับในหน่วยความจำก่อนหน้านี้
ตัวอย่างของ Cold Start คือเมื่อผู้ใช้เปิดแอปเป็นครั้งแรก ในกรณีของ Cold Start คุณจะไม่มีโฆษณาเปิดแอปที่โหลดไว้ก่อนหน้านี้ซึ่งพร้อมแสดงทันที ความล่าช้าระหว่างเวลาที่คุณส่งคำขอโฆษณาและเวลาที่คุณได้รับโฆษณาคืนมาอาจทำให้เกิดสถานการณ์ที่ผู้ใช้สามารถใช้แอปของคุณได้ชั่วครู่ก่อนที่จะเห็นโฆษณาที่ไม่เกี่ยวข้อง คุณควรหลีกเลี่ยงสถานการณ์นี้เนื่องจากทำให้ผู้ใช้ได้รับประสบการณ์การใช้งานที่ไม่ดี
วิธีที่แนะนำในการใช้โฆษณาเปิดแอปในกรณีของ Cold Start คือการใช้หน้าจอโหลดเพื่อโหลดชิ้นงานของเกมหรือแอป และแสดงโฆษณาจากหน้าจอโหลดเท่านั้น หากแอปโหลดเสร็จแล้วและส่งผู้ใช้ไปยังเนื้อหาหลักของแอป ห้ามแสดงโฆษณา
แนวทางปฏิบัติแนะนำ
โฆษณาเปิดแอปช่วยให้คุณสร้างรายได้จากหน้าจอโหลดของแอป เมื่อเปิดแอปเป็นครั้งแรกและระหว่างการเปลี่ยนแอป แต่คุณต้องคำนึงถึงแนวทางปฏิบัติแนะนำเพื่อให้ผู้ใช้ได้รับประสบการณ์การใช้งานแอปที่ดี โดยแนวทางปฏิบัติแนะนำมีดังนี้
- แสดงโฆษณาเปิดแอปหลังจากที่ผู้ใช้ใช้แอปของคุณ 2-3 ครั้ง
- แสดงโฆษณาเปิดแอปในช่วงเวลาที่ผู้ใช้ต้องรอให้แอปโหลด
- หากคุณมีหน้าจอโหลดอยู่ใต้โฆษณาเปิดแอปและหน้าจอโหลดโหลดเสร็จก่อนที่โฆษณาจะถูกปิด คุณอาจต้องการปิดหน้าจอโหลดในตัวแฮนเดิลเหตุการณ์
onAdDismissedFullScreenContent