Pierwszym krokiem, który musisz wykonać, aby zacząć wyświetlać reklamy i zarabiać, jest integracja pakietu SDK do reklam mobilnych Google z Twoją aplikacją. Po zintegrowaniu pakietu SDK możesz wybrać format reklamy (np. natywną lub wideo z nagrodą) i postępować zgodnie z instrukcjami jego implementacji.
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:
21lub nowsza - Kompilacja pakietu SDK w wersji
34lub nowszej.
- Minimalna wersja pakietu SDK:
Konfiguracja aplikacji
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'
Dodaj zależności dla pakietu SDK do reklam mobilnych Google do pliku kompilacji na poziomie aplikacji:
Kotlin
dependencies { implementation("com.google.android.gms:play-services-ads:23.6.0") }
Zakręcony
dependencies { implementation 'com.google.android.gms:play-services-ads:23.6.0' }
Dodaj identyfikator aplikacji Ad Managera, który znajdziesz w interfejsie internetowym Ad Managera, do pliku
AndroidManifest.xmlaplikacji. Aby to zrobić, dodaj tag<meta-data>z wartościąandroid:name="com.google.android.gms.ads.APPLICATION_ID". Identyfikator aplikacji znajdziesz w interfejsie internetowym Ad Managera. W miejscuandroid:valuewpisz swój 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=" /<network_code>~<application_id>"/> </application> </manifest>W rzeczywistej aplikacji zastąp przykładowy identyfikator aplikacji swoim rzeczywistym identyfikatorem aplikacji Ad Managera. Jeśli eksperymentujesz z pakietem SDK w aplikacji „Hello World”, możesz użyć przykładowego identyfikatora.
Pamiętaj też, że jeśli nie dodasz tagu
<meta-data>dokładnie w takiej postaci, jak pokazano, aplikacja ulegnie awarii z komunikatem:Missing application ID.(Opcjonalnie) Zadeklaruj uprawnienia
AD_IDdla poprzednich wersji, aby działały z Androidem 13.Jeśli Twoja aplikacja korzysta z pakietu SDK do reklam mobilnych Google w wersji 20.4.0 lub nowszej, możesz pominąć ten krok, ponieważ pakiet SDK automatycznie deklaruje uprawnienia
com.google.android.gms.permission.AD_IDi może uzyskiwać dostęp do identyfikatora wyświetlania reklam, gdy jest on dostępny.W przypadku aplikacji, które korzystają z pakietu SDK do reklam mobilnych Google w wersji 20.3.0 lub niższej i które kierują się na Androida 13, musisz dodać uprawnienie
com.google.android.gms.permission.AD_IDw plikuAndroidManifest.xmlpakietu SDK do reklam mobilnych Google, aby 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 Konsoli Play.
Inicjalizacja pakietu SDK do reklam mobilnych Google
Przed wczytywaniem reklam zainicjuj pakiet SDK do reklam mobilnych Google, wywołując funkcjęMobileAds.initialize().
Ta metoda inicjuje pakiet SDK i wywołuje detektory zakończenia po zakończeniu inicjowania pakietu SDK do reklam mobilnych Google i adaptera albo po 30-sekundowym czasie oczekiwania. Wystarczy to zrobić tylko raz, najlepiej podczas uruchamiania aplikacji.
Reklamy mogą być wstępnie wczytane przez pakiet SDK do reklam mobilnych Google lub pakiety SDK partnerów zapośredniczenia podczas inicjowania. Jeśli musisz uzyskać zgodę użytkowników z Europejskiego Obszaru Gospodarczego (EOG), ustaw odpowiednie flagi żądania, np. setTagForChildDirectedTreatment() lub setTagForUnderAgeOfConsent(), lub wykonaj inne czynności przed załadowaniem reklam. Upewnij się, że robisz to przed zainicjowaniem pakietu SDK do reklam mobilnych Google.
Oto przykład wywołania metody initialize() w wątku tła w ramach aktywności:
Java
import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;
public class MainActivity extends AppCompatActivity {
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
new Thread(
() -> {
// Initialize the Google Mobile Ads SDK on a background thread.
MobileAds.initialize(this, initializationStatus -> {});
})
.start();
}
}
Kotlin
import com.google.android.gms.ads.MobileAds
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 the Google Mobile Ads SDK on a background thread.
MobileAds.initialize(this@MainActivity) {}
}
}
}
Wybierz format reklamy
Pakiet SDK do reklam mobilnych Google został zaimportowany, więc możesz zaimplementować reklamę. Ad Manager oferuje wiele różnych formatów reklam, więc możesz wybrać ten, który najlepiej pasuje do wrażeń użytkownika w aplikacji.
Baner
W jednostkach z banerami reklamowymi wyświetlają się 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.
Pełnoekranowa
Jednostki reklam pełnoekranowych wyświetlają w aplikacji reklamy zajmujące całą stronę. Umieść je w naturalnych przerwach między elementami strony lub podczas przejścia z jednego etapu do następnego w interfejsie aplikacji, np. po ukończeniu poziomu w aplikacji z grą.
Wdrażanie reklam pełnoekranowych
Natywna
Reklamy natywne umożliwiają dostosowanie sposobu wyświetlania w aplikacji komponentów takich jak nagłówki i wezwania do działania. Samodzielne nadawanie reklamie stylu pozwala tworzyć naturalne, nieinwazyjne prezentacje reklam, które mogą wzbogacać wrażenia użytkowników.
Google Ad Manager udostępnia 2 metody implementacji reklam natywnych: style natywne i standardowe reklamy natywne za pomocą renderowania niestandardowego.
Style natywne zostały zaprojektowane w celu uproszczenia implementacji reklam natywnych. To świetny wybór, jeśli dopiero zaczynasz korzystać z tego formatu. Renderowanie niestandardowe zostało zaprojektowane tak, aby maksymalnie zwiększyć swobodę 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 korzyści, które otrzymają użytkownicy.
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ą wyrażać 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 nagrodach za obejrzenie danej reklamy i dają użytkownikowi możliwość jej pominięcia.
Wdrażanie reklam pełnoekranowych z nagrodą
Otwarcie aplikacji
Reklama wyświetlana przy otwarciu aplikacji to format reklamy, który pojawia się, gdy użytkownicy otwierają aplikację lub do niej wracają. Reklama nakłada się na ekran wczytywania.
Wdrażanie reklam wyświetlanych przy otwarciu aplikacji
Dodatkowe materiały
Repozytorium Google Mobile Ads na GitHubie zawiera przykłady korzystania z różnych formatów reklam oferowanych przez ten interfejs API.