Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z platformy i-mobile przy użyciu zapośredniczenia AdMob, obejmujących integracje kaskadowe. Dowiesz się z niego, jak dodać i-mobile do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet i adapter i-mobile z aplikacją Android z aplikacją.
W interfejsie panelu sterowania i-mobile etykiety, przyciski i opisy są w języku japońskim. Zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. W opisach i instrukcjach w tym przewodniku jednak etykiety i przyciski są tłumaczone z użyciem anglojęzycznych odpowiedników tych nazw w nawiasach.
Obsługiwane integracje i formaty reklam
Adapter zapośredniczenia dla i-mobile ma te możliwości:
Integracja | |
---|---|
Określanie stawek | |
Wodospad | |
Formaty | |
Baner | |
Pełnoekranowa | |
Z nagrodą | |
Natywna |
Wymagania
- Poziom interfejsu API 21 lub nowszy
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 i-mobile
Zarejestruj się lub zaloguj na swoje konto i-mobile.
Dodaj aplikację do panelu i-mobile, klikając kartę サイト/アプリ管理 (Zarządzanie witryną/aplikacją) i przycisk platformy aplikacji.
Wypełnij formularz i kliknij przycisk 新規登録 (Sign up).
Aby utworzyć nowy punkt reklamowy, wybierz swoją aplikację na karcie サイト/アプリ管理 (Zarządzanie witryną/aplikacją).
Przejdź do karty 広告ット管理 (Ad Spot Management) i kliknij przycisk ⁑規広告イット (Nowy punkt reklamy).
Następnie wypełnij formularz, podając 広告スポット名 (nazwa miejsca na reklamę), 広告スポットサイズ (rozmiar miejsca na reklamę) i inne szczegóły. Następnie kliknij przycisk 新規登録 (Zarejestruj się).
Twój nowy miejsce na reklamę jest gotowy. Aby wyświetlić szczegóły integracji, kliknij przycisk アプリ設定取得 (Uzyskaj ustawienia aplikacji).
Zwracaj uwagę na 조エッッィーID (identyfikator wydawcy), エデアID (identyfikator mediów) i \tットID (identyfikator spotu). Te parametry będą Ci potrzebne później, gdy skonfigurujesz i-mobile do zapośredniczenia w interfejsie AdMob.
Krok 2. Skonfiguruj zapotrzebowanie na reklamy mobilne w interfejsie AdMob
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Musisz dodać i-mobile do konfiguracji zapośredniczenia jednostki reklamowej.
Najpierw zaloguj się na swoje konto AdMob. Następnie otwórz kartę Zapośredniczenie. Jeśli masz istniejącą grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, i przejdź od razu do sekcji Dodawanie i-mobile jako źródła reklam.
Aby utworzyć nową grupę zapośredniczenia, wybierz Utwórz grupę zapośredniczenia.
Podaj format reklamy i platformę, a następnie kliknij Dalej.
Nazwij grupę zapośredniczenia i wybierz lokalizacje, na które chcesz kierować reklamy. Następnie ustaw stan grupy zapośredniczenia na Włączona i kliknij Dodaj jednostki reklamowe.
Powiąż tę grupę zapośredniczenia z co najmniej jedną istniejącą jednostką reklamowąAdMob . Następnie kliknij Gotowe.
Na karcie jednostek reklamowych powinny się pojawić wybrane przez Ciebie jednostki reklamowe:
Dodaj i-mobile jako źródło reklam
Na karcie Kaskada w sekcji Źródła reklam kliknij Dodaj źródło reklamy. Następnie kliknij i-mobile.
Kliknij i-mobile i włącz przełącznik Optymalizuj. Wpisz Login name and API Passworduzyskane w poprzedniej sekcji, aby skonfigurować optymalizację źródła reklam dla:i-mobile. Następnie wpisz wartość eCPM dlai-mobile i kliknij Dalej.Jeśli masz już mapowanie i-mobile, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.
Następnie wpisz dane Publisher ID, Media ID and Spot IDotrzymane w poprzedniej sekcji. Następnie kliknij Gotowe.
Krok 3. Zaimportuj pakiet SDK i-mobile Adapter i-mobile
Integracja z Android Studio (zalecana)
W pliku settings.gradle.kts
na poziomie projektu dodaj te 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 zależności i konfiguracje implementacji. Używaj najnowszych wersji pakietu SDK i adaptera i-mobile:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.5.0")
implementation("com.google.ads.mediation:imobile:2.3.2.0")
}
Integracja ręczna
Pobierz najnowszą wersję pakietu SDK i-mobile, a potem wyodrębnij plik
android-ad-sdk.aar
w folderzesdk
i dodaj go do projektu.Otwórz artefakty adaptera i-mobile w repozytorium Google Maven. Wybierz najnowszą wersję, pobierz plik
.aar
adaptera i-mobile 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
Pamiętaj, aby zarejestrować urządzenie testowe w AdMob. i-mobile udostępnia testowe identyfikatory Spotu, Media i Publisher. Znajdziesz je tutaj.
Weryfikowanie reklam testowych
Aby sprawdzić, czy otrzymujesz reklamy testowe z i-mobile, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, korzystając ze źródła reklam i-mobile (kaskada).
Kroki opcjonalne:
Korzystanie z reklam natywnych
Renderowanie reklam
Adapter i-mobile wypełnia te
opisy pól zaawansowanych reklam natywnych
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 zasobu ikony aplikacji. Zamiast tego adapter i-mobile wypełnia ikonę aplikacji przezroczystym obrazem.
Kody błędów
Jeśli adapter nie otrzyma reklamy z i-mobile, wydawcy mogą sprawdzić błąd w odpowiedzi reklamy, korzystając z
ResponseInfo.getAdapterResponses()
w ramach tych klas:
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. Więcej informacji znajdziesz w kodowaniu. |
101 | Aby załadować reklamy, i-mobile wymaga kontekstu Activity . |
102 | Parametry serwera i-mobile skonfigurowane w interfejsie użytkownika AdMob są nieprawidłowe lub ich brakuje. |
103 | Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego na i-mobile. |
104 | Wywołanie zwrotne udanego wczytywania reklam natywnych i-mobile zwróciło pustą listę reklam natywnych. |
Historia zmian adaptera zapośredniczenia na Androida i-mobile
Wersja 2.3.2.0
- Weryfikowana 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
- Minimalna wymagana wersja pakietu SDK do reklam mobilnych Google została zaktualizowana do 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.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 22.0.0.
- Pakiet IMobile SDK w wersji 2.3.1.
Wersja 2.3.1.0
- Weryfikowana zgodność z pakietem SDK i-mobile w wersji 2.3.1.
- Minimalna wymagana wersja pakietu SDK do reklam mobilnych Google została zaktualizowana do 21.5.0.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 21.5.0.
- Pakiet SDK IMobile w wersji 2.3.1.
Wersja 2.3.0.0
- Zweryfikowana 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.
Został opracowany i przetestowany z:
- 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 poziomu API 31. - Minimalna wymagana wersja pakietu SDK do reklam mobilnych Google została zaktualizowana do 21.0.0.
- Zaktualizowaliśmy minimalny wymagany poziom interfejsu API Androida do 19.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 21.0.0.
- Pakiet SDK IMobile w wersji 2.0.23.
Wersja 2.0.23.0
- Weryfikowana zgodność z pakietem SDK i-mobile w wersji 2.0.23.
- Minimalna wymagana wersja pakietu SDK do reklam mobilnych Google została zaktualizowana do wersji 20.5.0.
Został opracowany i przetestowany z użyciem
- Pakiet SDK do reklam mobilnych Google w wersji 20.5.0.
- Pakiet SDK IMobile w wersji 2.0.23.
Wersja 2.0.22.2
- Dodano standardowe kody błędów i komunikaty dotyczące adaptera.
- Minimalna wymagana wersja pakietu SDK do reklam mobilnych Google to 20.1.0.
Został opracowany i przetestowany z użyciem
- 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.
Stworzone i przetestowane przy użyciu
- Pakiet SDK do reklam mobilnych Google w wersji 20.0.0.
- Pakiet IMobile SDK w wersji 2.0.22.
Wersja 2.0.22.0
- Weryfikowana zgodność z pakietem SDK i-mobile w wersji 2.0.22.
- Zaktualizowaliśmy adapter, aby obsługiwał żądania dotyczące wbudowanych banerów adaptacyjnych.
Został opracowany i przetestowany z użyciem
- Pakiet SDK do reklam mobilnych Google w wersji 19.1.0.
- Pakiet IMobile SDK w wersji 2.0.22.
Wersja 2.0.21.0
- Weryfikowana zgodność z pakietem SDK i-mobile w wersji 2.0.21.
- Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 19.1.0.
- Dodaliśmy obsługę skalowania banerów adaptacyjnych.
Został opracowany i przetestowany z użyciem
- Pakiet SDK do reklam mobilnych Google w wersji 19.1.0.
- Pakiet IMobile SDK w wersji 2.0.21.
Wersja 2.0.20.2
- Dodaliśmy obsługę elastycznych rozmiarów banerów reklamowych.
- Zaktualizowano 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 współczynnik proporcji
mediaContent
inny niż zero.
Został opracowany i przetestowany z użyciem
- Pakiet SDK do reklam mobilnych Google w wersji 18.2.0.
- Wersja pakietu SDK IMobile: 2.0.20.
Wersja 2.0.20.0
- Pierwsza wersja!
- Dodaliśmy obsługę banerów, reklam pełnoekranowych i reklam natywnych.