Reklamy pełnoekranowe

Wybierz platformę: Android (beta) Android iOS Unity Flutter

Reklamy pełnoekranowe zakrywają interfejs aplikacji, w której się wyświetlają, dopóki użytkownik ich nie zamknie. Wyświetlają się zwykle w naturalnych punktach przejścia w aplikacji, np. między działaniami lub podczas przerwy między poziomami gry. Gdy aplikacja wyświetla reklamę pełnoekranową, użytkownik może w nią kliknąć i przejść do miejsca docelowego lub zamknąć reklamę i wrócić do aplikacji. Studium przypadku

Z tego przewodnika dowiesz się, jak zintegrować reklamy pełnoekranowe z aplikacją na iOS.

Wymagania wstępne

Zanim przejdziesz dalej, skonfiguruj Google Mobile Ads SDK.

Zawsze testuj za pomocą reklam testowych

Podczas tworzenia i testowania aplikacji używaj reklam testowych zamiast reklam produkcyjnych. Jeśli tego nie zrobisz, Twoje konto może zostać zawieszone.

Najłatwiejszym sposobem wczytywania reklam testowych jest użycie specjalnego identyfikatora testowej jednostki reklamowej w przypadku reklam pełnoekranowych na iOS:
/21775744923/example/interstitial

Został on specjalnie skonfigurowany tak, aby zwracać reklamy testowe w przypadku każdego żądania. Możesz go używać w swoich aplikacjach podczas kodowania, testowania i debugowania. Pamiętaj tylko, aby przed opublikowaniem aplikacji zastąpić go identyfikatorem swojej jednostki reklamowej.

Szczegółowe informacje o Google Mobile Ads SDK reklamach testowych znajdziesz w artykule Włączanie reklam testowych.

Implementacja

Główne etapy integracji reklam pełnoekranowych to:

1. Wczytaj reklamę.
2. Zarejestruj się, aby otrzymywać wywołania zwrotne.
3. wyświetlać reklamę;

Wczytywanie reklamy

Reklamę wczytuje się za pomocą metody load(adUnitID:request) w klasie GAMInterstitialAd.

Swift

fileprivate func loadInterstitial() async {
  do {
    interstitial = try await AdManagerInterstitialAd.load(
      with: "/21775744923/example/interstitial", request: AdManagerRequest())
    interstitial?.fullScreenContentDelegate = self
  } catch {
    print("Failed to load interstitial ad with error: \(error.localizedDescription)")
  }
}
ViewController.swift

SwiftUI

import GoogleMobileAds

class InterstitialViewModel: NSObject, FullScreenContentDelegate {
  private var interstitialAd: InterstitialAd?

  func loadAd() async {
    do {
      interstitialAd = try await InterstitialAd.load(
        with: "ca-app-pub-3940256099942544/4411468910", request: Request())
      interstitialAd?.fullScreenContentDelegate = self
    } catch {
      print("Failed to load interstitial ad with error: \(error.localizedDescription)")
    }
  }
InterstitialViewModel.swift

Objective-C

[GAMInterstitialAd loadWithAdManagerAdUnitID:@"/21775744923/example/interstitial"
                                     request:[GAMRequest request]
                           completionHandler:^(GAMInterstitialAd *ad, NSError *error) {
                             if (error) {
                               NSLog(@"Failed to load interstitial ad with error: %@",
                                     [error localizedDescription]);
                               return;
                             }
                             self.interstitial = ad;
                             self.interstitial.fullScreenContentDelegate = self;
                           }];
ViewController.m

Wskazówka: możesz używać wywołań liczby reklam na stronie, aby tworzyć pamięć podręczną wstępnie załadowanych reklam, zanim zechcesz je wyświetlić. Dzięki temu reklamy będą mogły być wyświetlane bez opóźnień, gdy będzie to potrzebne. Reklamy tracą ważność po godzinie, więc co godzinę należy czyścić pamięć podręczną i ponownie wczytywać nowe reklamy.

Rejestrowanie wywołań zwrotnych

Aby otrzymywać powiadomienia o zdarzeniach związanych z prezentacją, musisz przypisać wartość GADFullScreenContentDelegate do właściwości fullScreenContentDelegate zwróconej reklamy:

Swift

interstitial?.fullScreenContentDelegate = self
ViewController.swift

SwiftUI

interstitialAd?.fullScreenContentDelegate = self
InterstitialViewModel.swift

Objective-C

self.interstitial.fullScreenContentDelegate = self;
ViewController.m

Protokół GADFullScreenContentDelegate obsługuje wywołania zwrotne w przypadku, gdy reklama zostanie wyświetlona lub nie, a także gdy zostanie zamknięta. Poniższy kod pokazuje, jak wdrożyć protokół:

Swift

func adDidRecordImpression(_ ad: FullScreenPresentingAd) {
  print("\(#function) called")
}

func adDidRecordClick(_ ad: FullScreenPresentingAd) {
  print("\(#function) called")
}

func ad(_ ad: FullScreenPresentingAd, didFailToPresentFullScreenContentWithError error: Error) {
  print("\(#function) called with error: \(error.localizedDescription)")
  // Clear the interstitial ad.
  interstitial = nil
}

func adWillPresentFullScreenContent(_ ad: FullScreenPresentingAd) {
  print("\(#function) called")
}

func adWillDismissFullScreenContent(_ ad: FullScreenPresentingAd) {
  print("\(#function) called")
}

func adDidDismissFullScreenContent(_ ad: FullScreenPresentingAd) {
  print("\(#function) called")
  // Clear the interstitial ad.
  interstitial = nil
}
ViewController.swift

SwiftUI

func adDidRecordImpression(_ ad: FullScreenPresentingAd) {
  print("\(#function) called")
}

func adDidRecordClick(_ ad: FullScreenPresentingAd) {
  print("\(#function) called")
}

func ad(
  _ ad: FullScreenPresentingAd,
  didFailToPresentFullScreenContentWithError error: Error
) {
  print("\(#function) called")
}

func adWillPresentFullScreenContent(_ ad: FullScreenPresentingAd) {
  print("\(#function) called")
}

func adWillDismissFullScreenContent(_ ad: FullScreenPresentingAd) {
  print("\(#function) called")
}

func adDidDismissFullScreenContent(_ ad: FullScreenPresentingAd) {
  print("\(#function) called")
  // Clear the interstitial ad.
  interstitialAd = nil
}
InterstitialViewModel.swift

Objective-C

- (void)adDidRecordImpression:(id<GADFullScreenPresentingAd>)ad {
  NSLog(@"%s called", __PRETTY_FUNCTION__);
}

- (void)adDidRecordClick:(id<GADFullScreenPresentingAd>)ad {
  NSLog(@"%s called", __PRETTY_FUNCTION__);
}

- (void)ad:(id<GADFullScreenPresentingAd>)ad
    didFailToPresentFullScreenContentWithError:(NSError *)error {
  NSLog(@"%s called with error: %@", __PRETTY_FUNCTION__, error.localizedDescription);
  // Clear the interstitial ad.
  self.interstitial = nil;
}

- (void)adWillPresentFullScreenContent:(id<GADFullScreenPresentingAd>)ad {
  NSLog(@"%s called", __PRETTY_FUNCTION__);
}

- (void)adWillDismissFullScreenContent:(id<GADFullScreenPresentingAd>)ad {
  NSLog(@"%s called", __PRETTY_FUNCTION__);
}

- (void)adDidDismissFullScreenContent:(id<GADFullScreenPresentingAd>)ad {
  NSLog(@"%s called", __PRETTY_FUNCTION__);
  // Clear the interstitial ad.
  self.interstitial = nil;
}
ViewController.m

GAMInterstitialAd jest obiektem jednorazowego użytku. Oznacza to, że po wyświetleniu reklamy pełnoekranowej nie można jej ponownie wyświetlić. Zalecamy wczytywanie kolejnej reklamy pełnoekranowej w metodzie adDidDismissFullScreenContent: w klasie GADFullScreenContentDelegate, aby następna reklama pełnoekranowa zaczęła się wczytywać od razu po zamknięciu poprzedniej.

Wyświetlanie reklamy

Reklamy pełnoekranowe powinny się wyświetlać podczas naturalnych przerw w aplikacji, np. między poziomami gry lub po wykonaniu zadania przez użytkownika.

Swift

ad.present(from: self!)
ViewController.swift

SwiftUI

Odbieraj zdarzenia interfejsu w widoku, aby określić, kiedy wyświetlić reklamę.

var body: some View {
  // ...
  }
  .onChange(of: countdownTimer.isComplete) { newValue in
    showGameOverAlert = newValue
  }
  .alert(isPresented: $showGameOverAlert) {
    Alert(
      title: Text("Game Over"),
      message: Text("You lasted \(countdownTimer.countdownTime) seconds"),
      dismissButton: .cancel(
        Text("OK"),
        action: {
          viewModel.showAd()
        }))
InterstitialContentView.swift

Wyświetl reklamę pełnoekranową z modelu widoku:

func showAd() {
  guard let interstitialAd = interstitialAd else {
    return print("Ad wasn't ready.")
  }

  interstitialAd.present(from: nil)
}
InterstitialViewModel.swift

Objective-C

[self.interstitial presentFromRootViewController:self];
ViewController.m

Sprawdzone metody

Zastanów się, czy reklamy pełnoekranowe to odpowiedni typ reklam dla Twojej aplikacji.

Reklamy pełnoekranowe sprawdzają się najlepiej w aplikacjach, w których występują naturalne punkty przejścia. Takim punktem może być zakończenie zadania w aplikacji, np. udostępnienie zdjęcia lub ukończenie poziomu gry. Użytkownik spodziewa się przerwy w działaniu, więc łatwo jest wyświetlić reklamę pełnoekranową bez zakłócania jego wrażeń. Zastanów się, w których momentach w ścieżce użytkownika w aplikacji będziesz wyświetlać reklamy pełnoekranowe i jak użytkownik może na nie reagować.

Pamiętaj, aby wstrzymać działanie podczas wyświetlania reklamy pełnoekranowej.

Dostępne są różne typy reklam pełnoekranowych: tekstowe, graficzne, wideo i inne. Ważne jest, aby w momencie wyświetlania reklamy pełnoekranowej aplikacja zawieszała korzystanie z niektórych zasobów, aby umożliwić reklamie ich wykorzystanie. Na przykład, gdy wywołujesz funkcję wyświetlania reklamy pełnoekranowej, pamiętaj, aby wstrzymać odtwarzanie dźwięku przez aplikację. Możesz wznowić odtwarzanie dźwięków w procedurze obsługi zdarzeń adDidDismissFullScreenContent:, która zostanie wywołana, gdy użytkownik zakończy interakcję z reklamą. Dodatkowo rozważ tymczasowe wstrzymanie wszelkich zadań wymagających intensywnych obliczeń (np. pętli gry) podczas wyświetlania reklamy. Dzięki temu użytkownik nie będzie miał problemów z powolną lub niereagującą grafiką ani zacinającym się filmem.

Zapewnij odpowiedni czas ładowania.

Podobnie jak ważne jest wyświetlanie reklam pełnoekranowych w odpowiednim momencie, ważne jest też, aby użytkownik nie musiał czekać na ich załadowanie. Wcześniejsze wczytanie reklamy, zanim zamierzasz ją wyświetlić, może zapewnić, że Twoja aplikacja będzie miała w pogotowiu w pełni załadowaną reklamę pełnoekranową, gdy nadejdzie czas na jej wyświetlenie.

Nie zasypuj użytkownika reklamami.

Zwiększenie częstotliwości wyświetlania reklam pełnoekranowych w aplikacji może się wydawać świetnym sposobem na zwiększenie przychodów, ale może też pogorszyć wrażenia użytkownika i obniżyć współczynniki klikalności. Zadbaj o to, aby nie przerywać użytkownikom zbyt często, tak by mogli swobodnie korzystać z Twojej aplikacji.

Nie używaj wywołania zwrotnego po zakończeniu wczytywania do wyświetlania reklamy pełnoekranowej.

Może to negatywnie wpłynąć na wygodę użytkowników. Zamiast tego wstępnie załaduj reklamę, zanim będziesz musiał ją wyświetlić. Następnie sprawdź metodę canPresentFromRootViewController:error: na GAMInterstitialAd, aby dowiedzieć się, czy reklama jest gotowa do wyświetlania.

Przykłady w GitHubie

Zobacz pełne przykłady reklam pełnoekranowych w wybranym przez siebie języku:

• Swift
• SwiftUI
• Objective-C

Dalsze kroki

• Dowiedz się więcej o kierowaniu reklam i wytycznych dotyczących reklam pełnoekranowych.
• Dowiedz się więcej o prywatności użytkowników.