Bu kılavuz, uygulama açılış reklamlarını entegre eden yayıncılara yöneliktir.
Uygulama açılış reklamları, para kazanmak isteyen yayıncılara yönelik özel bir reklam biçimidir uygulama yükleme ekranlarına ekleyebilirsiniz. Uygulama açılış reklamları kullanıcılarınız tarafından herhangi bir zamanda kapatılabilir. Uygulama açılış reklamları, kullanıcılar uygulamanızı ön plana getirdiğinde gösterilebilir.
Uygulama açılış reklamları, otomatik olarak küçük bir marka alanı gösterir. Böylece kullanıcılar, uygulamanızın en iyi şekilde yararlanabilirsiniz. Aşağıda uygulama açılış reklamının nasıl göründüğüne ilişkin bir örnek verilmiştir:
Genel olarak, uygulama açılış reklamlarını uygulamak için gereken adımlar şunlardır:
- Bir reklamı görüntülemeniz gerekmeden önce yükleyen bir yönetici sınıfı oluşturun.
- Uygulama ön plan etkinlikleri sırasında reklamı göster.
- Sunu geri çağırma işlemlerini halledin.
Ön koşullar
- Başlarken rehberini inceleyin.
- Cihazınızı test sürümü olarak nasıl yapılandıracağınızı öğrenin cihaz.
Her zaman test reklamlarıyla test etme
Uygulamalarınızı oluştururken ve test ederken, uygulamalarınızın yanı sıra üretim reklamlarıdır. Aksi takdirde hesabınız askıya alınabilir.
Test reklamlarını yüklemenin en kolay yolu, uygulama için özel test reklam birimi kimliğimizi kullanmaktır reklamları aç:
ca-app-pub-3940256099942544/5575463023
Her istek için test reklamları döndürecek şekilde özel olarak yapılandırılmıştır. kod yazma, test etme ve hata ayıklama sırasında kendi uygulamalarınızda kullanabileceğiniz ücretsiz bir araçtır. Sadece uygulamanızı yayınlamadan önce bunu kendi reklam birimi kimliğinizle değiştirdiğinizden emin olun.
Mobile Ads SDK'sının test reklamlarının işleyiş şekli hakkında daha fazla bilgi için Test Reklamlar.
Yönetici sınıfı uygulama
Reklamınız hızlı bir şekilde gösterilmelidir. Bu nedenle, ihtiyaç duymadan önce reklamınızı yüklemek en iyisidir. gösterebilmelisiniz. Bu şekilde, kullanıcı girer girmez yayınlanmaya hazır bir reklamınız olur en iyi şekilde yararlanabilirsiniz. İhtiyacınız olduğunda reklam isteklerini önceden göndermek için yönetici sınıfı uygulayın. tıklayın.
AppOpenAdManager
adında yeni bir singleton sınıfı oluşturun ve şu şekilde doldurun:
şöyle olur:
Swift
class AppOpenAdManager: NSObject {
var appOpenAd: GADAppOpenAd?
var isLoadingAd = false.
var isShowingAd = false
static let shared = AppOpenAdManager()
private func loadAd() async {
// TODO: Implement loading an ad.
}
func showAdIfAvailable() {
// TODO: Implement showing an ad.
}
private func isAdAvailable() -> Bool {
// Check if ad exists and can be shown.
return appOpenAd != nil
}
}
Objective-C
@interface AppOpenAdManager ()
@property(nonatomic, strong) GADAppOpenAd *appOpenAd;
@property(nonatomic, assign) BOOL isLoadingAd;
@property(nonatomic, assign) BOOL isShowingAd;
@end
@implementation AppOpenAdManager
+ (nonnull AppOpenAdManager *)sharedInstance {
static AppOpenAdManager *instance = nil;
static dispatch_once_t onceToken;
dispatch_once(&onceToken, ^{
instance = [[AppOpenAdManager alloc] init];
});
return instance;
}
- (void)loadAd {
// TODO: Implement loading an ad.
}
// Add this method to the .h file.
- (void)showAdIfAvailable {
// TODO: Implement showing an ad.
}
- (BOOL)isAdAvailable {
// Check if ad exists and can be shown.
return self.appOpenAd != nil;
}
@end
Reklam yükle
Bir sonraki adım, loadAd()
yöntemini doldurmaktır.
Swift
private func loadAd() async {
// Do not load ad if there is an unused ad or one is already loading.
if isLoadingAd || isAdAvailable() {
return
}
isLoadingAd = true
do {
appOpenAd = try await GADAppOpenAd.load(
withAdUnitID: "ca-app-pub-3940256099942544/5575463023", request: GADRequest())
} catch {
print("App open ad failed to load with error: \(error.localizedDescription)")
}
isLoadingAd = false
}
Objective-C
- (void)loadAd {
// Do not load ad if there is an unused ad or one is already loading.
if (self.isLoadingAd || [self isAdAvailable]) {
return;
}
self.isLoadingAd = YES;
[GADAppOpenAd loadWithAdUnitID:@"ca-app-pub-3940256099942544/5575463023"
request:[GADRequest request]
completionHandler:^(GADAppOpenAd *_Nullable appOpenAd, NSError *_Nullable error) {
self.isLoadingAd = NO;
if (error) {
NSLog(@"Failed to load app open ad: %@", error);
return;
}
self.appOpenAd = appOpenAd;
}];
}
Reklam gösterin
Bir sonraki adım, showAdIfAvailable()
yöntemini doldurmaktır. Reklam yoksa
yöntem bir reklamı yüklemeye çalışır.
Swift
func showAdIfAvailable() {
// If the app open ad is already showing, do not show the ad again.
guard !isShowingAd else { return }
// If the app open ad is not available yet but is supposed to show, load
// a new ad.
if !isAdAvailable() {
Task {
await loadAd()
}
return
}
if let ad = appOpenAd {
isShowingAd = true
ad.present(fromRootViewController: nil)
}
}
Objective-C
- (void)showAdIfAvailable {
// If the app open ad is already showing, do not show the ad again.
if (self.isShowingAd) {
return;
}
// If the app open ad is not available yet but is supposed to show, load a
// new ad.
if (![self isAdAvailable]) {
[self loadAd];
return;
}
self.isShowingAd = YES;
[self.appOpenAd presentFromRootViewController:nil];
}
Uygulama ön plan etkinlikleri sırasında reklamı göster
Uygulama etkin hale geldiğinde showAdIfAvailable()
çağırarak aşağıdaki durumlarda reklam gösterin
varsa veya yeni bir tane yüklüyor.
Swift
@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
// ...
func applicationDidBecomeActive(_ application: UIApplication) {
// Show the app open ad when the app is foregrounded.
AppOpenAdManager.shared.showAdIfAvailable()
}
}
Objective-C
@implementation AppDelegate
// ...
- (void) applicationDidBecomeActive:(UIApplication *)application {
// Show the app open ad when the app is foregrounded.
[AppOpenAdManager.sharedInstance showAdIfAvailable];
}
@end
Sunu geri çağırmalarını yönetme
Uygulamanızda bir uygulama açılış reklamı görüntülendiğinde
Belirli sunu etkinliklerini işlemek için GADFullScreenContentDelegate
. İçinde
özellikle, ilk reklamdan sonra bir sonraki uygulama açılış reklamını
sunumu bitirir.
AppOpenAdManager
sınıfınıza aşağıdakileri ekleyin:
Swift
class AppOpenAdManager: NSObject, GADFullScreenContentDelegate {
// ...
private func loadAd() async {
// Do not load ad if there is an unused ad or one is already loading.
if isLoadingAd || isAdAvailable() {
return
}
isLoadingAd = true
do {
appOpenAd = try await GADAppOpenAd.load(
withAdUnitID: "ca-app-pub-3940256099942544/5575463023", request: GADRequest())
appOpenAd?.fullScreenContentDelegate = self
} catch {
print("App open ad failed to load with error: \(error.localizedDescription)")
}
isLoadingAd = false
}
// ...
// MARK: - GADFullScreenContentDelegate methods
func adWillPresentFullScreenContent(_ ad: GADFullScreenPresentingAd) {
print("App open ad will be presented.")
}
func adDidDismissFullScreenContent(_ ad: GADFullScreenPresentingAd) {
appOpenAd = nil
isShowingAd = false
// Reload an ad.
Task {
await loadAd()
}
}
func ad(
_ ad: GADFullScreenPresentingAd,
didFailToPresentFullScreenContentWithError error: Error
) {
appOpenAd = nil
isShowingAd = false
// Reload an ad.
Task {
await loadAd()
}
}
}
Objective-C
@interface AppOpenAdManager () <GADFullScreenContentDelegate>
@property(nonatomic, strong) GADAppOpenAd *appOpenAd
@property(nonatomic, assign) BOOL isLoadingAd;
@property(nonatomic, assign) BOOL isShowingAd;
@end
@implementation AppOpenAdManager
// ...
- (void)loadAd {
// Do not load ad if there is an unused ad or one is already loading.
if (self.isLoadingAd || [self isAdAvailable]) {
return;
}
self.isLoadingAd = YES;
[GADAppOpenAd loadWithAdUnitID:@"ca-app-pub-3940256099942544/5575463023"
request:[GADRequest request]
completionHandler:^(GADAppOpenAd *_Nullable appOpenAd, NSError *_Nullable error) {
self.isLoadingAd = NO;
if (error) {
NSLog(@"Failed to load app open ad: %@", error);
return;
}
self.appOpenAd = appOpenAd;
self.appOpenAd.fullScreenContentDelegate = self;
}];
}
- (BOOL)isAdAvailable {
// Check if ad exists and can be shown.
return self.appOpenAd != nil;
}
// ...
#pragma mark - GADFullScreenContentDelegate methods
- (void)adWillPresentFullScreenContent:(nonnull id<GADFullScreenPresentingAd>)ad {
NSLog(@"App open ad is will be presented.");
}
- (void)adDidDismissFullScreenContent:(nonnull id<GADFullScreenPresentingAd>)ad {
self.appOpenAd = nil;
self.isShowingAd = NO;
// Reload an ad.
[self loadAd];
}
- (void)ad:(nonnull id<GADFullScreenPresentingAd>)ad
didFailToPresentFullScreenContentWithError:(nonnull NSError *)error {
self.appOpenAd = nil;
self.isShowingAd = NO;
// Reload an ad.
[self loadAd];
}
@end
Reklam geçerlilik süresini dikkate alın
Süresi dolmuş bir reklam göstermediğinizden emin olmak için uygulama yetkilendirmesine bir yöntem ekleyebilirsiniz geçen süreyi kontrol eden bir filtre kullanabilirsiniz.
AppOpenAdManager
bölümünde loadTime
adlı bir Date
özelliği ekleyin ve
özelliğini etkinleştirin. Ardından, şu koşulları karşılıyorsanız true
değerini döndüren bir yöntem ekleyebilirsiniz:
Reklamınızın yüklenmesinden bu yana belirli bir sayıdan az zaman geçmişse. Şunlardan emin olun:
Reklamı göstermeye çalışmadan önce reklam referansınızın geçerliliğini kontrol etmeniz gerekir.
Swift
class AppOpenAdManager: NSObject, GADFullScreenContentDelegate {
var appOpenAd: GADAppOpenAd?
var isLoadingAd = false.
var isShowingAd = false
var loadTime: Date?
let fourHoursInSeconds = TimeInterval(3600 * 4)
// ...
private func loadAd() async {
// Do not load ad if there is an unused ad or one is already loading.
if isLoadingAd || isAdAvailable() {
return
}
isLoadingAd = true
do {
appOpenAd = try await GADAppOpenAd.load(
withAdUnitID: "ca-app-pub-3940256099942544/5575463023", request: GADRequest())
appOpenAd?.fullScreenContentDelegate = self
loadTime = Date()
} catch {
print("App open ad failed to load with error: \(error.localizedDescription)")
}
isLoadingAd = false
}
private func wasLoadTimeLessThanFourHoursAgo() -> Bool {
guard let loadTime = loadTime else { return false }
// Check if ad was loaded more than four hours ago.
return Date().timeIntervalSince(loadTime) < fourHoursInSeconds
}
private func isAdAvailable() -> Bool {
// Check if ad exists and can be shown.
return appOpenAd != nil && wasLoadTimeLessThanFourHoursAgo()
}
}
Objective-C
static NSTimeInterval const fourHoursInSeconds = 3600 * 4;
@interface AppOpenAdManager () <GADFullScreenContentDelegate>
@property(nonatomic, strong) GADAppOpenAd *appOpenAd
@property(nonatomic, assign) BOOL isLoadingAd;
@property(nonatomic, assign) BOOL isShowingAd;
@property(weak, nonatomic) NSDate *loadTime;
@end
@implementation AppOpenAdManager
// ...
- (void)loadAd {
// Do not load ad if there is an unused ad or one is already loading.
if (self.isLoadingAd || [self isAdAvailable]) {
return;
}
self.isLoadingAd = YES;
[GADAppOpenAd loadWithAdUnitID:@"ca-app-pub-3940256099942544/5575463023"
request:[GADRequest request]
completionHandler:^(GADAppOpenAd *_Nullable appOpenAd, NSError *_Nullable error) {
self.isLoadingAd = NO;
if (error) {
NSLog(@"Failed to load app open ad: %@", error);
return;
}
self.appOpenAd = appOpenAd;
self.appOpenAd.fullScreenContentDelegate = self;
self.loadTime = [NSDate date];
}];
}
- (BOOL)wasLoadTimeLessThanFourHoursAgo {
// Check if ad was loaded more than four hours ago.
return [[NSDate Date] timeIntervalSinceDate:self.loadTime] < fourHoursInSeconds;
}
- (BOOL)isAdAvailable {
// Check if ad exists and can be shown.
return self.appOpenAd != nil && [self wasLoadTimeLessThanFourHoursAgo];
}
@end
Baştan başlatma ve yükleme ekranları
Dokümanlarda, uygulama açılış reklamlarının yalnızca kullanıcılar tarafından uygulamanız bellekte askıya alındığında ön planda tutulur. "Sıfırdan başlangıç" şu durumda olur: Uygulamanız başlatılmış ancak daha önce bellekte askıya alınmamış olmalıdır.
Soğuk başlatmaya örnek olarak, bir kullanıcının uygulamanızı ilk kez açması verilebilir. Soğuk başlatmalarda, önceden yüklenmiş ve kullanıma hazır bir uygulama açılış reklamınız olmaz. anında gösterilmesidir. Reklam isteğinde bulunmanız ile reklam almanız arasındaki gecikme kullanıcıların uygulamanızı indirmeden önce kısa bir süre kullanabildiği bir durum şaşırtıcı bir reklam görüyor. Güvenli olmayan bir kötü kullanıcı deneyimi.
Uygulama açılış reklamlarını baştan başlatma durumunda kullanmanın tercih edilen yolu, yükleme ekranı kullanmaktır. oyun veya uygulama öğelerinizi yüklemek ve reklamı yalnızca yükleme sırasından itibaren göstermek için tıklayın. Uygulamanızın yüklenmesi tamamlandı ve kullanıcıyı ana içeriği kullanıyorsanız reklamı göstermeyin.
En iyi uygulamalar
Google, uygulama açılış reklamlarını uygulamanızın yükleme ekranından para kazanmanıza yardımcı olacak şekilde geliştirmiştir ancak kullanıcılarınızın Google Apps'tan en iyi şekilde yararlanmasını sağlamak için en iyi şekilde yararlanabilirsiniz. Aşağıdakileri yaptığınızdan emin olun:
- İlk uygulama açılış reklamınızın gösterilmesini, kullanıcılarınız birkaç kez deneyin.
- Uygulama açılış reklamlarını kullanıcıların normalde bekleyecekleri zamanlarda gösterin yüklemenizi sağlar.
- Uygulama açılış reklamının altında bir yükleme ekranı ve yükleme ekranınız varsa
reklam kapatılmadan önce yükleme işlemini tamamladığında,
adDidDismissFullScreenContent
yönteminde yükleme ekranı gösteriliyor.
GitHub'daki örneği tamamlayın
Sonraki adımlar
Kullanıcı gizliliği hakkında daha fazla bilgi edinin.