Integracja i-mobile z zapośredniczeniem

Wybierz platformę: Android iOS Unity Flutter Android (starsza wersja)

Z tego przewodnika dowiesz się, jak używać pakietu Google Mobile Ads SDK (Legacy) do wczytywania i wyświetlania reklam z i-mobile za pomocą zapośredniczenia, co obejmuje integracje kaskadowe. Dowiesz się z niego, jak dodać i-mobile do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter i-mobile z aplikacją na Androida.

Interfejs panelu i-mobile używa japońskiego tekstu w etykietach, przyciskach i opisach. Zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. W opisach i instrukcjach w tym przewodniku etykiety i przyciski są jednak tłumaczone, a w nawiasach podawane są ich angielskie odpowiedniki.

Obsługiwane integracje i formaty reklam

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

Integracja
Określanie stawek
Kaskada
Formaty
Baner
Pełnoekranowa
Z nagrodą
Natywna

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te kwestie:

• Android API na poziomie 24 lub wyższym.

• Najnowsza wersja Google Mobile Ads SDK (Legacy).

• Skonfiguruj zapośredniczenie.

Krok 1. Skonfiguruj ustawienia w interfejsie i-mobile

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

Dodaj aplikację do panelu i-mobile, klikając kartę サイト／アプリ管理 (Zarządzanie witryną/aplikacją) i przycisk platformy aplikacji.

Wypełnij formularz i kliknij przycisk 新規登録 (Zarejestruj się).

Uwaga: rejestracja musi zostać zatwierdzona przez i-mobile. Gdy Twoja prośba zostanie zatwierdzona, możesz utworzyć miejsce reklamowe.

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

Otwórz kartę 広告スポット管理 (Ad Spot Management) i kliknij przycisk 新規広告スポット (New Ad Spot).

Następnie wypełnij formularz, podając 広告スポット名 (nazwę miejsca wyświetlania reklamy), 広告スポットサイズ (rozmiar miejsca wyświetlania reklamy) i inne szczegóły. 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).

Zanotuj パブリッシャーID (identyfikator wydawcy), メディアID (identyfikator multimediów) i スポットID (Spot ID). Te parametry będą potrzebne później podczas konfigurowania i-mobile na potrzeby zapośredniczenia w interfejsie Ad Managera.

Zaktualizuj plik app-ads.txt

Plik Authorized Sellers for Apps app-ads.txt to projekt IAB Tech Lab, który ma zagwarantować, że Twoje zasoby reklamowe w aplikacjach będą sprzedawane tylko w tych kanałach, na które wyrażasz zgodę. Aby zapobiec znacznej utracie przychodów z reklam, musisz wdrożyć plik app-ads.txt. Jeśli jeszcze nie masz pliku app-ads.txt, utwórz go na potrzeby Ad Managera.

Aby wdrożyć app-ads.txt w i-mobile, zapoznaj się z najczęstszymi pytaniami.

Krok 2. Skonfiguruj oferty reklamowe i-mobile w interfejsie Ad Managera

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Zaloguj się na konto Ad Managera.

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

Wpisz unikalną nazwę grupy zysku, ustaw stan na aktywny, wybierz format reklamy i ustaw typ zasobów reklamowych na aplikację mobilną. W sekcji Kierowanie > Zasoby reklamowe wybierz jednostkę reklamową w sekcji Zasoby reklamowe i aplikację mobilną, do której chcesz dodać zapośredniczenie.

Następnie kliknij przycisk Dodaj partnera zysku.

Jeśli masz już partnera zysku dla i-mobile, możesz go wybrać. W przeciwnym razie kliknij Utwórz nowego partnera zysku.

Wybierz i-mobile jako sieć reklamową, wpisz unikalną nazwę i włącz zapośredniczenie.

Włącz Automatyczne zbieranie danych i wpisz Nazwę logowania oraz Hasło do interfejsu API.

Po wybraniu Partnera zysku wybierz Zapośredniczenie mobilne SDK jako Typ integracji, Android jako Platformę i Aktywny jako Stan. Wpisz identyfikator wydawcy, identyfikator multimediów i identyfikator miejsca uzyskane w poprzedniej sekcji. Następnie wpisz wartość Domyślny CPM.

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

Uwaga: automatyczne zbieranie danych wymaga kilku dni na zebranie danych, zanim będzie można dokładnie obliczyć wartość dynamicznego CPM dla sieci zapośredniczeń. Gdy będzie można obliczyć eCPM, zostanie on automatycznie zaktualizowany w Twoim imieniu.

Krok 3. Zaimportuj pakiet SDK i-mobile i adapter

Uwaga: brak integracji zgodnych wersji i-mobile i Google Mobile Ads SDK (Legacy) może prowadzić do problemów z kompilacją.

Integracja z Androidem 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")
    }
  }
}

W pliku Gradle na poziomie aplikacji dodaj te zależności implementacji:

Kotlin

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

Zakręcony

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.google.ads.mediation:imobile:2.3.2.5'
}

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 Maven Google. Wybierz najnowszą wersję, pobierz plik .aar adaptera i-mobile i dodaj go do projektu.

Krok 4. Dodaj wymagany kod

Wczytywanie reklamy z kontekstem aktywności

Przekazywanie kontekstu Activity podczas wczytywania formatów reklam banerowych, pełnoekranowych, z nagrodą i natywnych.Bez kontekstu aktywności wczytywanie reklamy się nie powiedzie.

Krok 5. Przetestuj implementację

Włączanie reklam testowych

Upewnij się, że urządzenie testowe jest zarejestrowane w usłudze Ad Manager. i-mobile udostępnia testowe wartości Spot ID, Media ID i Publisher ID, które znajdziesz tutaj.

Ważne: przed opublikowaniem aplikacji wyłącz tryb testowy w Ad Managerze i i-mobile.

Weryfikowanie reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z i-mobile, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając ze źródeł reklam i-mobile (kaskada).

Kroki opcjonalne:

Korzystanie z reklam natywnych

Renderowanie reklam

Adapter i-mobile wypełnia te pola w przypadku NativeAd.

Pole	Komponenty 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ć podstawowy błąd w odpowiedzi na reklamę, korzystając z ResponseInfo.getAdapterResponses() w tych klasach:

Format	Nazwa klasy
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, które adapter i-mobile wyświetla, 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 wczytywać reklamy.
102	Parametry serwera i-mobile skonfigurowane w interfejsie Ad Managera są nieprawidłowe lub ich brakuje.
103	Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez i-mobile.
104	Wywołanie zwrotne wczytywania reklam natywnych i-mobile zwróciło pustą listę reklam natywnych.
105	Żądanie było objęte przetwarzaniem z ograniczeniami wiekowymi, ale pakiet SDK i-mobile nie może odbierać sygnałów związanych z ograniczeniami wiekowymi

Historia zmian adaptera zapośredniczenia i-mobile na Androida

Wersja 2.3.2.5

• Przypnij zależność adaptera od Kotlina do wersji 1.9.0 (minimalnej wersji Kotlina obsługiwanej przez pakiet GMA NextGen SDK).
• Naprawiliśmy błąd, który powodował, że podczas inicjowania reklam i wczytywania reklam nie były wyświetlane reklamy zastępcze w przypadku niepowodzenia związanego z ograniczeniem wiekowym.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 25.4.0.
• Pakiet SDK do wyświetlania reklam mobilnych Google nowej generacji w wersji 1.4.0.
• IMobile SDK w wersji 2.3.2.

Wersja 2.3.2.4

• Filtruj żądania z ograniczeniem wiekowym w przypadku pakietu SDK i-mobile, gdy parametr AgeRestrictedTreatment ma wartość CHILD.

Zaprojektowano i przetestowano z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 25.4.0.
• Pakiet SDK do wyświetlania reklam mobilnych Google nowej generacji w wersji 1.2.0.
• Pakiet IMobile SDK w wersji 2.3.2.

Wersja 2.3.2.3

• Filtruj żądania objęte ograniczeniami wiekowymi w przypadku pakietu SDK i-mobile, ponieważ nie może on odbierać sygnałów objętych ograniczeniami wiekowymi.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 25.1.0.
• Pakiet SDK do wyświetlania reklam mobilnych Google nowej generacji w wersji 1.1.0.
• Pakiet IMobile SDK w wersji 2.3.2.

Wersja 2.3.2.2

• Dodano właściwość umożliwiającą utworzenie adaptera z zależnością od pakietu SDK nowej generacji do reklam mobilnych Google.
• Przeniesiono implementacje banerów, reklam pełnoekranowych i reklam natywnych ze starego interfejsu API do nowego.

Zaprojektowano i przetestowano z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 25.1.0.
• Pakiet IMobile SDK w wersji 2.3.2.

Wersja 2.3.2.1

• Zaktualizowaliśmy minimalny wymagany poziom interfejsu Android API do 23.
• Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do 24.0.0.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 24.0.0.
• Pakiet IMobile SDK w wersji 2.3.2.

Wersja 2.3.2.0

• Zweryfikowano zgodność z pakietem i-mobile SDK w wersji 2.3.2.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 23.1.0.
• Pakiet IMobile SDK w wersji 2.3.2.

Wersja 2.3.1.2

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

Zaprojektowano i przetestowano z użyciem:

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

Wersja 2.3.1.1

• Zaktualizowano adapter, aby używał nowej klasy VersionInfo.
• Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do 22.0.0.

Zbudowano i przetestowano 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

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

Zaprojektowano i przetestowano z użyciem:

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

Wersja 2.3.0.0

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

Zbudowano i przetestowano 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 interfejsu API na poziomie 31.
• Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 21.0.0.
• Zaktualizowaliśmy minimalny wymagany poziom interfejsu API Androida do 19.

Zaprojektowano i przetestowano z użyciem:

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

Wersja 2.0.23.0

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

Zaprojektowano i przetestowano przy użyciu

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

Wersja 2.0.22.2

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

Zbudowano i przetestowano z

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

Wersja 2.0.22.1

• Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 20.0.0.

Zbudowano i przetestowano z

• Pakiet SDK do reklam mobilnych Google w wersji 20.0.0.
• Pakiet IMobile SDK 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 śródtekstowych banerów adaptacyjnych.

Zbudowano i przetestowano z

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

Wersja 2.0.21.0

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

Zaprojektowano i przetestowano przy użyciu

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

Wersja 2.0.20.2

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

Zaprojektowano i przetestowano 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 niezerowy format obrazu mediaContent.

Zbudowano i przetestowano z

• 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, reklam pełnoekranowych i reklam natywnych.