Uygulama Açılış Reklamları

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:

  1. Bir reklamı görüntülemeniz gerekmeden önce yükleyen bir yönetici sınıfı oluşturun.
  2. Uygulama ön plan etkinlikleri sırasında reklamı göster.
  3. Sunu geri çağırma işlemlerini halledin.

Ön koşullar

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

Swift Objective-C

Sonraki adımlar

Kullanıcı gizliliği hakkında daha fazla bilgi edinin.