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 AdMob,integracji kaskadowej. 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ą.

Etykiety, przyciski i opisy w interfejsie panelu i-mobile są zapisane w języku japońskim. Zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. W opisach i instrukcjach w tym przewodniku jednak etykiety i przyciski są tłumaczone z użyciem anglojęzycznych odpowiedników tych nazw w nawiasach.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia na urządzenia i-mobile:

Integracja
Ustalanie stawek
Wodospad
Formaty
Baner
Pełnoekranowa
Otrzymano
Natywna

Wymagania

Interfejs API Androida na poziomie 21 lub wyższym

Najnowszy pakiet SDK do reklam mobilnych Google
Wykonaj zapośredniczenie Przewodnik dla początkujących

Krok 1. Skonfiguruj konfiguracje 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).

create_ad_spot

Następnie wypełnij formularz, podając 広告ブッブシキ (nazwa miejsca reklamy), 広告すッブサイズ (rozmiar reklamy) i inne szczegóły. Następnie kliknij przycisk OPEN規登録 (Zarejestruj się).

new_ad_spot_form

Twoje nowe miejsce wyświetlania reklamy jest gotowe. Aby wyświetlić szczegóły jego integracji, kliknij przycisk アプ zespołami엔定取得 (Pobierz ustawienia aplikacji).

ad_spot_list

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

Krok 2. Skonfiguruj źródła ofert reklamowych i-mobile w AdMob interfejsie

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Musisz dodać i-mobile do konfiguracji zapośredniczenia jednostki reklamowej.

Najpierw zaloguj się na swoje konto AdMob. Następnie otwórz kartę Zapośredniczenie. Jeśli masz istniejącą grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, i przejdź od razu do sekcji Dodawanie i-mobile jako źródła reklam.

Aby utworzyć nową grupę zapośredniczenia, wybierz Utwórz grupę zapośredniczenia.

Podaj format reklamy i platformę, a następnie kliknij Dalej.

Nazwij grupę zapośredniczenia i wybierz lokalizacje, na które chcesz kierować reklamy. Następnie ustaw stan grupy zapośredniczenia na Włączona i kliknij Dodaj jednostki reklamowe.

Powiąż tę grupę zapośredniczenia z co najmniej jedną istniejącą jednostką reklamowąAdMob . Następnie kliknij Gotowe.

Na karcie jednostek reklamowych powinny się pojawić wybrane przez Ciebie jednostki reklamowe:

Dodaj i-mobile jako źródło reklam

Na karcie Kaskada w sekcji Źródła reklam kliknij Dodaj źródło reklamy. Następnie kliknij i-mobile.

Kliknij i-mobile i włącz przełącznik Optymalizuj. Wpisz Login name and API Passworduzyskane w poprzedniej sekcji, aby skonfigurować optymalizację źródła reklam dla:i-mobile. Następnie wpisz wartość eCPM dlai-mobile i kliknij Dalej.

Jeśli masz już mapowanie i-mobile, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.

Następnie wpisz dane Publisher ID, Media ID and Spot IDotrzymane w poprzedniej sekcji. Następnie kliknij Gotowe.

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 poniższe zależności i konfiguracje implementacji. Użyj najnowszych wersji pakietu SDK i-adaptera i-mobile:

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

Integracja ręczna

Pobierz najnowszą wersję i-mobile SDK, rozpakuj pakiet android-ad-sdk.aar w folderze sdk 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 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 AdMob. 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 opisy pól zaawansowanych reklam natywnych dla NativeAd.

Pole	Zasoby 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 powiązane z nimi komunikaty wysyłane przez adapter i-mobile, gdy nie uda się wczytać reklamy:

Kod błędu	Przyczyna
0-99	Pakiet SDK i-mobile zwrócił błąd. Więcej informacji znajdziesz w opisie kodu.
101	Aby wczytywać reklamy, i-mobile wymaga kontekstu `Activity`.
102	Brak parametrów serwera i-mobile skonfigurowanych w AdMob interfejsie lub są one nieprawidłowe.
103	Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego na i-mobile.
104	Wywołanie zwrotne udanego wczytywania reklam natywnych i-mobile zwróciło pustą listę reklam natywnych.
0-10	Pakiet SDK i-mobile zwrócił błąd. Więcej informacji znajdziesz w opisie kodu.
101	Brak parametrów serwera i-mobile skonfigurowanych w AdMob interfejsie lub są one nieprawidłowe.
102	Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego na i-mobile.
103	i-mobile nie wyświetliła reklamy.
104	Usługa i-mobile zwróciła pustą tablicę reklam natywnych.
105	Usługa i-mobile nie mogła pobrać zasobów reklamy natywnej.
106	Usługa i-mobile nie obsługuje żądania pobrania wielu reklam pełnoekranowych z tym samym identyfikatorem Spota.

i-mobile dziennik zmian adaptera zapośredniczenia Androida

Wersja 2.3.2.0

Zweryfikowano 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 SDK IMobile w wersji 2.3.2.

Wersja 2.3.1.2

Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 23.0.0.
Zweryfikowano zgodność z pakietem SDK i-mobile w wersji 2.3.1.

Zaprojektowane i przetestowane:

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

Zaprojektowane i przetestowane:

Pakiet SDK do reklam mobilnych Google w wersji 22.0.0.
Pakiet SDK IMobile w wersji 2.3.1.

Wersja 2.3.1.0

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

Zaprojektowane i przetestowane:

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 compileSdkVersion i targetSdkVersion do interfejsu API 31.
Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 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.