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 i-mobile przy użyciu zapośredniczenia (w tym do integracji kaskady). Opisano w nim, jak dodać i-mobile do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter i-mobile z aplikacją Android .

Etykiety, przyciski i opisy w interfejsie panelu i-mobile 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 angielskimi odpowiednikami w nawiasach.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia AdMob dla i-mobile ma te możliwości:

Integracja
Ustalanie stawek
Wodospad
Formaty
Baner
Pełnoekranowa
Otrzymano
Natywna

Wymagania

• Interfejs API Androida na poziomie 19 lub wyższym

• Najnowszy pakiet SDK do reklam mobilnych Google

• Skorzystaj z zapośredniczenia Wprowadzenie

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

Uwaga: rejestracja w usłudze i-mobile musi zostać zatwierdzona. Po jego zatwierdzeniu możesz utworzyć Spot reklamowy.

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

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

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

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 oferty reklamowe i-mobile w AdMob interfejsie użytkownika

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 adapter i-mobile

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

Integracja 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 podane niżej zależności i konfiguracje implementacji. Użyj najnowszych wersji pakietu SDK i-mobilnego i-mobile:

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

Integracja ręczna

1. Pobierz najnowszą wersję pakietu SDK i-mobile, wyodrębnij plik android-ad-sdk.aar z folderu 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 swojego projektu.

Krok 4. Dodaj wymagany kod

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

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 opisy pól zaawansowanych reklam natywnych dla NativeAd.

Pole	Zasoby zawsze uwzględnione 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 zawiera 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 na żądanie reklamy, korzystając z elementu ResponseInfo.getAdapterResponse() dostępnego 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 reklama się nie wczytuje:

Kod błędu	Przyczyna
0-99	Pakiet SDK i-mobile zwrócił błąd. Więcej informacji znajdziesz w kodzie.
101	i-mobile wymaga kontekstu w elemencie Activity, by wczytać reklamy.
102	Brakuje parametrów serwera i-mobile skonfigurowanych w interfejsie AdMob lub są one nieprawidłowe.
103	Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez i-mobile.
104	Wywołanie zwrotne wczytania reklamy natywnej i-mobile zwróciło pustą listę reklam natywnych.
0-10	Pakiet SDK i-mobile zwrócił błąd. Więcej informacji znajdziesz w kodzie.
101	Brakuje parametrów serwera i-mobile skonfigurowanych w interfejsie AdMob lub są one nieprawidłowe.
102	Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez i-mobile.
103	i-mobile nie udało się wyświetlić reklamy.
104	Usługa i-mobile zwróciła pustą tablicę reklam natywnych.
105	i-mobile nie udało się pobrać komponentów reklamy natywnej.
106	System i-mobile nie obsługuje żądania wielu reklam pełnoekranowych z użyciem tego samego identyfikatora Spota.

Historia zmian adaptera i-mobile Android Mediation

Następna wersja

• Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 22.4.0.

Wersja 2.3.1.1

• Zaktualizowano adapter, aby używać nowej klasy VersionInfo.
• Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 22.0.0.

Stworzone i przetestowane w:

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

Wersja 2.3.1.0

• Zweryfikowana zgodność z pakietem SDK i-mobile w wersji 2.3.1.
• Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 21.5.0.

Stworzone i przetestowane w:

• Pakiet SDK do reklam mobilnych Google w wersji 21.5.0.
• Pakiet SDK dla IMobile w wersji 2.3.1.

Wersja 2.3.0.0

• Zweryfikowana zgodność z pakietem SDK i-mobile w wersji 2.3.0.
• Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 21.3.0.

Stworzone i przetestowane w:

• Pakiet SDK do reklam mobilnych Google w wersji 21.3.0.
• Pakiet SDK dla urządzeń mobilnych w wersji 2.3.0.

Wersja 2.0.23.1

• Zaktualizowano compileSdkVersion i targetSdkVersion do interfejsu API 31.
• Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 21.0.0.
• Zaktualizowano minimalny wymagany poziom interfejsu API Androida na 19.

Stworzone i przetestowane w:

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

Wersja 2.0.23.0

• Zweryfikowana zgodność z pakietem SDK i-mobile w wersji 2.0.23.
• Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 20.5.0.

Stworzone i przetestowane

• Pakiet SDK do reklam mobilnych Google w wersji 20.5.0.
• Pakiet SDK do IMobile w wersji 2.0.23.

Wersja 2.0.22.2

• Dodaliśmy standardowe kody błędów i komunikaty o błędach adaptera.
• Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 20.1.0.

Stworzone i przetestowane

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

Wersja 2.0.22.1

• Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 20.0.0.

Stworzone i przetestowane

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

Wersja 2.0.22.0

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

Stworzone i przetestowane

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

Wersja 2.0.21.0

• Zweryfikowana zgodność z pakietem SDK i-mobile w wersji 2.0.21.
• Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 19.1.0.
• Dodaliśmy obsługę skalowania banerów adaptacyjnych.

Stworzone i przetestowane

• Pakiet SDK do reklam mobilnych Google w wersji 19.1.0.
• Pakiet SDK dla IMobile w wersji 2.0.21.

Wersja 2.0.20.2

• Dodaliśmy obsługę elastycznych rozmiarów banerów reklamowych.
• Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 18.3.0.

Stworzone i przetestowane

• Pakiet SDK do reklam mobilnych Google w wersji 18.3.0.
• Pakiet SDK dla IMobile w wersji 2.0.20.

Wersja 2.0.20.1

• Adapter zwraca teraz niezerowy format obrazu mediaContent.

Stworzone i przetestowane

• Pakiet SDK do reklam mobilnych Google w wersji 18.2.0.
• Pakiet SDK dla IMobile w wersji 2.0.20.

Wersja 2.0.20.0

• Pierwsza wersja!
• Dodaliśmy obsługę banerów, reklam pełnoekranowych i reklam natywnych.