Wczytywanie pojedynczej reklamy wyświetlanej przy otwarciu aplikacji

Pakiet SDK z interfejsem API do jednorazowego wczytywania

Reklamy wyświetlane przy otwarciu aplikacji to specjalny format reklam przeznaczony dla wydawców, którzy chcą zarabiać na ekranach wczytywania aplikacji. Reklamy wyświetlane przy otwarciu aplikacji można w każdej chwili zamknąć. Są one wyświetlane, gdy użytkownicy przenoszą aplikację na pierwszy plan.

Więcej informacji znajdziesz w przewodniku dotyczącym reklam wyświetlanych przy otwarciu aplikacji.

Z tego przewodnika dowiesz się, jak zintegrować reklamy wyświetlane przy otwarciu aplikacji z aplikacją na Androida.

Wymagania wstępne

Skonfiguruj GMA Next-Gen SDK.

Zawsze testuj za pomocą reklam testowych

Podczas tworzenia i testowania aplikacji używaj reklam testowych, a nie reklam rzeczywistych. Jeśli tego nie zrobisz, możemy zawiesić Twoje konto.

Aby wczytać reklamy testowe, użyj identyfikatora testowej jednostki reklamowej przeznaczonej do reklam wyświetlanych przy otwarciu aplikacji na Androida:

ca-app-pub-3940256099942544/9257395921

Ten identyfikator jednostki reklamowej został specjalnie skonfigurowany tak, aby zwracać reklamy testowe w odpowiedzi na każde żądanie. Możesz go używać w swoich aplikacjach podczas kodowania, testowania i debugowania. Przed opublikowaniem aplikacji zastąp go własnym identyfikatorem jednostki reklamowej.

Więcej informacji o reklamach testowych GMA Next-Gen SDK znajdziesz w artykule Włączanie reklam testowych.

Wczytywanie reklamy

Poniższy przykład pokazuje, jak wczytać pojedynczą reklamę:

Kotlin

// Load ads after you initialize MobileAds.
AppOpenAd.load(
  AdRequest.Builder(adUnitId).build(),
  object : AdLoadCallback<AppOpenAd> {
    override fun onAdLoaded(ad: AppOpenAd) {
      // App open ad loaded.
      appOpenAd = ad
    }

    override fun onAdFailedToLoad(adError: LoadAdError) {
      // App open ad failed to load.
      Log.e(TAG, "App open ad failed to load: ${adError.message}")
      appOpenAd = null
    }
  },
)

Java

// Load ads after you initialize MobileAds.
AppOpenAd.load(
    new AdRequest.Builder(adUnitId).build(),
    new AdLoadCallback<AppOpenAd>() {
      @Override
      public void onAdLoaded(AppOpenAd ad) {
        // App open ad loaded.
        appOpenAd = ad;
      }

      @Override
      public void onAdFailedToLoad(LoadAdError adError) {
        // App open ad failed to load.
        Log.e(TAG, "App open ad failed to load: " + adError.getMessage());
        appOpenAd = null;
      }
    });

Podczas testowania użyj identyfikatora testowej jednostki reklamowej: ca-app-pub-3940256099942544/9257395921.

Wyświetlanie reklamy

Aby wyświetlić reklamę wyświetlaną przy otwarciu aplikacji, użyj metody show.

Kotlin

private fun showAd(appOpenAd: AppOpenAd, activity: Activity) {
  // Show the ad.
  appOpenAd.show(activity)
}

Java

private void showAd(AppOpenAd appOpenAd, Activity activity) {
  // Show the ad.
  appOpenAd.show(activity);
}

Nasłuchiwanie zdarzeń związanych z reklamami

Zanim wyświetlisz reklamę, nasłuchuj zdarzeń związanych z cyklem życia reklamy:

Kotlin

private fun listenToAdEvents() {
  // Listen for ad events.
  val ad = appOpenAd
  if (ad == null) {
    Log.e(TAG, "App open ad is not ready yet.")
    return
  }

  ad.adEventCallback =
    object : AppOpenAdEventCallback {
      override fun onAdShowedFullScreenContent() {
        // App open ad did show.
      }

      override fun onAdDismissedFullScreenContent() {
        // App open ad did dismiss.
        appOpenAd = null
      }

      override fun onAdFailedToShowFullScreenContent(
        fullScreenContentError: FullScreenContentError
      ) {
        // App open ad failed to show.
        Log.e(TAG, "App open ad failed to show: ${fullScreenContentError.message}")
      }

      override fun onAdImpression() {
        // App open ad did record an impression.
      }

      override fun onAdClicked() {
        // App open ad did record a click.
      }
    }
}

Java

private void listenToAdEvents() {
  // Listen for ad events.
  if (appOpenAd == null) {
    Log.e(TAG, "App open ad is not ready yet.");
    return;
  }

  appOpenAd.setAdEventCallback(
      new AppOpenAdEventCallback() {
        @Override
        public void onAdShowedFullScreenContent() {
          // App open ad did show.
        }

        @Override
        public void onAdDismissedFullScreenContent() {
          // App open ad did dismiss.
          appOpenAd = null;
        }

        @Override
        public void onAdFailedToShowFullScreenContent(
            @NonNull FullScreenContentError fullScreenContentError) {
          // App open ad failed to show.
          Log.e(TAG, "App open ad failed to show: " + fullScreenContentError.getMessage());
        }

        @Override
        public void onAdImpression() {
          // App open ad did record an impression.
        }

        @Override
        public void onAdClicked() {
          // App open ad did record a click.
        }
      });
}

Uruchamianie „na zimno” i ekrany wczytywania

Uruchomienie „na zimno” następuje, gdy aplikacja uruchamia się od zera, np. gdy użytkownik otwiera aplikację po raz pierwszy lub po zakończeniu działania aplikacji z powodu braku pamięci. Podczas uruchamiania „na zimno” nie masz wcześniej wczytanej reklamy wyświetlanej przy otwarciu aplikacji, która byłaby gotowa do natychmiastowego wyświetlenia.

Ze względu na opóźnienia w żądaniach reklamy użytkownicy mogą wejść w interakcję z aplikacją, zanim pojawi się reklama wyświetlana przy otwarciu aplikacji. Aby uniknąć pogorszenia komfortu użytkowników, wyświetlaj reklamy wyświetlane przy otwarciu aplikacji podczas uruchamiania „na zimno” tylko na ekranie wczytywania, gdy wczytują się zasoby aplikacji. Jeśli wczytywanie zasobów zakończy się, a użytkownik dotrze do głównej treści, zanim reklama się wczyta, nie wyświetlaj reklamy.

Wczytuj zasoby aplikacji w wątku w tle, aby wczytywanie trwało podczas wyświetlania reklamy.

Sprawdzone metody

Postępuj zgodnie z tymi sprawdzonymi metodami dotyczącymi reklam wyświetlanych przy otwarciu aplikacji:

  • Pierwszą reklamę wyświetlaną przy otwarciu aplikacji pokazuj dopiero po tym, jak użytkownik otworzy aplikację kilka razy.
  • Reklamy wyświetlane przy otwarciu aplikacji pokazuj tylko wtedy, gdy użytkownicy czekają na wczytanie aplikacji.
  • Jeśli ekran wczytywania zakończy wczytywanie podczas wyświetlania reklamy, zamknij ekran wczytywania w metodzie wywołania zwrotnego po zamknięciu reklamy.