Integracja pakietu SDK do reklam mobilnych Google z aplikacją to pierwszy krok wyświetlanie reklam i zarabianie na nich. Po zintegrowaniu pakietu SDK możesz: wybierz format reklamy (np. reklamę natywną lub reklamę z nagrodą) i postępuj zgodnie z instrukcjami go wdrożyć.
Zanim zaczniesz
Aby przygotować aplikację, wykonaj czynności opisane w poniższych sekcjach.
Wymagania wstępne aplikacji
Upewnij się, że plik kompilacji aplikacji używa tych wartości:
- Minimalna wersja pakietu SDK
21lub więcej - Skompiluj wersję pakietu SDK
33lub więcej
- Minimalna wersja pakietu SDK
Konfiguracja aplikacji
W pliku ustawień Gradle dodaj parametr repozytorium Google Maven oraz 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 pakietu SDK do reklam mobilnych Google do kompilacji na poziomie aplikacji plik:
Kotlin
dependencies { implementation("com.google.android.gms:play-services-ads:23.3.0") }
Zakręcony
dependencies { implementation 'com.google.android.gms:play-services-ads:23.3.0' }
Dodaj Ad Manager identyfikator aplikacji określony w Ad Manager do
AndroidManifest.xml. Aby to zrobić, dodaj tag<meta-data>zandroid:name="com.google.android.gms.ads.APPLICATION_ID"Więcej identyfikator aplikacji w Ad Manager interfejsie internetowym. Dla:android:value, wstaw swój identyfikator Ad Manager własnej aplikacji 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="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/> </application> </manifest>W rzeczywistej aplikacji zastąp przykładowy identyfikator aplikacji rzeczywistym identyfikatorem Ad Manager identyfikator aplikacji. Możesz użyć identyfikatora próbki, jeśli: tylko eksperymentujesz z pakietem SDK w aplikacji Hello World.
Pamiętaj też, że dodanie tagu
<meta-data>dokładnie w takiej postaci, w jakiej wyświetlają się wyniki, jeśli wykryje wypadek z taką informacją:Missing application ID.(Opcjonalnie) Zadeklaruj Uprawnienia
AD_ID, aby poprzednie wersje działały z Androidem 13.Jeśli Twoja aplikacja korzysta z pakietu SDK do reklam mobilnych Google w wersji 20.4.0 lub wyżej, możesz pominąć ten krok, ponieważ pakiet SDK automatycznie deklaruje
com.google.android.gms.permission.AD_IDi może zawsze, gdy jest dostępny.W przypadku aplikacji, które korzystają z pakietu SDK do reklam mobilnych Google w wersji 20.3.0 lub niższych wersji i są kierowane na Androida 13, musisz dodać
com.google.android.gms.permission.AD_IDwAndroidManifest.xmlpliku SDK do reklam mobilnych Google do znaleźć identyfikator 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>
Aby dowiedzieć się więcej na temat:
com.google.android.gms.permission.AD_IDdeklaracja uprawnień, , w tym instrukcje, jak ją wyłączyć, znajdziesz w tym artykule w Google Play Artykuł na temat konsoli.
Zainicjowanie pakietu SDK do reklam mobilnych Google
Przed wczytaniem reklam zainicjuj pakiet SDK do reklam mobilnych Google, wywołując polecenieMobileAds.initialize()
Ta metoda inicjuje pakiet SDK i wywołuje detektor ukończenia, gdy Inicjowanie pakietu SDK do reklam mobilnych Google i adaptatora zostało ukończone lub po Limit czasu wynosi 30 sekund. Wystarczy to zrobić tylko raz, najlepiej podczas uruchamiania aplikacji.
Reklamy mogą być wstępnie wczytywane przez pakiet SDK do reklam mobilnych Google lub pakiety SDK partnera zapośredniczenia
podczas inicjowania. Jeśli konieczne jest uzyskanie zgody od użytkowników z Europy,
z Europejskiego Obszaru Gospodarczego (EOG), ustaw flagi dotyczące konkretnych żądań, np.
setTagForChildDirectedTreatment()
lub
setTagForUnderAgeOfConsent(),
lub
w przeciwnym razie podejmij działanie przed wczytaniem reklam, pamiętaj, aby zrobić to przed zainicjowaniem
pakiet SDK do reklam mobilnych Google.
Oto przykład wywołania metody initialize() w tle
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 i możesz już zaimplementować reklamę. Ad Manager udostępnia wiele różnych formatów reklam, możesz wybrać takie, które najlepiej odpowiada użytkownikom Twojej aplikacji.
Baner
W jednostkach banerów reklamowych wyświetlane są prostokątne reklamy, które zajmują część układ. Mogą być automatycznie odświeżane po upływie określonego czasu. Oznacza to, że użytkownicy oglądają nową reklamę w regularnych odstępach czasu, nawet jeśli nie zmieniają się ekranu w aplikacji. Jest to również najprostszy do wdrożenia format reklamy.
Implementowanie banerów reklamowych
Pełnoekranowa
Jednostki reklamy pełnoekranowej umożliwiają wyświetlanie w aplikacji reklam zajmujących całą stronę. Ustaw je w naturalnym przerwy i przejścia w interfejsie aplikacji, np. po ukończeniu poziomu; w grze mobilnej.
Zastosuj reklamy pełnoekranowe
Natywna
Reklamy natywne to reklamy, w których możesz dostosować sposób, w jaki zasoby, takie jak nagłówki, Wezwania do działania są wyświetlane w aplikacjach. Dostosowując styl reklamy, możesz: tworzyć naturalne, dyskretne prezentacje, które wzbudzą zainteresowanie z myślą o użytkownikach.
Google Ad Manager udostępnia dwa sposoby implementacji reklam natywnych: style natywne i standardowych reklam natywnych za pomocą renderowania niestandardowego.
Style natywne zostały opracowane, by uprościć implementację reklam natywnych, To świetny wybór dla osób, które dopiero zaczynają korzystać z tego formatu. Dotychczasowe renderowanie niestandardowe zaprojektowany z myślą o maksymalizacji swobody w tworzeniu prezentacji.
Implementowanie 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 poszczególnych jednostkach reklamowych i określać wartości nagród produkty otrzymane przez użytkownika.
Reklama pełnoekranowa z nagrodą
Reklama pełnoekranowa z nagrodą to nowy format reklam zachęcających do działania, oferuj nagrody, takie jak monety lub dodatkowe życia, za reklamy, które wyświetlają się automatycznie w naturalnych momentach przejściowych aplikacji.
W przeciwieństwie do reklam z nagrodą użytkownicy nie muszą wyrazić zgody na obejrzenie reklamy z nagrodą. reklama pełnoekranowa.
Zamiast prośby o zgodę na wykorzystanie danych w reklamach z nagrodą reklamy pełnoekranowe z nagrodą wymagają: z informacją o nagrodzie i możliwości rezygnacji, jeśli że chcą to robić.
Implementowanie reklam pełnoekranowych z nagrodą
Reklama przy otwarciu aplikacji
Reklamy wyświetlane przy otwarciu aplikacji pojawiają się, gdy użytkownicy otwierają . Reklama nakłada się na ekran wczytywania.
Wdrażanie reklam wyświetlanych przy otwarciu aplikacji
Dodatkowe materiały
Repozytorium reklam mobilnych Google na GitHubie pokazuje, jak korzystać z różnych formatów reklam dostępnych w tym interfejsie API.