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 orazintegracji 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 Ad Manager .

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

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Zaloguj się na konto Ad Managera.

Kliknij Wyświetlanie > Grupy zysku i kliknij przycisk Nowa grupa zysku.

Wpisz niepowtarzalną nazwę grupy zysku, ustaw Stan na Aktywna, wybierz Format reklamy, a jako Typ zasobów reklamowych wybierz Aplikacja mobilna. W sekcji Kierowanie > Zasoby reklamowe wybierz jednostkę reklamową w sekcjach 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 w przypadku usługii-mobile, możesz go wybrać. W przeciwnym razie kliknij Utwórz nowego partnera zysku.

Jako Sieć reklamowa wybierz i-mobile, wpisz niepowtarzalną nazwę i włącz Zapośredniczenie.

Włącz Automatyczne zbieranie danych i wpiszLogin name and API Password

Po wybraniu Partnera zysku wybierz Zapośredniczenie mobilne SDK jako typ integracji, Android jako platformę i Aktywne jako stan. WpiszPublisher ID, Media ID and Spot ID uzyskane w poprzedniej sekcji. Następnie wpisz domyślną wartość CPM.

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

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 Ad Manager. 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 pola 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 Ad Manager 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 Ad Manager 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.