Ta strona została przetłumaczona przez Cloud Translation API.

Integracja i-mobile z zapośredniczeniem

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 obejmujących integracje kaskadowe. Znajdziesz w nim informacje o tym, jak dodać i-mobile do konfiguracji pośrednictwa w przypadku danej jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter i-mobile z aplikacją Android .

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 etykiety i przyciski są jednak przetłumaczone z odpowiednimi angielskimi odpowiednikami 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

Najnowszy pakiet 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 Spot reklamowy, wybierz swoją aplikację na karcie サイト/アプ設管理 (Site/Application Management).

Otwórz kartę 広告スポット管理 (Ad Spot Management) i kliknij przycisk 新規広告スポット (New Ad Spot).

create_ad_spot

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ę).

new_ad_spot_form

Twój nowy miejsce na reklamę jest gotowy. Aby wyświetlić szczegóły integracji, kliknij przycisk アプ定取得 (Pobierz ustawienia aplikacji).

ad_spot_list

Zwracaj uwagę na 조エッッィーID (identyfikator wydawcy), エデアID (identyfikator mediów) i \tットID (identyfikator spotu). Będą one potrzebne później podczas konfigurowania i-mobile pod kątem zapośredniczenia w interfejsie AdMob.

Krok 2. Skonfiguruj zapotrzebowanie na reklamy mobilne w interfejsie Ad Manager

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 folderze sdk i dodaj go do projektu.
Przejdź do elementów adaptera i-mobile w repozytorium Maven Google. Wybierz najnowszą wersję, pobierz plik .aar adaptera i-mobile i dodaj go do projektu.

Krok 4. Dodaj wymagany kod

Do integracji z i-mobile nie jest potrzebny żaden dodatkowy kod.

Krok 5. Przetestuj implementację

Włączanie reklam testowych

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, używając źródeł reklam i-mobile (wodospad).

Kroki opcjonalne:

Korzystanie z reklam natywnych

Renderowanie reklam

Adapter i-mobile wypełnia te w przypadku NativeAd.

Pole	Komponenty zawsze uwzględniane przez adapter i-mobile
Nagłówek
Obraz
Treść
Ikona aplikacji	¹
Wezwanie do działania
Ocena w gwiazdkach
Sklep
Cena

¹ 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 otrzyma reklamy z i-mobile, wydawcy mogą sprawdzić przyczynę błędu w odpowiedzi za pomocą polecenia 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 Ad Manager są nieprawidłowe lub ich brakuje.
103	Żądany rozmiar reklamy nie odpowiada obsługiwanemu przez i-mobile rozmiarowi banera.
104	Zwrot wywołania obsługiwanej przez i-mobile funkcji native ad load success zwrócił 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.
Weryfikowana 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 IMobile SDK 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 IMobile SDK w wersji 2.3.1.

Wersja 2.3.1.0

Weryfikowana 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.

Został opracowany i przetestowany z:

Pakiet SDK do reklam mobilnych Google w wersji 21.5.0.
Pakiet IMobile SDK 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 IMobile SDK w wersji 2.3.0.

Wersja 2.0.23.1

Zaktualizowano compileSdkVersion i targetSdkVersion do poziomu API 31.
Minimalna wymagana wersja pakietu SDK do reklam mobilnych Google została zaktualizowana do 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.