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

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

  • Poziom interfejsu API 21 lub nowszy

Krok 1. Skonfiguruj ustawienia w interfejsie i-mobile

Zarejestruj się lub zaloguj na konto i-mobile.

Dodaj aplikację do panelu i-mobile, klikając kartę サイト／アプリ管理 (Zarządzanie witryną/aplikacją) i przycisk platformy aplikacji.

Android

iOS

Wypełnij formularz i kliknij przycisk ⁑規登録 (Zarejestruj się).

Android

iOS

Aby utworzyć nowe miejsce reklamowe, wybierz swoją aplikację na karcie サイト／アプリ管理 (Strona/Zarządzanie aplikacją).

Android

iOS

Przejdź do karty 広告イット管理 (Ad Spot Management) i kliknij Przycisk 多溴規広告設ッstępne (Nowy punkt wyświetlania reklamy).

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

Zwróć uwagę na 토ッwizardaudーID (identyfikator wydawcy), 제ディアID (Media ID). i 本ットID (Spot ID). Te parametry będą potrzebne później przy konfigurowaniu i-mobile na potrzeby zapośredniczenia w interfejsie AdMob.

Android

iOS

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

Krok 3. Zaimportuj pakiet SDK i-mobile 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żyj najnowszych wersji Pakiet SDK i-mobile i adapter:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.4.0")
    implementation("com.google.ads.mediation:imobile:2.3.2.0")
}

Integracja ręczna

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

  2. Przejdź do artefaktów 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

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 spełnia te wymagania pola dla NativeAd

Pole Komponenty 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 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

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 kodeksie.
101 Aby wczytywać reklamy, i-mobile wymaga kontekstu Activity.
102 Brak parametrów serwera i-mobile skonfigurowanych w Ad Manager interfejsie lub są one nieprawidłowe.
103 Żądany rozmiar reklamy nie odpowiada obsługiwanemu przez i-mobile rozmiarowi banera.
104 Zwrot wywołania zwrotnego success wywołania ładowania reklam natywnych i-mobile zwrócił pustą listę reklam natywnych.

Historia zmian adaptera zapośredniczenia na Androida i-mobile

Wersja 2.3.2.0

  • Zweryfikowano 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 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.
  • Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 22.0.0.

Został opracowany i przetestowany z:

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

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.

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 interfejsu 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 IMobile SDK w wersji 2.0.23.

Wersja 2.0.23.0

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

  • Dodano standardowe kody błędów i komunikaty dotyczące adaptera.
  • Minimalna wymagana wersja pakietu SDK do reklam mobilnych Google to 20.1.0.

Tworzone i testowane z

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

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

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 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 format obrazu mediaContent inny niż 0.

Tworzone i testowane z

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