Wdrażanie reklam typu obraz w obrazie (beta)

Wybierz platformę: Android iOS Unity

Reklamy typu obraz w obrazie (PiP) wyświetlają się w pływającym oknie, które pozostaje na pierwszym planie nad treściami na ekranie, takimi jak artykuły, kanały czy rozgrywka. Ten format umożliwia użytkownikom interakcję z aplikacją, gdy reklama pozostaje widoczna. Wybierz ten format, aby wyświetlać reklamy displayowe, które nie zajmują całego ekranu.

Z tego przewodnika dowiesz się, jak żądać i wyświetlać reklamy w trybie obrazu w obrazie w aplikacji za pomocą Google Mobile Ads SDK.

Zanim zaczniesz

Zanim przejdziesz dalej, wykonaj te czynności:

• Skonfiguruj Google Mobile Ads SDK.

• Zainstaluj Google Mobile Ads SDK w wersji 13.10.0 lub nowszej.

• Włącz reklamy testowe i użyj tego identyfikatora testowej jednostki reklamowej:

  /21775744923/example/picture-in-picture
  

Wczytywanie reklamy

Aby wczytać obiekt GADPictureInPictureAd, utwórz żądanie reklamy i wywołaj metodę wczytywania:

Swift

private func loadAdManagerPictureInPictureAd() async {
  do {
    // Capture the PictureInPictureAd reference for later use.
    pipAd = try await PictureInPictureAd.load(
      with: adUnitID, request: AdManagerRequest())
    // Set the delegate to be notified of ad events.
    pipAd?.delegate = self
  } catch {
    print(
      "Picture-in-Picture ad failed to load: \(error.localizedDescription)")
  }
}

Zastąp adUnitID identyfikatorem jednostki reklamowej.

Objective-C

- (void)loadAdManagerPictureInPictureAd {
  GAMRequest *request = [GAMRequest request];

  [GADPictureInPictureAd
       loadWithAdUnitID:kAdUnitID
                request:request
      completionHandler:^(GADPictureInPictureAd *_Nullable ad, NSError *_Nullable error) {
        if (error) {
          NSLog(@"Picture-in-Picture ad failed to load: %@", error);
          return;
        }
        // Capture the PictureInPictureAd reference for later use.
        self.pipAd = ad;
        // Set the delegate to be notified of ad events.
        self.pipAd.delegate = self;
      }];
}

Zastąp kAdUnitID identyfikatorem jednostki reklamowej.

Wyświetl reklamę

Aby wyświetlić reklamę obraz w obrazie na ekranie, wywołaj metodę show. W tym przykładzie reklama wyświetla się w pozycji domyślnej, a zakres prezentacji jest ustawiony na ekran:

Swift

private func showPictureInPictureAd() {
  // Use the loaded PictureInPictureAd instance.
  guard let pipAd else {
    print("No ad to show.")
    return
  }
  let options = PictureInPictureAdOptions()
  // Uses the Google Mobile Ads SDK's default screen position.
  options.position = .default
  // Binds the ad lifecycle to the host screen.
  options.presentationScope = .screen

  pipAd.show(with: options)
}

Objective-C

- (void)showPictureInPictureAd {
  // Use the loaded PictureInPictureAd instance.
  if (!self.pipAd) {
    NSLog(@"No ad to show.");
    return;
  }
  GADPictureInPictureAdOptions *options =
      [[GADPictureInPictureAdOptions alloc] init];
  // Uses the Google Mobile Ads SDK's default screen position.
  options.position = GADPictureInPictureAdPositionDefault;
  // Binds the ad lifecycle to the host screen.
  options.presentationScope = GADPictureInPictureAdPresentationScopeScreen;

  [self.pipAd showWithOptions:options];
}

Ustaw pozycję

Domyślnie Google Mobile Ads SDK wyświetla reklamę obraz w obrazie w prawym dolnym rogu ekranu, gdy jest wyświetlana po raz pierwszy, lub w ostatniej znanej pozycji, jeśli była już wyświetlana. Aby dostosować miejsce wyświetlania reklamy, określ pozycję podczas jej wyświetlania. W tym przykładzie pozycja jest ustawiona na górze treści w lewym górnym rogu ekranu:

Swift

private func createTopLeftPositionOptions() -> PictureInPictureAdOptions {
  let options = PictureInPictureAdOptions()
  // Sets the ad position to the top-left corner of the screen.
  options.position = .topLeft
  return options
}

Objective-C

- (GADPictureInPictureAdOptions *)createTopLeftPositionOptions {
  GADPictureInPictureAdOptions *options =
      [[GADPictureInPictureAdOptions alloc] init];
  // Sets the ad position to the top-left corner of the screen.
  options.position = GADPictureInPictureAdPositionTopLeft;
  return options;
}

Wszystkie dostępne stanowiska znajdziesz na stronie GADPictureInPictureAdPosition.

Ustawianie zakresu prezentacji

Domyślnie Google Mobile Ads SDK wiąże reklamę obraz w obrazie z bieżącym ekranem hosta. Google Mobile Ads SDK zamyka reklamę, gdy hierarchia widoków ekranu hosta nie jest już w pamięci. Aby reklama była widoczna po usunięciu ekranu hosta z pamięci, ustaw zakres prezentacji na aplikację:

Swift

private func createApplicationScopedOptions() -> PictureInPictureAdOptions {
  let options = PictureInPictureAdOptions()
  // Keeps the ad visible beyond the host screen's lifecycle.
  options.presentationScope = .application
  return options
}

Objective-C

- (GADPictureInPictureAdOptions *)createApplicationScopedOptions {
  GADPictureInPictureAdOptions *options =
      [[GADPictureInPictureAdOptions alloc] init];
  // Keeps the ad visible beyond the host screen's lifecycle.
  options.presentationScope = GADPictureInPictureAdPresentationScopeApplication;
  return options;
}

Więcej informacji znajdziesz w artykule Utrzymywanie widoczności reklamy na różnych ekranach.

Nasłuchiwanie zdarzeń reklamowych

Aby obsługiwać zdarzenia cyklu życia reklam w trybie obrazu w obrazie, zarejestruj się na potrzeby zdarzeń reklamowych przed wyświetleniem reklamy. Te zdarzenia raportują interakcje z reklamą, takie jak kliknięcia i wyświetlenia. Te zdarzenia raportują też zdarzenia związane z trybem obrazu w obrazie, np. gdy reklama jest wyświetlana lub ukrywana:

Swift

func pictureInPictureAdDidShow(_ pictureInPictureAd: PictureInPictureAd) {
  print("Picture-in-Picture ad shown.")
}

func pictureInPictureAdDidHide(_ pictureInPictureAd: PictureInPictureAd) {
  print("Picture-in-Picture ad hidden.")
}

func pictureInPictureAdDidFailToShow(
  _ pictureInPictureAd: PictureInPictureAd, error: Error
) {
  print("Picture-in-Picture ad failed to show: \(error.localizedDescription)")
}

func pictureInPictureAdDidRecordImpression(
  _ pictureInPictureAd: PictureInPictureAd
) {
  print("Picture-in-Picture ad recorded an impression.")
}

func pictureInPictureAdDidRecordClick(
  _ pictureInPictureAd: PictureInPictureAd
) {
  print("Picture-in-Picture ad recorded a click.")
}

func pictureInPictureAdWillPresentScreen(
  _ pictureInPictureAd: PictureInPictureAd
) {
  print("Picture-in-Picture ad will present screen.")
}

func pictureInPictureAdWillDismissScreen(
  _ pictureInPictureAd: PictureInPictureAd
) {
  print("Picture-in-Picture ad will dismiss screen.")
}

func pictureInPictureAdDidDismissScreen(
  _ pictureInPictureAd: PictureInPictureAd
) {
  print("Picture-in-Picture ad dismissed screen.")
}

Objective-C

- (void)pictureInPictureAdDidShow:(GADPictureInPictureAd *)pictureInPictureAd {
  NSLog(@"Picture-in-Picture ad shown.");
}

- (void)pictureInPictureAdDidHide:(GADPictureInPictureAd *)pictureInPictureAd {
  NSLog(@"Picture-in-Picture ad hidden.");
}

- (void)pictureInPictureAdDidFailToShow:(GADPictureInPictureAd *)pictureInPictureAd
                              withError:(NSError *)error {
  NSLog(@"Picture-in-Picture ad failed to show: %@", error);
}

- (void)pictureInPictureAdDidRecordImpression:(GADPictureInPictureAd *)pictureInPictureAd {
  NSLog(@"Picture-in-Picture ad recorded an impression.");
}

- (void)pictureInPictureAdDidRecordClick:(GADPictureInPictureAd *)pictureInPictureAd {
  NSLog(@"Picture-in-Picture ad recorded a click.");
}

- (void)pictureInPictureAdWillPresentScreen:(GADPictureInPictureAd *)pictureInPictureAd {
  NSLog(@"Picture-in-Picture ad will present screen.");
}

- (void)pictureInPictureAdWillDismissScreen:(GADPictureInPictureAd *)pictureInPictureAd {
  NSLog(@"Picture-in-Picture ad will dismiss screen.");
}

- (void)pictureInPictureAdDidDismissScreen:(GADPictureInPictureAd *)pictureInPictureAd {
  NSLog(@"Picture-in-Picture ad dismissed screen.");
}

Ukryj reklamę

Aby usunąć reklamę pływającą z ekranu, wywołaj metodę ukrywania. Ta metoda wywołuje zdarzenie ukrycia reklamy:

Swift

private func hidePictureInPictureAd() {
  // Use the loaded PictureInPictureAd instance.
  guard let pipAd else {
    print("No ad to hide.")
    return
  }
  pipAd.hide()
}

Objective-C

- (void)hidePictureInPictureAd {
  // Use the loaded PictureInPictureAd instance.
  if (!self.pipAd) {
    NSLog(@"No ad to hide.");
    return;
  }
  [self.pipAd hide];
}

Usuwanie zasobów reklamowych

Aby uniknąć wycieków pamięci, usuń odwołanie do obiektu reklamy, gdy aplikacja zakończy korzystanie z niej. Na przykład gdy aplikacja nie wyświetla już reklamy ani nie wchodzi z nią w interakcję. W przypadku reklam o zasięgu ekranu usuń odwołanie, gdy aplikacja usunie ekran hosta z pamięci. W przypadku reklam o zasięgu aplikacji zachowaj odwołanie do reklamy, gdy użytkownik przechodzi między ekranami, i usuń je, gdy użytkownik zamknie reklamę:

Swift

private func cleanUpPictureInPictureAd() {
  pipAd?.hide()
  pipAd = nil
}

Objective-C

- (void)cleanUpPictureInPictureAd {
  [self.pipAd hide];
  self.pipAd = nil;
}

Zapewnij widoczność reklamy na różnych ekranach

Jeśli ustawisz zakres prezentacji na aplikację, reklama w trybie obrazu w obrazie pozostanie widoczna nawet wtedy, gdy aplikacja usunie ekran hostujący z pamięci. Aby użytkownik mógł wejść w interakcję z reklamą lub ją zamknąć, gdy opuści ekran hosta, aplikacja musi zachować dostęp do reklamy w trybie obrazu w obrazie. Zalecamy przechowywanie reklamy w pojedynczym obiekcie na poziomie aplikacji lub w menedżerze stanu udostępniania, a nie w zmiennej instancji pojedynczego ekranu.

Przykłady, jak utrzymać widoczność reklamy na różnych ekranach, znajdziesz w tych przykładowych aplikacjach:

• Swift
• Objective-C