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 (obejmuje to integracje kaskadowe). 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 .

Interfejs panelu na i-mobile używa etykiet, przycisków i opisów w języku japońskim. Zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. W opisach i instrukcjach etykiety i przyciski są jednak tłumaczone z ich odpowiednikami w języku angielskim 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

• Android API na poziomie 19 lub wyższym

• Najnowszy pakiet SDK do reklam mobilnych Google

• Wykonaj czynności dotyczące zapośredniczenia Przewodnik dla początkujących

Krok 1. Skonfiguruj i-mobile

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

Aby dodać aplikację do panelu i-mobile, kliknij kartę サイト/アプリ管理 (Site/Application Management), a następnie kliknij przycisk 조規Androidアプリ (Nowa aplikacja na Androida) ..

Zarejestruj aplikację, podając jej Nazwę i マーケッ pomocURL (URL rynku). Następnie po wypełnieniu pozostałego formularza kliknij przycisk 조規登録 (Zarejestruj się).

Uwaga: rejestracja w systemie i-mobile musi zostać zatwierdzona. Po ich zatwierdzeniu możesz utworzyć Spot reklamowy.

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

Otwórz kartę 広告用ット管理 (Zarządzanie miejscem wyświetlania reklamy) i kliknij przycisk Celebrate規広告チャット (New Ad Spot).

Następnie wypełnij formularz, podając 広告チット (nazwa miejsca reklamy), 広告用ットサイズ (rozmiar reklamy) i innych danych. Następnie kliknij przycisk 조規登録 (Zarejestruj się).

Twoje nowe Miejsce wyświetlania reklamy jest gotowe. Aby wyświetlić szczegóły integracji, kliknij przycisk アプリ設定取得 (Pobierz ustawienia aplikacji).

Zapisz te wartości: パブイッシャーID (identyfikator wydawcy), 토デチアID (identyfikator mediów) i automated ットID (identyfikator Spotu). Będziesz ich potrzebować później przy konfigurowaniu zapośredniczenia AdMob w interfejsie.

Krok 2. Skonfiguruj ustawienia zapośredniczenia AdMob w jednostce reklamowej

Musisz teraz dodać i-mobile do konfiguracji zapośredniczenia jednostki reklamowej. Aby to zrobić, najpierw zaloguj się na konto AdMob.

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

Aby utworzyć nową grupę zapośredniczenia, kliknij 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. Następnie kliknij Dodaj jednostki reklamowe.

Powiąż tę grupę zapośredniczenia z dotychczasowymi jednostkami reklamowymi AdMob. Następnie kliknij Gotowe.

Na karcie jednostek reklamowych powinny się pojawić wybrane jednostki reklamowe.

Dodawanie i-mobile jako źródła reklam

Na karcie Źródła reklam kliknij Dodaj sieć reklamową.

Wybierz i-mobile i włącz funkcję Optymalizuj. Wpisz nazwę logowania i hasło interfejsu API konta i-mobile, aby skonfigurować optymalizację źródeł reklam pod kątem i-mobile. Następnie wpisz wartość eCPM w przypadku i-mobile i kliknij Dalej.

Ważne: skontaktuj się z opiekunem klienta lub zespołem pomocy i-mobile, aby uzyskać hasło do interfejsu API.

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

Następnie wpisz nazwę mapowania, swój identyfikator wydawcy, identyfikator mediów i identyfikator Spotu uzyskane w poprzedniej sekcji. Następnie kliknij Gotowe.

Ważne: optymalizacja źródła reklam potrzebuje kilku dni na zebranie danych potrzebnych do dokładnego obliczenia eCPM w przypadku sieci zapośredniczeń. Tymczasem stan optymalizacji źródła reklam będzie wynosić PENDING, dlatego musisz ręcznie ustawić wartość eCPM dla tej sieci. Po obliczeniu eCPM funkcja optymalizacji źródła reklam zacznie automatycznie aktualizować eCPM w Twoim imieniu.

Krok 3. Zaimportuj pakiet SDK i adapter i-mobile

Integracja z Android Studio (zalecana)

W najnowszych wersjach pakietu SDK i adaptera i adaptera dodaj te zależności implementacji w pliku build.gradle na poziomie aplikacji:

repositories {
    google()
    mavenCentral()
    maven {
      url  "https://imobile.github.io/adnw-sdk-android"
    }
}

...
dependencies {
    implementation 'com.google.android.gms:play-services-ads:22.4.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 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. Wymagany dodatkowy kod

Integracja i-mobile nie wymaga żadnego dodatkowego kodu.

Krok 5. Przetestuj implementację

Aby przetestować integrację, i-mobile udostępnia testowe identyfikatory reklamy, identyfikator mediów i identyfikator wydawcy dla wszystkich formatów reklam. Znajdziesz je tutaj.

Kroki opcjonalne:

Korzystanie z reklam natywnych

Renderowanie reklam

Adapter i-mobile wypełnia te opisy pól zaawansowanych reklam natywnych 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 zapewnia 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 metody ResponseInfo.getAdapterResponse(), korzystając z 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 komunikaty, które wysyła 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 kodzie.
101	i-mobile wymaga kontekstu Activity, aby 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	Udane wywołanie zwrotne wczytywania 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 zaprezentował reklamy.
104	i-mobile zwrócił pustą tablicę reklam natywnych.
105	i-mobile nie udało się pobrać komponentów reklam natywnych.
106	System i-mobile nie obsługuje wysyłania żądań wielu reklam pełnoekranowych z tym samym identyfikatorem Spota.

Historia zmian adaptera i-mobile Android Mediation

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.

Stworzone i przetestowane:

• 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 i-mobile SDK w wersji 2.3.1.
• Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 21.5.0.

Stworzone i przetestowane:

• 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 i-mobile SDK w wersji 2.3.0.
• Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 21.3.0.

Stworzone i przetestowane:

• Pakiet SDK do reklam mobilnych Google w wersji 21.3.0.
• Pakiet SDK dla 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 Android API do 19.

Stworzone 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

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

Stworzone i przetestowane w

• 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 o błędach adaptera.
• Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 20.1.0.

Stworzone i przetestowane w

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

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

Wersja 2.0.22.0

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

Stworzone i przetestowane w

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

Wersja 2.0.21.0

• Zweryfikowana zgodność z pakietem i-mobile SDK 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 banerów adaptacyjnych.

Stworzone i przetestowane w

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

• 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 większy od zera.

Stworzone i przetestowane w

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

Wersja 2.0.20.0

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