Konfigurowanie pakietu SDK do reklam mobilnych Google

Wybierz platformę: Android (beta) Nowość Android iOS Unity Flutter

Pierwszym krokiem, który musisz wykonać, aby zacząć wyświetlać reklamy i zarabiać, jest integracja Google Mobile Ads SDK z Twoją aplikacją. Po zintegrowaniu pakietu SDK możesz wybrać format reklamy (np. natywną lub wideo z nagrodą) i postępować zgodnie z instrukcjami, aby ją 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: 23 lub nowsza
    • Wersja pakietu SDK do kompilacji: 35 lub nowsza

Konfiguracja aplikacji

  1. W pliku ustawień Gradle dodaj repozytorium Maven firmy Google 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")

    Groovy

    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 pakietu SDK do reklam mobilnych Google do pliku kompilacji na poziomie aplikacji:Google Mobile Ads SDK

    Kotlin

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

    Groovy

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

  3. Kliknij Synchronizuj teraz. Więcej informacji 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 android:name="com.google.android.gms.ads.APPLICATION_ID". **Identyfikator aplikacji** znajdziesz w interfejsie internetowym Ad Managera. W atrybucie android:value wpisz 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 Ad Managera. Podczas testowania użyj przykładowego identyfikatora aplikacji pokazanego 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ę ten komunikat:

    Missing application ID.

    (Opcjonalnie) Zadeklaruj AD_ID uprawnienie w przypadku starszych wersji, aby działały one w Androidzie 13.

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

    W przypadku aplikacji, które używają Google Mobile Ads SDK 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 Google Mobile Ads SDK mógł uzyskać 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 deklarowaniu uprawnienia com.google.android.gms.permission.AD_ID, w tym o jego wyłączaniu, znajdziesz w tym artykule w Centrum pomocy Konsoli Play.

Inicjowanie pakietu SDK do reklam mobilnych GoogleGoogle Mobile Ads SDK

Zanim aplikacja wczyta reklamy, musi zainicjować Google Mobile Ads SDK wywołując MobileAds.initialize().

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

Jeśli używasz mediacji, przed wczytaniem reklam poczekaj, aż zostanie wywołany moduł obsługi zakończenia. Dzięki temu wszystkie adaptery mediacji zostaną zainicjowane.

Reklamy mogą być wstępnie wczytywane przez Google Mobile Ads SDK lub pakiety SDK partnerów mediacji podczas inicjowania. Jeśli musisz uzyskać zgodę użytkowników w Europejskim Obszarze Gospodarczym (EOG), ustawić flagi związane z żądaniem, takie jak setTagForChildDirectedTreatment() lub setTagForUnderAgeOfConsent(), albo podjąć inne działania przed wczytaniem reklam, zrób to przed zainicjowaniem Google Mobile Ads SDK.

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();
MyActivity.java

Kotlin

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

Wybierz format reklamy

Google Mobile Ads SDK został zaimportowany i możesz wdrożyć reklamę. Ad Manager oferuje wiele różnych formatów reklam, dzięki czemu możesz wybrać ten, który najlepiej pasuje do wrażeń użytkownika w 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 również najprostszy format reklamy do wdrożenia.

Wdrażanie banerów reklamowych

Pełnoekranowa

Jednostki reklam pełnoekranowych wyświetlają w aplikacji reklamy zajmujące całą stronę. Umieść je między elementami lub w przejściach aplikacji, tak aby pasowały do interfejsu, np. po ukończeniu poziomu w grze w aplikacji z grą mobilną.

Wdrażanie reklam pełnoekranowych

Natywna

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

Google Ad Manager oferuje 2 sposoby wdrażania reklam natywnych: style natywne i standardowe reklamy natywne z renderowaniem niestandardowym.

Style natywne zostały zaprojektowane tak, aby uprościć wdrażanie reklam natywnych, jest 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ę w tworzeniu 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 zgodę stosowanej w reklamach z nagrodą reklamy pełnoekranowe z nagrodą na początku wyświetlają ekran z informacjami o nagrodzie za obejrzenie danej reklamy i dają użytkownikowi możliwość jej pominięcia.

Wdrażanie reklam pełnoekranowych z nagrodą

Reklamy wyświetlane przy otwarciu aplikacji

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

Wdrażanie reklam wyświetlanych przy otwarciu aplikacji

Dodatkowe materiały

W repozytorium pakietu SDK do reklam mobilnych Google w GitHubie znajdziesz informacje o tym, jak używać różnych formatów reklam oferowanych przez ten interfejs API.