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

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

• Interfejs API Androida na poziomie 21 lub wyższym

• Najnowsza wersja pakietu SDK do reklam mobilnych Google

• Wykonaj zapośredniczenie Przewodnik dla początkujących

Krok 1. Skonfiguruj konfiguracje w interfejsie i-mobile

Zarejestruj się lub zaloguj na swoje konto i-mobile.

Dodaj swoją aplikację do pulpitu nawigacyjnego w i-mobile, klikając kartę サcontext/アプす管理 (Site/Application Management) oraz przycisk platformy Twojej aplikacji.

Wypełnij formularz i kliknij przycisk 新規登録 (Sign up).

Uwaga: i-mobile musi zatwierdzić Twoją rejestrację. Po zatwierdzeniu możesz utworzyć miejsce na reklamę.

Aby utworzyć nowy Spot reklamowy, wybierz swoją aplikację na karcie サイト/アプ設管理 (Site/Application Management).

Przejdź do karty 広告ット管理 (Ad Spot Management) i kliknij przycisk ⁑規広告イット (Nowy punkt reklamy).

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

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

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

Krok 2. Skonfiguruj zapotrzebowanie na reklamy mobilne w interfejsie AdMob

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.

Uwaga: optymalizację źródeł reklam musisz skonfigurować tylko raz dla każdej sieci.

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.

Uwaga: optymalizacja źródła reklam potrzebuje kilku dni na zebranie wystarczającej ilości danych do dokładnego obliczenia eCPM dla sieci zapośredniczenia. Tymczasem stan optymalizacji źródła reklam to PENDING, więc musisz ręcznie ustawić wartość eCPM w sieci. Gdy można już obliczyć eCPM, źródło reklam zacznie je automatycznie aktualizować w Twoim imieniu.

Krok 3. Zaimportuj pakiet SDK i-mobile Adapter i-mobile

Uwaga: brak integracji zgodnych wersji pakietu SDK i-mobile oraz pakietu SDK do reklam mobilnych Google może spowodować problemy z kompilacją.

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żyj 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ę i-mobile SDK, rozpakuj pakiet android-ad-sdk.aar w folderze sdk i dodaj go do swojego projektu.

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

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

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.

Ważne: przed opublikowaniem aplikacji wyłącz tryb testowy AdMob ii-mobile .

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 opisami pól zaawansowanych reklam natywnych 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

¹ 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 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 kodowaniu.
101	Aby wczytywać reklamy, i-mobile wymaga kontekstu Activity.
102	Parametry serwera i-mobile skonfigurowane w interfejsie użytkownika AdMob 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.

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

Został opracowany i przetestowany z:

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

Został opracowany i przetestowany z:

• 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

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

Zaprojektowane i przetestowane:

• Pakiet SDK do reklam mobilnych Google w wersji 21.0.0.
• Pakiet SDK IMobile 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.
• Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 20.1.0.

Stworzone i przetestowane przy użyciu

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

Został opracowany i przetestowany z użyciem

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

Wersja 2.0.22.0

• Weryfikowana zgodność z pakietem SDK i-mobile w wersji 2.0.22.
• Zaktualizowano adapter, aby obsługiwał żądania wbudowanych banerów adaptacyjnych.

Został opracowany i przetestowany z użyciem

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

Został opracowany i przetestowany z użyciem

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