Konfigurowanie pakietu SDK nowej generacji do reklam mobilnych Google

Zintegrowanie GMA Next-Gen SDK z aplikacją to pierwszy krok do wyświetlania reklam displayowych i generowania przychodów. Po zintegrowaniu pakietu SDK możesz wybrać format reklamy (np. natywną lub wideo z nagrodą) i wykonać czynności, aby go wdrożyć.

Zanim zaczniesz

Aby przygotować aplikację, wykonaj czynności opisane w poniższych sekcjach.

Wymagania wstępne dotyczące aplikacji

  • Sprawdź, czy w pliku kompilacji Twojej aplikacji znajdują się te wartości:

    • Minimalna wersja pakietu SDK: 24 lub nowsza
    • Wersja pakietu SDK do kompilacji: 35 lub nowsza
  • W przypadku aplikacji w Kotlinie używaj Kotlina w wersji co najmniej 1.9.

Konfigurowanie aplikacji na koncie AdMob

Aby zarejestrować aplikację jako aplikację w AdMob:

  1. Zaloguj się na konto AdMob lub zarejestruj się.

  2. Zarejestruj aplikację w AdMob. W ten sposób utworzysz aplikację w AdMob z unikalnym identyfikatorem aplikacji w AdMob, który będzie potrzebny w dalszej części tego przewodnika.

Konfiguracja aplikacji

  1. W pliku ustawień Gradle dodaj repozytorium Google Maven i centralne repozytorium Maven:

    Kotlin

    pluginManagement {
  repositories {
    google()
    mavenCentral()
    gradlePluginPortal()
  }
}

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
  }
}

rootProject.name = "My Application"
include(":app")

    Zakręcony

    pluginManagement {
  repositories {
    google()
    mavenCentral()
    gradlePluginPortal()
  }
}

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
  }
}

rootProject.name = "My Application"
include ':app'

  2. Dodaj zależności dla GMA Next-Gen SDK do pliku kompilacji na poziomie aplikacji:

    Kotlin

    dependencies {
  implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0")
}

    Zakręcony

    dependencies {
  implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0'
}

  3. Kliknij Synchronizuj teraz. Szczegółowe informacje o synchronizacji znajdziesz w artykule Synchronizowanie projektów z plikami Gradle.

Inicjowanie GMA Next-Gen SDK

Wywołaj MobileAds.initialize(), aby zainicjować GMA Next-Gen SDK. Należy to wywołać w wątku w tle. Jeśli tego nie zrobisz, może wystąpić błąd „Aplikacja nie odpowiada” (ANR).

Kotlin

import com.google.android.libraries.ads.mobile.sdk.MobileAds
import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch

class MainActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    val backgroundScope = CoroutineScope(Dispatchers.IO)
    backgroundScope.launch {
      // Initialize GMA Next-Gen SDK on a background thread.
      MobileAds.initialize(
        this@MainActivity,
        // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
        InitializationConfig.Builder("SAMPLE_APP_ID").build()
      ) {
        // Adapter initialization is complete.
      }
      // SDK initialization is complete. If you don't want to wait for bidding adapters to finish
      // initializing, start loading ads now.
    }
  }
}

Java

import com.google.android.libraries.ads.mobile.sdk.MobileAds;
import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig;

public class MainActivity extends AppCompatActivity {
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    new Thread(
            () -> {
              // Initialize GMA Next-Gen SDK on a background thread.
              MobileAds.initialize(
                  this,
                  // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
                  new InitializationConfig.Builder("SAMPLE_APP_ID")
                      .build(),
                  initializationStatus -> {
                    // Adapter initialization is complete.
                  });
              // SDK initialization is complete. If you don't want to wait for bidding adapters to
              // finish initializing, start loading ads now.
            })
        .start();
  }
}

Ta metoda inicjuje pakiet SDK i wywołuje detektor zakończenia po zakończeniu inicjowania pakietu GMA Next-Gen SDK i adaptera lub po 30 sekundach bezczynności. Należy to zrobić tylko raz, najlepiej przy uruchomieniu aplikacji.

Jeśli korzystasz z zapośredniczenia AdMob, przed wczytaniem reklam poczekaj na wywołanie procedury obsługi zakończenia. Dzięki temu wszystkie adaptery zapośredniczenia zostaną zainicjowane.

Reklamy mogą być wstępnie wczytywane przez pakiety SDK GMA Next-Gen SDK lub partnerów zapośredniczenia podczas inicjowania. Jeśli musisz uzyskać zgodę użytkowników z Europejskiego Obszaru Gospodarczego (EOG), Wielkiej Brytanii lub Szwajcarii, ustaw odpowiednie flagi dotyczące żądań, np. RequestConfiguration.TagForChildDirectedTreatment lub RequestConfiguration.TagForUnderAgeOfConsent, albo podejmij działanie przed wczytaniem reklam. Pamiętaj, aby zrobić to przed zainicjowaniem GMA Next-Gen SDK.

Wybierz format reklamy

Pakiet GMA Next-Gen SDK został zaimportowany i możesz już wdrożyć reklamę. AdMob oferuje wiele różnych formatów reklam, dzięki czemu możesz wybrać ten, który najlepiej pasuje do Twojej aplikacji.

W jednostkach banerów reklamowych wyświetlane są prostokątne reklamy, które zajmują część układu aplikacji. Mogą one być automatycznie odświeżane po upływie określonego czasu. Oznacza to, że użytkownicy zobaczą nowe reklamy w regularnych odstępach czasowych, nawet jeśli pozostaną na tym samym ekranie w aplikacji. Jest to format reklamy najprostszy do wdrożenia.

Implementowanie banerów reklamowych

Pełnoekranowa

Pełnoekranowe jednostki reklamowe wyświetlają w aplikacji reklamy zajmujące całą stronę. Umieść je w naturalnych przerwach i przejściach w interfejsie aplikacji, np. po ukończeniu poziomu w grze w aplikacji z grą mobilną.

Implementowanie reklam pełnoekranowych

Rodzimy użytkownik

Reklamy natywne to reklamy, w których możesz dostosować sposób prezentowania w aplikacjach komponentów takich jak nagłówki i wezwania do działania. Dzięki samodzielnemu stylizowaniu reklamy możesz tworzyć naturalne, nienachalne prezentacje reklam, które mogą wzbogacić wrażenia użytkowników.

Wdrażanie reklam natywnych

Z nagrodą

Jednostki reklamowe z nagrodą umożliwiają użytkownikom granie w gry, wypełnianie ankiet lub oglądanie filmów, aby zdobywać nagrody w aplikacji, takie jak monety, dodatkowe życia lub punkty. Możesz ustawić różne nagrody w różnych jednostkach reklamowych i określić wartości nagród oraz elementy, które otrzymają użytkownicy.

Wdrażanie reklam z nagrodą

Reklama pełnoekranowa z nagrodą

Reklama pełnoekranowa z nagrodą to nowy format reklamy zachęcającej użytkownika do jej obejrzenia. Umożliwia uzyskanie nagród w aplikacji, takich jak monety lub dodatkowe życia. Reklamy tego typu wyświetlają się automatycznie w naturalnych momentach przejściowych w aplikacji.

W przeciwieństwie do reklam z nagrodą użytkownicy nie muszą wyrazić zgody na wyświetlenie reklamy pełnoekranowej z nagrodą.

Zamiast prośby o akceptację stosowanej w reklamach z nagrodą reklamy pełnoekranowe z nagrodą na początku wyświetlają ekran z informacjami o nagrodzie i dają użytkownikom możliwość rezygnacji, jeśli tego chcą.

Wdrażanie reklam pełnoekranowych z nagrodą

Reklama przy otwarciu aplikacji

Reklama wyświetlana przy otwarciu aplikacji to format reklamy, który wyświetla się, gdy użytkownicy otwierają aplikację lub do niej wracają. Reklama nakłada się na wczytywany ekran.

Wdrażanie reklam wyświetlanych przy otwarciu aplikacji

Obraz w obrazie (beta)

Obraz w obrazie

Reklamy typu obraz w obrazie (PiP) wyświetlają się w pływającym oknie, które pozostaje na górze treści na ekranie. Ten format umożliwia użytkownikom interakcję z aplikacją, podczas gdy reklama pozostaje widoczna.

Wdrażanie reklam typu obraz w obrazie