Z tego przewodnika dowiesz się, jak korzystać z pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklamy z i-mobile korzystające z Zapośredniczenie AdMob, 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 .
Etykiety w interfejsie panelu i-mobile są zapisane w języku japońskim. przyciski i opisy. Zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. Jednak w opisach i instrukcjach tego przewodnika etykiety i przyciski są przetł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
Najnowszy pakiet SDK do reklam mobilnych Google
Dokończ zapośredniczenie Przewodnik dla początkujących
Krok 1. Skonfiguruj konfiguracje w interfejsie użytkownika i-mobile
Zarejestruj się lub zaloguj na konto i-mobile.
Aby dodać aplikację do panelu i-mobile, kliknij kartę サイシ/アプチ管理 (Site/Application Management) i kliknij przycisk platformy aplikacji.
Wypełnij formularz i kliknij przycisk OPEN規登録 (Zarejestruj się).
Aby utworzyć nowe Spot reklamowy, wybierz swoją aplikację na karcie サイシ/アプチ管理 (Site/Application Management).
Przejdź do karty 広告ブブッシ管理 (Zarządzanie miejscem wyświetlania reklamy) i kliknij przycisk 規広告すッ (Nowe miejsce reklamy).
Następnie wypełnij formularz, podając 広告ブッブシキ (nazwa miejsca reklamy), 広告すッブサイズ (rozmiar reklamy) i inne szczegóły. Następnie kliknij przycisk OPEN規登録 (Zarejestruj się).
Twoje nowe miejsce wyświetlania reklamy jest gotowe. Aby wyświetlić szczegóły jego integracji, kliknij przycisk アプ zespołami엔定取得 (Pobierz ustawienia aplikacji).
Zwróć uwagę na パャキッシャーID (identyfikator wydawcy), 名デすアID (Media ID) i カッブシID (identyfikator Spotu). Będziesz ich potrzebować później podczas konfigurowania i-mobile na potrzeby zapośredniczenia w interfejsie AdMob .
Krok 2. Skonfiguruj źródła ofert reklamowych i-mobile w AdMob interfejsie
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:
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 AdMob. 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 wypełnia te parametry
Opisy pól w zaawansowanych reklamach 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 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 |
Adapter i-mobile wysyła te kody i powiązane z nimi wiadomości gdy nie można wczytać 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 AdMob interfejsie lub są one nieprawidłowe. |
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. |
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.
Zaprojektowane i przetestowane:
- 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.
Zaprojektowane i przetestowane:
- 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
. - Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 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.
Stworzone i przetestowane przy użyciu
- 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.
Stworzone i przetestowane przy użyciu
- 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 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 SDK IMobile 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 adaptacyjnych banerów reklamowych.
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.
- 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 format obrazu
mediaContent
inny niż zero.
Stworzone i przetestowane przy użyciu
- 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.