Z tego przewodnika dowiesz się, jak korzystać z pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklamy z i-mobile za pomocą mediacji, na temat integracji kaskadowych. Wyjaśniamy, jak dodać i-mobile do jednostki reklamowej konfiguracji zapośredniczenia i integrowania pakietu SDK i adaptera i-mobile aplikację Android .
Interfejs panelu w i-mobile zawiera etykiety, przyciski i opisy w języku japońskim. Zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. W opisach i instrukcjach w tym przewodniku etykiety i przyciski są jednak tłumaczone z odpowiednimi odpowiednikami w języku angielskim w nawiasach.
Obsługiwane integracje i formaty reklam
Adapter zapośredniczenia na urządzenia i-mobile:
Integracja | |
---|---|
Określanie stawek | |
Wodospad | |
Formaty | |
Baner | |
Pełnoekranowa | |
Z nagrodą | |
Natywna |
Wymagania
- Interfejs API Androida na poziomie 21 lub wyższym
Najnowsza wersja pakietu SDK do reklam mobilnych Google
Przejdź przez proces zapośredniczenia, korzystając z przewodnika dla początkujących.
Krok 1. Skonfiguruj konfiguracje w interfejsie użytkownika i-mobile
Krok 2. Skonfiguruj źródła ofert reklamowych i-mobile w Ad Manager interfejsie
Krok 3. Zaimportuj pakiet SDK i-mobile Adapter i-mobile
Integracja z Android Studio (zalecana)
W pliku settings.gradle.kts
na poziomie projektu dodaj:
repozytoria:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://imobile.github.io/adnw-sdk-android")
}
}
}
Następnie w pliku build.gradle.kts
na poziomie aplikacji dodaj te elementy
zależności i konfiguracje wdrożenia. Użyj najnowszych wersji
Pakiet SDK i adapter i-mobile:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.3.0")
implementation("com.google.ads.mediation:imobile:2.3.2.0")
}
Integracja ręczna
Pobierz najnowszą wersję i-mobile SDK i wyodrębnij plik
android-ad-sdk.aar
w folderzesdk
i dodaj go do swojego projektu.Przejdź do artefaktów adaptera i-mobile w repozytorium Google Maven. Wybierz najnowszą wersję, pobierz i-mobile
.aar
adaptera i dodaj go do projektu.
Krok 4. Dodaj wymagany kod
Integracja z i-mobile nie wymaga dodatkowego kodu.
Krok 5. Przetestuj implementację
Włącz reklamy testowe
Zarejestruj urządzenie testowe na potrzeby Ad Manager. i-mobile udostępnia testowe identyfikator Spotu, identyfikator mediów i identyfikator wydawcy na potrzeby testów. Znajdziesz je tutaj.
Weryfikacja reklam testowych
Aby sprawdzić, czy otrzymujesz reklamy testowe z witrynyi-mobile, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając z i-mobile (Waterfall) źródeł reklam.
Kroki opcjonalne:
Korzystanie z reklam natywnych
Renderowanie reklam
Adapter i-mobile spełnia te wymagania
pola
dla
NativeAd
Pole | Zasoby zawsze uwzględniane przez adapter i-mobile |
---|---|
Nagłówek | |
Obraz | |
Treść | |
Ikona aplikacji | 1 |
Wezwanie do działania | |
Ocena w gwiazdkach | |
Sklep | |
Cena |
1 W przypadku reklam natywnych pakiet SDK i-mobile nie udostępnia komponentu z ikoną aplikacji. Zamiast tego: adapter i-mobile wypełnia ikonę aplikacji przezroczystym obrazem.
Kody błędów
Jeśli adapter nie odbierze reklamy z i-mobile,
wydawcy mogą sprawdzić przyczynę błędu w odpowiedzi za pomocą polecenia
ResponseInfo.getAdapterResponses()
w następujących klasach:
Format | Nazwa zajęć |
---|---|
Baner | com.google.ads.mediation.imobile.IMobileAdapter |
Pełnoekranowa | com.google.ads.mediation.imobile.IMobileAdapter |
Natywna | com.google.ads.mediation.imobile.IMobileMediationAdapter |
Oto kody i dołączone komunikaty z adaptera i-mobile, gdy nie udaje się załadować reklamy:
Kod błędu | Przyczyna |
---|---|
0-99 | Pakiet SDK i-mobile zwrócił błąd. Zobacz kod . |
101 | Aby wczytywać reklamy, i-mobile wymaga kontekstu Activity . |
102 | Brak parametrów serwera i-mobile skonfigurowanych w Ad Manager interfejsie lub są one nieprawidłowe. |
103 | Żądany rozmiar reklamy nie odpowiada obsługiwanemu przez i-mobile rozmiarowi banera. |
104 | Wywołanie zwrotne udanego wczytywania reklam natywnych i-mobile zwróciło pustą listę reklam natywnych. |
i-mobile dziennik zmian adaptera zapośredniczenia Androida
Wersja 2.3.2.0
- Zweryfikowano zgodność z pakietem SDK i-mobile w wersji 2.3.2.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 23.1.0.
- Pakiet SDK IMobile w wersji 2.3.2.
Wersja 2.3.1.2
- Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 23.0.0.
- Zweryfikowano zgodność z pakietem SDK i-mobile w wersji 2.3.1.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 23.0.0.
- Pakiet SDK IMobile w wersji 2.3.1.
Wersja 2.3.1.1
- Zaktualizowano adapter, aby używał nowej klasy
VersionInfo
. - Minimalna wymagana wersja pakietu SDK do reklam mobilnych Google została zaktualizowana do 22.0.0.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 22.0.0.
- Pakiet SDK IMobile w wersji 2.3.1.
Wersja 2.3.1.0
- Zweryfikowano zgodność z pakietem SDK i-mobile w wersji 2.3.1.
- Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 21.5.0.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 21.5.0.
- Pakiet SDK IMobile w wersji 2.3.1.
Wersja 2.3.0.0
- Zweryfikowano zgodność z pakietem SDK i-mobile w wersji 2.3.0.
- Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 21.3.0.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 21.3.0.
- Pakiet SDK IMobile w wersji 2.3.0.
Wersja 2.0.23.1
- Zaktualizowano
compileSdkVersion
itargetSdkVersion
do interfejsu API 31. - Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 21.0.0.
- Zaktualizowano minimalny wymagany poziom interfejsu API Androida na 19.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 21.0.0.
- Pakiet SDK IMobile w wersji 2.0.23.
Wersja 2.0.23.0
- Zweryfikowano zgodność z pakietem SDK i-mobile w wersji 2.0.23.
- Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 20.5.0.
Tworzone i testowane z
- Pakiet SDK do reklam mobilnych Google w wersji 20.5.0.
- Pakiet SDK IMobile w wersji 2.0.23.
Wersja 2.0.22.2
- Dodaliśmy ujednolicone kody błędów i komunikaty o błędach adaptera.
- Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 20.1.0.
Tworzone i testowane z
- Pakiet SDK do reklam mobilnych Google w wersji 20.1.0.
- Pakiet SDK IMobile w wersji 2.0.22.
Wersja 2.0.22.1
- Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 20.0.0.
Tworzone i testowane z
- Pakiet SDK do reklam mobilnych Google w wersji 20.0.0.
- Pakiet SDK IMobile w wersji 2.0.22.
Wersja 2.0.22.0
- Zweryfikowano zgodność z pakietem SDK i-mobile w wersji 2.0.22.
- Zaktualizowano adapter, aby obsługiwał żądania wbudowanych banerów adaptacyjnych.
Stworzone i przetestowane przy użyciu
- Pakiet SDK do reklam mobilnych Google w wersji 19.1.0.
- Pakiet IMobile SDK w wersji 2.0.22.
Wersja 2.0.21.0
- Zweryfikowano zgodność z pakietem SDK i-mobile w wersji 2.0.21.
- Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 19.1.0.
- Dodaliśmy obsługę skalowania banerów adaptacyjnych.
Stworzone i przetestowane przy użyciu
- Pakiet SDK do reklam mobilnych Google w wersji 19.1.0.
- Pakiet SDK IMobile w wersji 2.0.21.
Wersja 2.0.20.2
- Dodaliśmy obsługę elastycznych rozmiarów banerów reklamowych.
- Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 18.3.0.
Stworzone i przetestowane przy użyciu
- Pakiet SDK do reklam mobilnych Google w wersji 18.3.0.
- Pakiet SDK IMobile w wersji 2.0.20.
Wersja 2.0.20.1
- Adapter zwraca teraz format obrazu
mediaContent
inny niż zero.
Tworzone i testowane z
- Pakiet SDK do reklam mobilnych Google w wersji 18.2.0.
- Pakiet SDK IMobile w wersji 2.0.20.
Wersja 2.0.20.0
- Pierwsza wersja!
- Dodaliśmy obsługę banerów, reklam pełnoekranowych i natywnych.