Reklamy wyświetlane przy otwarciu aplikacji

Ten przewodnik jest przeznaczony dla wydawców, którzy integrują reklamy wyświetlane przy otwarciu aplikacji za pomocą Pakiet SDK do reklam mobilnych.

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 zamknąć w dowolnym momencie. Są zaprojektowane tak,

Uwaga: konkretne formaty mogą się różnić w zależności od regionu.

Reklamy wyświetlane przy otwarciu aplikacji automatycznie wyświetlają mały obszar marki, dzięki czemu użytkownicy wiedzą, że wyświetlają się w Twojej aplikacji do aplikacji. Oto przykład, jak wygląda reklama wyświetlana przy otwarciu aplikacji:

Wymagania wstępne

• Zapoznaj się z przewodnikiem dla początkujących.

Zawsze korzystaj z reklam testowych

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

Najłatwiejszym sposobem wczytywania reklam testowych jest użycie dedykowanego testowego identyfikatora jednostki reklamowej dla aplikacji otwieranie reklam:

/21775744923/example/app-open

Został on specjalnie skonfigurowany tak, aby wyświetlać reklamy testowe w odpowiedzi na każde żądanie. do wykorzystania we własnych aplikacjach przy kodowaniu, testowaniu i debugowaniu. Po prostu zrób zastąp go identyfikatorem jednostki reklamowej przed opublikowaniem aplikacji.

Więcej informacji o działaniu reklam testowych w pakiecie SDK do reklam mobilnych Google znajdziesz na stronie Włącz reklamy testowe.

Rozszerzanie klasy aplikacji

Utwórz nową klasę, która rozszerza klasę Application, i dodaj do zainicjuj pakiet SDK do reklam mobilnych Google przy uruchamianiu aplikacji.

Java

/** Application class that initializes, loads and show ads when activities change states. */
public class MyApplication extends Application {

  @Override
  public void onCreate() {
    super.onCreate();
    new Thread(
            () -> {
              // Initialize the Google Mobile Ads SDK on a background thread.
              MobileAds.initialize(this, initializationStatus -> {});
            })
        .start();
  }
}

Kotlin

/** Application class that initializes, loads and show ads when activities change states. */
class MyApplication : Application() {

  override fun onCreate() {
    super.onCreate()
    val backgroundScope = CoroutineScope(Dispatchers.IO)
    backgroundScope.launch {
      // Initialize the Google Mobile Ads SDK on a background thread.
      MobileAds.initialize(this@MyApplication) {}
    }
  }
}

Spowoduje to zainicjowanie pakietu SDK i udostępnienie szkieletu, w którym zarejestrujesz się do zdarzeń pierwszego planu aplikacji.

Następnie dodaj do AndroidManifest.xml ten kod:

<!-- TODO: Update to reference your actual package name. -->
<application
    android:name="com.google.android.gms.example.appopendemo.MyApplication" ...>
...
</application>

Wdrażanie komponentu narzędziowego

Twoja reklama powinna się szybko wyświetlać, więc najlepiej jest ją załadować, zanim trzeba będzie go wyświetlić. Dzięki temu reklama będzie gotowa do wyświetlenia, gdy tylko użytkownik wejdzie do niej do aplikacji.

Zaimplementuj komponent narzędzia AppOpenAdManager, aby wysyłać żądania reklamy z wyprzedzeniem w razie potrzeby wyświetlenia reklamy.

Java

public class MyApplication extends Application {
  // ...
  /** Inner class that loads and shows app open ads. */
  private class AppOpenAdManager {
    private static final String LOG_TAG = "AppOpenAdManager";
    private static final String AD_UNIT_ID = "/21775744923/example/app-open";

    private AppOpenAd appOpenAd = null;
    private boolean isLoadingAd = false;
    private boolean isShowingAd = false;

    /** Constructor. */
    public AppOpenAdManager() {}

    /** Request an ad. */
    private void loadAd(Context context) {
      // We will implement this later.
    }

    /** Check if ad exists and can be shown. */
    private boolean isAdAvailable() {
      return appOpenAd != null;
    }
  }
}

Kotlin

private const val String LOG_TAG = "AppOpenAdManager"
private const val String AD_UNIT_ID = "/21775744923/example/app-open"

public class MyApplication extends Application {
  // ...
  /** Inner class that loads and shows app open ads. */
  private inner class AppOpenAdManager {
    private var appOpenAd: AppOpenAd? = null
    private var isLoadingAd = false
    var isShowingAd = false

    /** Request an ad. */
    fun loadAd(context: Context) {
      // We will implement this later.
    }

    /** Check if ad exists and can be shown. */
    private fun isAdAvailable(): Boolean {
      return appOpenAd != null
    }
  }
}

Teraz, gdy masz już klasę pomocniczą, możesz utworzyć jej instancję w klasie MyApplication:

Java

public class MyApplication extends Application {

  private AppOpenAdManager appOpenAdManager;

  @Override
  public void onCreate() {
    super.onCreate();
    new Thread(
            () -> {
              // Initialize the Google Mobile Ads SDK on a background thread.
              MobileAds.initialize(this, initializationStatus -> {});
            })
        .start();
    appOpenAdManager = new AppOpenAdManager(this);
  }
}

Kotlin

class MyApplication : Application() {

  private lateinit var appOpenAdManager: AppOpenAdManager

  override fun onCreate() {
    super.onCreate()
    val backgroundScope = CoroutineScope(Dispatchers.IO)
    backgroundScope.launch {
      // Initialize the Google Mobile Ads SDK on a background thread.
      MobileAds.initialize(this@MyApplication) {}
    }
    appOpenAdManager = AppOpenAdManager()
  }
}

Wczytywanie reklamy

Następnym krokiem jest wypełnienie metody loadAd() i obsługa wczytywania reklam. .

Java

private class AppOpenAdManager {
  // ...
  /** Request an ad. */
  public void loadAd(Context context) {
    // Do not load ad if there is an unused ad or one is already loading.
    if (isLoadingAd || isAdAvailable()) {
      return;
    }

    isLoadingAd = true;
    AdRequest request = new AdRequest.Builder().build();
    AppOpenAd.load(
        context, AD_UNIT_ID, request,
        AppOpenAd.APP_OPEN_AD_ORIENTATION_PORTRAIT,
        new AppOpenAdLoadCallback() {
          @Override
          public void onAdLoaded(AppOpenAd ad) {
            // Called when an app open ad has loaded.
            Log.d(LOG_TAG, "Ad was loaded.");
            appOpenAd = ad;
            isLoadingAd = false;
            loadTime = (new Date()).getTime();
          }

          @Override
          public void onAdFailedToLoad(LoadAdError loadAdError) {
            // Called when an app open ad has failed to load.
            Log.d(LOG_TAG, loadAdError.getMessage());
            isLoadingAd = false;
          }
        });
  }
  // ...
}

Kotlin

private inner class AppOpenAdManager {
  // ...
  /** Request an ad. */
  fun loadAd(context: Context) {
    // Do not load ad if there is an unused ad or one is already loading.
    if (isLoadingAd || isAdAvailable()) {
      return
    }

    isLoadingAd = true
    val request = AdRequest.Builder().build()
    AppOpenAd.load(
        context, AD_UNIT_ID, request,
        AppOpenAd.APP_OPEN_AD_ORIENTATION_PORTRAIT,
        object : AppOpenAdLoadCallback() {

          override fun onAdLoaded(ad: AppOpenAd) {
            // Called when an app open ad has loaded.
            Log.d(LOG_TAG, "Ad was loaded.")
            appOpenAd = ad
            isLoadingAd = false
            loadTime = Date().time
          }

          override fun onAdFailedToLoad(loadAdError: LoadAdError) {
            // Called when an app open ad has failed to load.
            Log.d(LOG_TAG, loadAdError.message)
            isLoadingAd = false;
          }
        })
  }
  // ...
}

wyświetlać reklamę i obsługiwać zdarzenia wywołania zwrotnego w trybie pełnoekranowym.

Najpopularniejszym sposobem wdrożenia reklamy wyświetlanej przy otwarciu aplikacji jest próba wyświetlenia reklamy wyświetlanej przy otwarciu aplikacji. w pobliżu premiery aplikacji, uruchomić treść aplikacji, jeśli reklama nie jest gotowa, i wstępnie wczytać kolejną reklamę do wykorzystania w przyszłości. Zobacz Wskazówki dotyczące reklam wyświetlanych przy otwarciu aplikacji .

Ten kod pokazuje, jak wyświetlić, a następnie ponownie załadować reklamę:

Java

public class MyApplication extends Application {
  // ...
  /** Interface definition for a callback to be invoked when an app open ad is complete. */
  public interface OnShowAdCompleteListener {
    void onShowAdComplete();
  }

  private class AppOpenAdManager {
    // ...

    /** Shows the ad if one isn't already showing. */
    public void showAdIfAvailable(
        @NonNull final Activity activity,
        @NonNull OnShowAdCompleteListener onShowAdCompleteListener){
      // If the app open ad is already showing, do not show the ad again.
      if (isShowingAd) {
        Log.d(LOG_TAG, "The app open ad is already showing.");
        return;
      }

      // If the app open ad is not available yet, invoke the callback then load the ad.
      if (!isAdAvailable()) {
        Log.d(LOG_TAG, "The app open ad is not ready yet.");
        onShowAdCompleteListener.onShowAdComplete();
        loadAd(activity);
        return;
      }

      appOpenAd.setFullScreenContentCallback(
          new FullScreenContentCallback() {

            @Override
            public void onAdDismissedFullScreenContent() {
              // Called when fullscreen content is dismissed.
              // Set the reference to null so isAdAvailable() returns false.
              Log.d(LOG_TAG, "Ad dismissed fullscreen content.");
              appOpenAd = null;
              isShowingAd = false;

              onShowAdCompleteListener.onShowAdComplete();
              loadAd(activity);
            }

            @Override
            public void onAdFailedToShowFullScreenContent(AdError adError) {
              // Called when fullscreen content failed to show.
              // Set the reference to null so isAdAvailable() returns false.
              Log.d(LOG_TAG, adError.getMessage());
              appOpenAd = null;
              isShowingAd = false;

              onShowAdCompleteListener.onShowAdComplete();
              loadAd(activity);
            }

            @Override
            public void onAdShowedFullScreenContent() {
              // Called when fullscreen content is shown.
              Log.d(LOG_TAG, "Ad showed fullscreen content.");
            }
          });
      isShowingAd = true;
      appOpenAd.show(activity);
    }
    // ...
  }
}

Kotlin

class MyApplication : Application() {
  // ...
  /** Interface definition for a callback to be invoked when an app open ad is complete. */
  interface OnShowAdCompleteListener {
    fun onShowAdComplete()
  }

  private inner class AppOpenAdManager {
    // ...

    /** Shows the ad if one isn't already showing. */
    fun showAdIfAvailable(
        activity: Activity,
        onShowAdCompleteListener: OnShowAdCompleteListener) {
      // If the app open ad is already showing, do not show the ad again.
      if (isShowingAd) {
        Log.d(LOG_TAG, "The app open ad is already showing.")
        return
      }

      // If the app open ad is not available yet, invoke the callback then load the ad.
      if (!isAdAvailable()) {
        Log.d(LOG_TAG, "The app open ad is not ready yet.")
        onShowAdCompleteListener.onShowAdComplete()
        loadAd(activity)
        return
      }

      appOpenAd?.setFullScreenContentCallback(
          object : FullScreenContentCallback() {

            override fun onAdDismissedFullScreenContent() {
              // Called when full screen content is dismissed.
              // Set the reference to null so isAdAvailable() returns false.
              Log.d(LOG_TAG, "Ad dismissed fullscreen content.")
              appOpenAd = null
              isShowingAd = false

              onShowAdCompleteListener.onShowAdComplete()
              loadAd(activity)
            }

            override fun onAdFailedToShowFullScreenContent(adError: AdError) {
              // Called when fullscreen content failed to show.
              // Set the reference to null so isAdAvailable() returns false.
              Log.d(LOG_TAG, adError.message)
              appOpenAd = null
              isShowingAd = false

              onShowAdCompleteListener.onShowAdComplete()
              loadAd(activity)
            }

            override fun onAdShowedFullScreenContent() {
              // Called when fullscreen content is shown.
              Log.d(LOG_TAG, "Ad showed fullscreen content.")
            }
          })
      isShowingAd = true
      appOpenAd?.show(activity)
    }
    // ...
  }
}

FullScreenContentCallback obsługuje zdarzenia, takie jak wyświetlenie reklamy, brak jej prezentacji odrzucono.

Ważne: jeśli użytkownik wróci do aplikacji po jej opuszczeniu, klikając reklam wyświetlanych przy otwarciu aplikacji, inna reklama wyświetlana przy otwarciu aplikacji.

Weź pod uwagę czas wygaśnięcia reklamy

Ważne: reklamy wyświetlane przy otwarciu aplikacji wygasają po 4 godzinach. Reklamy renderowane ponad 4 godziny od momentu przesłania prośby utraci ważność i może nie generować przychodów.

Aby nie wyświetlać wygasłej reklamy, dodaj metodę do AppOpenAdManager który sprawdza, ile czasu upłynęło od załadowania Twojego odwołania do reklamy. Następnie użyj aby sprawdzić, czy reklama jest nadal prawidłowa.

Java

private class AppOpenAdManager {
  // ...
  /** Keep track of the time an app open ad is loaded to ensure you don't show an expired ad. */
  private long loadTime = 0;

  // ...

  /** Utility method to check if ad was loaded more than n hours ago. */
  private boolean wasLoadTimeLessThanNHoursAgo(long numHours) {
    long dateDifference = (new Date()).getTime() - this.loadTime;
    long numMilliSecondsPerHour = 3600000;
    return (dateDifference < (numMilliSecondsPerHour * numHours));
  }

  /** Check if ad exists and can be shown. */
  public boolean isAdAvailable() {
    return appOpenAd != null && wasLoadTimeLessThanNHoursAgo(4);
  }
}

Kotlin

private inner class AppOpenAdManager {
  // ...
  /** Keep track of the time an app open ad is loaded to ensure you don't show an expired ad. */
  private var loadTime: Long = 0;

  // ...

  /** Utility method to check if ad was loaded more than n hours ago. */
  private fun wasLoadTimeLessThanNHoursAgo(numHours: Long): Boolean {
    val dateDifference: Long = Date().time - loadTime
    val numMilliSecondsPerHour: Long = 3600000
    return dateDifference < numMilliSecondsPerHour * numHours
  }

  /** Check if ad exists and can be shown. */
  private fun isAdAvailable(): Boolean {
    return appOpenAd != null && wasLoadTimeLessThanNHoursAgo(4)
  }
}

Śledź bieżącą aktywność

Aby wyświetlać reklamę, potrzebujesz kontekstu w języku: Activity. Aby śledzić najbardziej w danym działaniu, zarejestruj i zaimplementuj Application.ActivityLifecycleCallbacks

Java

public class MyApplication extends Application implements ActivityLifecycleCallbacks {

  private Activity currentActivity;

  @Override
  public void onCreate() {
    super.onCreate();
    this.registerActivityLifecycleCallbacks(this);
    // ...
  }

  /** ActivityLifecycleCallback methods. */
  @Override
  public void onActivityCreated(Activity activity, Bundle savedInstanceState) {}

  @Override
  public void onActivityStarted(Activity activity) {
    currentActivity = activity
  }

  @Override
  public void onActivityResumed(Activity activity) {}

  @Override
  public void onActivityStopped(Activity activity) {}

  @Override
  public void onActivityPaused(Activity activity) {}

  @Override
  public void onActivitySaveInstanceState(Activity activity, Bundle bundle) {}

  @Override
  public void onActivityDestroyed(Activity activity) {}
}

Kotlin

class MyApplication : Application(), Application.ActivityLifecycleCallbacks {

  private var currentActivity: Activity? = null

  override fun onCreate() {
    super.onCreate()
    registerActivityLifecycleCallbacks(this)
    // ...
  }

  /** ActivityLifecycleCallback methods. */
  override fun onActivityCreated(activity: Activity, savedInstanceState: Bundle?) {}

  override fun onActivityStarted(activity: Activity) {
    currentActivity = activity
  }

  override fun onActivityResumed(activity: Activity) {}

  override fun onActivityPaused(activity: Activity) {}

  override fun onActivityStopped(activity: Activity) {}

  override fun onActivitySaveInstanceState(activity: Activity, outState: Bundle) {}

  override fun onActivityDestroyed(activity: Activity) {}
}

registerActivityLifecycleCallbacks umożliwia nasłuchiwanie wszystkich zdarzeń Activity. Poprzez nasłuchiwanie, kiedy aktywność rozpoczęte i zniszczone, możesz śledzić odwołanie do bieżącego Activity. Wykorzystasz go do wyświetlania reklamy wyświetlanej przy otwarciu aplikacji.

Nasłuchuj zdarzeń działania aplikacji na pierwszym planie

Dodawanie bibliotek do pliku Gradle

Aby otrzymywać powiadomienia o zdarzeniach działania aplikacji na pierwszym planie, musisz zarejestrować DefaultLifecycleObserver Dodaj zależność do pliku kompilacji na poziomie aplikacji:

Kotlin

  dependencies {
    implementation("com.google.android.gms:play-services-ads:23.3.0")
    implementation("androidx.lifecycle:lifecycle-process:2.8.3")
  }

Zakręcony

  dependencies {
    implementation 'com.google.android.gms:play-services-ads:23.3.0'
    implementation 'androidx.lifecycle:lifecycle-process:2.8.3'
  }

Wdróż interfejs obserwacji cyklu życia

Możesz nasłuchiwać zdarzeń działających na pierwszym planie przez zaimplementowanie tagu Interfejs DefaultLifecycleObserver.

Aby wyświetlać reklamę wyświetlaną przy otwarciu aplikacji, zaimplementuj zdarzenie onStart.

Java

public class MyApplication extends Application
    implements ActivityLifecycleCallbacks, LifecycleObserver {
  // ...
  @Override
  public void onCreate() {
    super.onCreate();
    this.registerActivityLifecycleCallbacks(this);
    new Thread(
            () -> {
              // Initialize the Google Mobile Ads SDK on a background thread.
              MobileAds.initialize(this, initializationStatus -> {});
            })
        .start();
    ProcessLifecycleOwner.get().getLifecycle().addObserver(this);
    appOpenAdManager = new AppOpenAdManager();
  }

  /** LifecycleObserver method that shows the app open ad when the app moves to foreground. */
  @OnLifecycleEvent(Event.ON_START)
  protected void onMoveToForeground() {
    // Show the ad (if available) when the app moves to foreground.
    appOpenAdManager.showAdIfAvailable(currentActivity);
  }

  /** Show the ad if one isn't already showing. */
  private void showAdIfAvailable(@NonNull final Activity activity) {
      showAdIfAvailable(
          activity,
          new OnShowAdCompleteListener() {
            @Override
            public void onShowAdComplete() {
              // Empty because the user will go back to the activity that shows the ad.
            }
          });
  }
}

Kotlin

class MyApplication : Application(),
    Application.ActivityLifecycleCallbacks, LifecycleObserver {
  // ...
  override fun onCreate() {
    super.onCreate()
    registerActivityLifecycleCallbacks(this)
    val backgroundScope = CoroutineScope(Dispatchers.IO)
    backgroundScope.launch {
      // Initialize the Google Mobile Ads SDK on a background thread.
      MobileAds.initialize(this@MyApplication) {}
    }
    ProcessLifecycleOwner.get().lifecycle.addObserver(this)
    appOpenAdManager = AppOpenAdManager()
  }

  /** LifecycleObserver method that shows the app open ad when the app moves to foreground. */
  @OnLifecycleEvent(Lifecycle.Event.ON_START)
  fun onMoveToForeground() {
    // Show the ad (if available) when the app moves to foreground.
    currentActivity?.let {
      appOpenAdManager.showAdIfAvailable(it)
    }
  }

  /** Show the ad if one isn't already showing. */
  fun showAdIfAvailable(activity: Activity) {
    showAdIfAvailable(
        activity,
        object : OnShowAdCompleteListener {
          override fun onShowAdComplete() {
            // Empty because the user will go back to the activity that shows the ad.
          }
        })
  }
}

Uruchomienia „na zimno” i ekrany wczytywania

Dotychczasowa dokumentacja zakłada, że reklamy wyświetlane przy otwarciu aplikacji aplikacji na pierwszym planie, gdy jest zawieszona w pamięci. „Uruchomienia „na zimno” występują, gdy aplikacja została uruchomiona, ale nie była wcześniej zawieszona w pamięci.

Przykładem uruchomienia „na zimno” jest uruchomienie aplikacji przez użytkownika po raz pierwszy. W przypadku uruchomienia „na zimno” nie masz już wczytanej wcześniej reklamy wyświetlanej przy otwarciu aplikacji, będą widoczne od razu. Czas upływający między żądaniem reklamy a jej otrzymaniem może spowodować, że użytkownicy będą mogli przez krótki czas korzystać z aplikacji, że zaskoczyła Cię reklama wyręta z kontekstu. Należy tego unikać, ponieważ jest to co pogarsza wrażenia użytkowników.

Preferowany sposób wyświetlania reklam wyświetlanych przy otwarciu aplikacji przy uruchomieniach „na zimno” to użycie ekranu wczytywania. by wczytać grę lub komponenty z linkiem do aplikacji i wyświetlać reklamę tylko ekranu. Jeśli aplikacja została wczytana i przekierowała użytkownika na stronę główną treści aplikacji, nie wyświetlaj reklamy.

Ważne: aby móc nadal wczytywać komponenty z linkiem do aplikacji w trakcie wyświetlania reklamy wyświetlanej przy otwarciu aplikacji wyświetlane, zawsze ładuj zasoby w wątku w tle.

Sprawdzone metody

Reklamy wyświetlane przy otwarciu aplikacji pomagają zarabiać na ekranie wczytywania aplikacji, gdy aplikacja oraz w trakcie jej wprowadzania na rynek, ale warto stosować sprawdzone metody dzięki którym użytkownicy będą chcieli korzystać z Twojej aplikacji. Najlepiej:

• Wyświetlaj pierwszą reklamę wyświetlaną przy otwarciu aplikacji, gdy użytkownicy skorzystają już kilka razy z Twojej aplikacji.
• Wyświetlaj reklamy wyświetlane przy otwarciu aplikacji w czasie, gdy użytkownicy na innych czekali zanim aplikacja się załaduje.
• Jeśli pod reklamą wyświetlaną przy otwarciu aplikacji wyświetla się ekran wczytywania, zakończy się wczytywanie przed zamknięciem reklamy, możesz ekran wczytywania w metodzie onAdDismissedFullScreenContent().

Przykłady w GitHub

• Przykład reklam wyświetlanych przy otwarciu aplikacji: Java | Kotlin

Dalsze kroki

Przejrzyj te tematy:

• Prywatność użytkowników
• Zoptymalizowane inicjowanie i wczytywanie reklam SDK (wersja beta)