Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z i-mobile przy użyciu zapośredniczenia (w tym do integracji kaskady). Opisano w nim, jak dodać i-mobile do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter i-mobile z aplikacją Android .
Etykiety, przyciski i opisy w interfejsie panelu i-mobile są 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 angielskimi odpowiednikami w nawiasach.
Obsługiwane integracje i formaty reklam
Adapter zapośredniczenia Ad Manager dla i-mobile ma te możliwości:
Integracja | |
---|---|
Ustalanie stawek | |
Wodospad | |
Formaty | |
Baner | |
Pełnoekranowa | |
Otrzymano | |
Natywna |
Wymagania
- Interfejs API Androida na poziomie 19 lub wyższym
Najnowszy pakiet SDK do reklam mobilnych Google
Skorzystaj z zapośredniczenia Wprowadzenie
Krok 1. Skonfiguruj ustawienia 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 Ad Manager .
Krok 2. Skonfiguruj oferty reklamowe i-mobile w Ad Manager interfejsie użytkownika
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Zaloguj się na konto Ad Managera.
Kliknij Wyświetlanie > Grupy zysku i kliknij przycisk Nowa grupa zysku.
Wpisz niepowtarzalną nazwę grupy zysku, ustaw Stan na Aktywna, wybierz Format reklamy, a jako Typ zasobów reklamowych wybierz Aplikacja mobilna. W sekcji Kierowanie > Zasoby reklamowe wybierz jednostkę reklamową w sekcjach Zasoby reklamowe i Aplikacja mobilna, do której chcesz dodać zapośredniczenie.
Następnie kliknij przycisk Dodaj partnera zysku.
Jeśli masz już partnera zysku w przypadku usługii-mobile, możesz go wybrać. W przeciwnym razie kliknij Utwórz nowego partnera zysku.
Jako Sieć reklamowa wybierz i-mobile, wpisz niepowtarzalną nazwę i włącz Zapośredniczenie.
Włącz Automatyczne zbieranie danych i wpiszLogin name and API Password
Po wybraniu Partnera zysku wybierz Zapośredniczenie mobilne SDK jako typ integracji, Android jako platformę i Aktywne jako stan. WpiszPublisher ID, Media ID and Spot ID uzyskane w poprzedniej sekcji. Następnie wpisz domyślną wartość CPM.
Gdy skończysz, u dołu strony kliknij Zapisz.
Krok 3. Zaimportuj pakiet SDK i adapter i-mobile
Integracja 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 podane niżej zależności i konfiguracje implementacji. Użyj najnowszych wersji pakietu SDK i-mobilnego
i-mobile:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.0.0")
implementation("com.google.ads.mediation:imobile:2.3.1.1")
}
Integracja ręczna
Pobierz najnowszą wersję pakietu SDK i-mobile, wyodrębnij plik
android-ad-sdk.aar
z folderusdk
i dodaj go do swojego projektu.Otwórz artefakty adaptera i-mobile w repozytorium Google Maven. Wybierz najnowszą wersję, pobierz plik
.aar
adaptera i-mobile i dodaj go do swojego projektu.
Krok 4. Dodaj wymagany kod
Integracja 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 wypełnia te
pola
dla
NativeAd
.
Pole | Zasoby zawsze uwzględnione 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 zawiera komponentu z ikoną 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ć przyczynę błędu w odpowiedzi na żądanie reklamy, korzystając z elementu
ResponseInfo.getAdapterResponse()
dostępnego 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 powiązane z nimi komunikaty wysyłane przez adapter i-mobile, gdy reklama się nie wczytuje:
Kod błędu | Przyczyna |
---|---|
0-99 | Pakiet SDK i-mobile zwrócił błąd. Więcej informacji znajdziesz w kodzie. |
101 | i-mobile wymaga kontekstu w elemencie Activity , by wczytać reklamy. |
102 | Brakuje parametrów serwera i-mobile skonfigurowanych w interfejsie Ad Manager lub są one nieprawidłowe. |
103 | Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez i-mobile. |
104 | Wywołanie zwrotne wczytania reklamy natywnej i-mobile zwróciło pustą listę reklam natywnych. |
0-10 | Pakiet SDK i-mobile zwrócił błąd. Więcej informacji znajdziesz w kodzie. |
101 | Brakuje parametrów serwera i-mobile skonfigurowanych w interfejsie Ad Manager lub są one nieprawidłowe. |
102 | Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez i-mobile. |
103 | i-mobile nie udało się wyświetlić reklamy. |
104 | Usługa i-mobile zwróciła pustą tablicę reklam natywnych. |
105 | i-mobile nie udało się pobrać komponentów reklamy natywnej. |
106 | System i-mobile nie obsługuje żądania wielu reklam pełnoekranowych z użyciem tego samego identyfikatora Spota. |
Historia zmian adaptera i-mobile Android Mediation
Następna wersja
- Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 22.4.0.
Wersja 2.3.1.1
- Zaktualizowano adapter, aby używać nowej klasy
VersionInfo
. - Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 22.0.0.
Stworzone i przetestowane w:
- Pakiet SDK do reklam mobilnych Google w wersji 22.0.0.
- Pakiet SDK dla IMobile w wersji 2.3.1.
Wersja 2.3.1.0
- Zweryfikowana zgodność z pakietem SDK i-mobile w wersji 2.3.1.
- Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 21.5.0.
Stworzone i przetestowane w:
- Pakiet SDK do reklam mobilnych Google w wersji 21.5.0.
- Pakiet SDK dla 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ą wersję pakietu SDK do reklam mobilnych Google do wersji 21.3.0.
Stworzone i przetestowane w:
- Pakiet SDK do reklam mobilnych Google w wersji 21.3.0.
- Pakiet SDK dla urządzeń mobilnych w wersji 2.3.0.
Wersja 2.0.23.1
- Zaktualizowano
compileSdkVersion
itargetSdkVersion
do interfejsu API 31. - Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 21.0.0.
- Zaktualizowano minimalny wymagany poziom interfejsu API Androida na 19.
Stworzone i przetestowane w:
- Pakiet SDK do reklam mobilnych Google w wersji 21.0.0.
- Pakiet SDK do IMobile w wersji 2.0.23.
Wersja 2.0.23.0
- Zweryfikowana zgodność z pakietem SDK i-mobile w wersji 2.0.23.
- Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 20.5.0.
Stworzone i przetestowane
- Pakiet SDK do reklam mobilnych Google w wersji 20.5.0.
- Pakiet SDK do IMobile w wersji 2.0.23.
Wersja 2.0.22.2
- Dodaliśmy standardowe kody błędów i komunikaty o błędach adaptera.
- Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 20.1.0.
Stworzone i przetestowane
- Pakiet SDK do reklam mobilnych Google w wersji 20.1.0.
- Pakiet SDK dla IMobile w wersji 2.0.22.
Wersja 2.0.22.1
- Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 20.0.0.
Stworzone i przetestowane
- Pakiet SDK do reklam mobilnych Google w wersji 20.0.0.
- Pakiet SDK dla IMobile w wersji 2.0.22.
Wersja 2.0.22.0
- Zweryfikowana zgodność z pakietem SDK i-mobile w wersji 2.0.22.
- Zaktualizowano adapter, aby obsługiwał żądania wbudowanych banerów adaptacyjnych.
Stworzone i przetestowane
- Pakiet SDK do reklam mobilnych Google w wersji 19.1.0.
- Pakiet SDK dla IMobile w wersji 2.0.22.
Wersja 2.0.21.0
- Zweryfikowana zgodność z pakietem SDK i-mobile w wersji 2.0.21.
- Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 19.1.0.
- Dodaliśmy obsługę skalowania banerów adaptacyjnych.
Stworzone i przetestowane
- Pakiet SDK do reklam mobilnych Google w wersji 19.1.0.
- Pakiet SDK dla IMobile w wersji 2.0.21.
Wersja 2.0.20.2
- Dodaliśmy obsługę elastycznych rozmiarów banerów reklamowych.
- Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 18.3.0.
Stworzone i przetestowane
- Pakiet SDK do reklam mobilnych Google w wersji 18.3.0.
- Pakiet SDK dla IMobile w wersji 2.0.20.
Wersja 2.0.20.1
- Adapter zwraca teraz niezerowy format obrazu
mediaContent
.
Stworzone i przetestowane
- Pakiet SDK do reklam mobilnych Google w wersji 18.2.0.
- Pakiet SDK dla IMobile w wersji 2.0.20.
Wersja 2.0.20.0
- Pierwsza wersja!
- Dodaliśmy obsługę banerów, reklam pełnoekranowych i reklam natywnych.