Konfigurowanie pakietu SDK do reklam mobilnych Google (starsza wersja)

Wybierz platformę: Android iOS Unity Flutter Android (starsza wersja)

Zintegrowanie Google Mobile Ads SDK (Legacy) 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

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 Google Mobile Ads SDK (Legacy) do pliku kompilacji na poziomie aplikacji:

    Kotlin

    dependencies {
  implementation("com.google.android.gms:play-services-ads:25.5.0")
}

    Zakręcony

    dependencies {
  implementation 'com.google.android.gms:play-services-ads:25.5.0'
}

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

  4. Dodaj identyfikator aplikacji Ad Managera, określony w interfejsie internetowym Ad Managera, do pliku AndroidManifest.xml aplikacji. Aby to zrobić, dodaj tag <meta-data> z atrybutem android:name="com.google.android.gms.ads.APPLICATION_ID". Identyfikator aplikacji znajdziesz w interfejsie internetowym Ad Managera. W miejscu android:value wstaw identyfikator aplikacji Ad Managera (w cudzysłowie).

    <manifest>
  <application>
    <!-- Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713 -->
    <meta-data
        android:name="com.google.android.gms.ads.APPLICATION_ID"
        android:value="SAMPLE_APP_ID"/>
  </application>
</manifest>

    Zastąp SAMPLE_APP_ID identyfikatorem aplikacji w usłudze Ad Manager. Podczas testowania użyj identyfikatora przykładowej aplikacji podanego w poprzednim przykładzie.

    Pamiętaj też, że jeśli nie dodasz tagu <meta-data> dokładnie tak, jak pokazano, aplikacja ulegnie awarii i wyświetli się komunikat:

    Missing application ID.

    (Opcjonalnie) Zadeklaruj uprawnienie AD_ID, aby poprzednie wersje działały na Androidzie 13.

    Jeśli Twoja aplikacja używa pakietu Google Mobile Ads SDK (Legacy) w wersji 20.4.0 lub nowszej, możesz pominąć ten krok, ponieważ pakiet SDK automatycznie deklaruje uprawnienie com.google.android.gms.permission.AD_ID i może uzyskać dostęp do identyfikatora wyświetlania reklam, gdy tylko jest on dostępny.

    W przypadku aplikacji, które używają pakietu Google Mobile Ads SDK (Legacy) w wersji 20.3.0 lub starszej i są kierowane na Androida 13, musisz dodać uprawnienie com.google.android.gms.permission.AD_ID w pliku AndroidManifest.xml, aby pakiet Google Mobile Ads SDK (Legacy) miał dostęp do identyfikatora wyświetlania reklam:

    <manifest>
 <application>
   <meta-data
       android:name="com.google.android.gms.ads.APPLICATION_ID"
       android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>

   <!-- For apps targeting Android 13 or higher & GMA SDK version 20.3.0 or lower -->
   <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>

 </application>
</manifest>

    Więcej informacji o deklaracji uprawnień com.google.android.gms.permission.AD_ID, w tym o tym, jak je wyłączyć, znajdziesz w tym artykule o Konsoli Play.

Inicjowanie Google Mobile Ads SDK (Legacy)

Zanim wczytasz reklamy, zainicjuj Google Mobile Ads SDK (Legacy), wywołując funkcję MobileAds.initialize().

Ta metoda inicjuje pakiet SDK i wywołuje detektor zakończenia po zakończeniu inicjowania pakietu Google Mobile Ads SDK (Legacy) i adaptera lub po 30 sekundach bezczynności. Należy to zrobić tylko raz, najlepiej przy uruchomieniu aplikacji.

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

Reklamy mogą być wstępnie wczytywane przez pakiety SDK Google Mobile Ads SDK (Legacy) 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 flagi związane z żądaniem, takie jak setTagForChildDirectedTreatment() lub setTagForUnderAgeOfConsent(), albo podejmij działanie przed wczytaniem reklam. Pamiętaj, aby zrobić to przed zainicjowaniem Google Mobile Ads SDK (Legacy).

Oto przykład wywołania metody initialize() w wątku w tle w ramach aktywności:

Java

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

Kotlin

CoroutineScope(Dispatchers.IO).launch {
  // Initialize the Google Mobile Ads SDK on a background thread.
  MobileAds.initialize(this@MyActivity) {}
}

Wybierz format reklamy

Pakiet Google Mobile Ads SDK (Legacy) został zaimportowany i możesz już wdrożyć reklamę. Ad Manager 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ą.

Zaimplementuj reklamy pełnoekranowe

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.

Google Ad Manager udostępnia 2 sposoby implementacji reklam natywnych: style natywne i standardowe reklamy natywne renderowane niestandardowo.

Style natywne zostały zaprojektowane tak, aby uprościć wdrażanie reklam natywnych. To świetny wybór, jeśli dopiero zaczynasz korzystać z tego formatu. Renderowanie niestandardowe zostało zaprojektowane tak, aby zapewnić Ci jak największą swobodę podczas tworzenia prezentacji.

Wdrażanie stylów natywnych Wdrażanie reklam natywnych (renderowanie niestandardowe)

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

Dodatkowe materiały

Repozytorium Google Mobile Ads na GitHubie pokazuje, jak korzystać z różnych formatów reklam oferowanych przez ten interfejs API.