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

Integracja i-mobile z zapośredniczeniem

Z tego przewodnika dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z i-mobile przy użyciu mediacji, która obejmuje integrację kaskadową. Przewodnik ten zawiera informacje o dodawaniu pakietu i-mobile do konfiguracji pośrednictwa jednostki reklamowej oraz o integrowaniu pakietu SDK i adaptera i-mobile z aplikacją na Androida.

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 tł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

Najnowsza wersja pakietu 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 punkt reklamowy, wybierz swoją aplikację na karcie サイト／アプリ管理 (Zarządzanie witryną/aplikacją).

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

Zanotuj パブリッシャーID (identyfikator wydawcy), メディアID (identyfikator multimediów) i スポットID (identyfikator miejsca). Te parametry będą Ci potrzebne później, gdy skonfigurujesz i-mobile do mediacji w interfejsie Ad Managera.

Krok 2. Skonfiguruj zapotrzebowanie i-mobile w interfejsie Ad Managera

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Zaloguj się na konto Ad Managera.

Kliknij Wyświetlanie > Grupy zysku, a potem kliknij przycisk Nowa grupa zysku.

Wpisz unikalną nazwę grupy zysku, ustaw stan na Aktywna, wybierz format reklamy i ustaw Typ zasobów reklamowych na Aplikacja mobilna. W sekcji Kierowanie > Zasoby reklamowe wybierz jednostkę reklamową w sekcji 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 dla i-mobile, możesz go wybrać. W przeciwnym razie wybierz Utwórz nowego partnera zysku.

Jako sieć reklamowa wybierz i-mobile, wpisz unikalną nazwę i włącz zapośredniczenie.

Włącz Automatyczne zbieranie danych i wpisz Nazwa logowania oraz Hasło API.

Po wybraniu partnera zysku wybierz Zapośredniczenie mobilne SDK jako Typ integracji, Android jako Platforma i Aktywny jako Stan. Wpisz identyfikator wydawcy, identyfikator mediów i identyfikator spotu uzyskane w poprzedniej sekcji. Następnie wpisz wartość Domyślny CPM.

Gdy skończysz, u dołu strony kliknij Zapisz.

Krok 3. Zaimportuj pakiet SDK i 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

Upewnij się, że urządzenie testowe jest zarejestrowane w Ad Managerze. 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, korzystając z źródeł reklam i-mobile (kaskada).

Kroki opcjonalne:

Korzystanie z reklam natywnych

Renderowanie reklam

Adapter i-mobile wypełnia te pola 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 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 Ad Managera są nieprawidłowe lub ich brakuje.
103	Żądany rozmiar reklamy nie odpowiada obsługiwanemu przez i-mobile rozmiarowi banera.
104	Funkcja wywołania zwrotnego po pomyślnym załadowaniu reklamy natywnej w i-mobile zwróciła 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 użyciem:

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 użyciem:

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.

Został opracowany i przetestowany z użyciem:

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

Został opracowany i przetestowany z użyciem:

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 użyciem:

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.
Zaktualizowaliśmy minimalny wymagany poziom interfejsu API Androida do 19.

Został opracowany i przetestowany z użyciem:

Pakiet SDK do reklam mobilnych Google w wersji 21.0.0.
Pakiet IMobile SDK w wersji 2.0.23.