Integracja i-mobile z zapośredniczeniem

W tym przewodniku dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z i-mobile za pomocą zapośredniczenia, integracji kaskadowych. 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 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

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 アプリ設定取得 (Uzyskaj ustawienia aplikacji).

ad_spot_list

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 źródła ofert reklamowych i-mobile w Ad Manager interfejsie

Krok 3. Zaimportuj pakiet SDK i adapter i-mobile

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

  1. Pobierz najnowszą wersję pakietu SDK i-mobile, a potem wyodrębnij plik android-ad-sdk.aar w folderze sdk i dodaj go do projektu.

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

Kroki opcjonalne:

Korzystanie z reklam natywnych

Renderowanie reklam

Adapter i-mobile wypełnia te w przypadku 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 Ad Manager są nieprawidłowe lub ich brakuje.
103 Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego na i-mobile.
104 Zwrot wywołania obsługiwanej przez i-mobile funkcji native ad load success zwrócił pustą listę reklam natywnych.

i-mobile dziennik zmian adaptera zapośredniczenia Androida

Wersja 2.3.2.0

  • Weryfikowana 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 IMobile SDK 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.
  • 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 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 SDK IMobile w wersji 2.3.0.

Wersja 2.0.23.1

  • Zaktualizowano compileSdkVersiontargetSdkVersion 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 IMobile SDK 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

  • Dodaliśmy ujednolicone kody błędów i komunikaty o błędach 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.

Został opracowany i przetestowany z użyciem

  • Pakiet SDK do reklam mobilnych Google w wersji 20.0.0.
  • Pakiet IMobile SDK w wersji 2.0.22.

Wersja 2.0.22.0

  • Zweryfikowano 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.
  • Minimalna wymagana wersja pakietu SDK do reklam mobilnych Google została zaktualizowana do 18.3.0.

Został opracowany i przetestowany z użyciem

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