Z tego przewodnika dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z i-mobile przy użyciu mediacji, która obejmuje integrację kaskadową. Znajdziesz w nim informacje o tym, jak dodać i-mobile do konfiguracji pośrednictwa jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter i-mobile z aplikacją Unity.
Interfejs panelu w i-mobile zawiera etykiety, przyciski i opisy 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 odpowiednimi angielskimi odpowiednikami w nawiasach.
Obsługiwane integracje i formaty reklam
AdMob Adapter zapośredniczenia dla i-mobile ma te funkcje:
Integracja | |
---|---|
Określanie stawek | |
Wodospad | |
Formaty | |
Baner | |
Pełnoekranowa | |
Z nagrodą |
Wymagania
- Unity w wersji 5.6 lub nowszej
- Najnowsza wersja pakietu SDK do reklam mobilnych Google
- Aby wdrożyć na Androidzie:
- poziom interfejsu API 21 lub nowszy,
- Aby wdrożyć aplikację na iOS:
- docelowa wersja iOS 12.0 lub nowsza
- działający projekt Unity skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w artykule Pierwsze kroki.
- Przejdź przez proces zapośredniczenia, korzystając z przewodnika dla początkujących.
Krok 1. Skonfiguruj ustawienia w interfejsie i-mobile
Zarejestruj się lub zaloguj na swoje konto i-mobile.
Dodaj aplikację do panelu i-mobile, klikając kartę サイト/アプリ管理 (Zarządzanie witryną/aplikacją) i przycisk platformy aplikacji.
Android
iOS
Wypełnij formularz i kliknij przycisk 新規登録 (Sign up).
Android
iOS
Aby utworzyć nowy punkt reklamowy, wybierz swoją aplikację na karcie サイト/アプリ管理 (Zarządzanie witryną/aplikacją).
Android
iOS
Otwórz kartę 広告スポット管理 (Ad Spot Management) i kliknij przycisk 新規広告スポット (New Ad Spot).
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 アプリ設定取得 (Uzyskaj ustawienia aplikacji).
Zanotuj パブリッシャーID (identyfikator wydawcy), メディアID (identyfikator multimediów) i スポットID (identyfikator miejsca). Parametry te będą Ci potrzebne później, gdy skonfigurujesz i-mobile do mediowania w interfejsie AdMob.
Android
iOS
Krok 2. Skonfiguruj zapotrzebowanie na reklamy mobilne w interfejsie AdMob
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Android
Instrukcje znajdziesz w kroku 2 w przewodniku dotyczącym Android.
iOS
Instrukcje znajdziesz w kroku 2 w przewodniku dotyczącym iOS.
Krok 3. Zaimportuj pakiet SDK i adapter i-mobile
OpenUPM-CLI
Jeśli masz zainstalowany interfejs wiersza poleceń OpenUPM-CLI, możesz zainstalować w projekcie wtyczkę Google Mobile Ads i i-mobile Mediation dla Unity, uruchamiając to polecenie w katalogu głównym projektu:
openupm add com.google.ads.mobile.mediation.imobile
OpenUPM
W edytorze projektu Unity wybierz Edytuj > Ustawienia projektu > Menedżer pakietów, aby otworzyć ustawienia menedżera pakietów Unity.
Na karcie Scoped Registries (Rejestry ograniczone) dodaj OpenUPM jako rejestr ograniczony z tymi informacjami:
- Nazwa:
OpenUPM
- Adres URL:
https://package.openupm.com
- Zakres:
com.google
Następnie kliknij Okno > Menedżer pakietów, aby otworzyć Menedżera pakietów Unity, a potem w menu kliknij Moje rejestry.
Wybierz pakiet Google Mobile Ads i-mobile Mediation i kliknij Zainstaluj.
Pakiet Unity
Pobierz najnowszą wersję wtyczki Google Mobile Ads do pośredniczenia w przypadku i-mobile, korzystając z linku do pobrania w Changelog, a potem wyodrębnij plik GoogleMobileAdsIMobileMediation.unitypackage
z pliku ZIP.
W edytorze projektu Unity wybierz Zasoby > Importuj pakiet > Pakiet niestandardowy i znajdź pobrany plik GoogleMobileAdsIMobileMediation.unitypackage
. Upewnij się, że wszystkie pliki są zaznaczone, i kliknij Importuj.
Następnie kliknij Zasoby > Menedżer zewnętrznych zależności > Rozwiązywacz Androida > Wymuś rozwiązanie. Biblioteka menedżera zależności zewnętrznej wykona rozwiązanie zależności od podstaw i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android
Twojej aplikacji Unity.
Krok 4. Wymagany jest dodatkowy kod
Android
Integracja z i-mobile nie wymaga dodatkowego kodu.
iOS
Integracja z SKAdNetwork
Aby dodać identyfikatory SKAdNetwork do pliku Info.plist
projektu, postępuj zgodnie z dokumentacją i-mobile.
Krok 5. Przetestuj implementację
Włączanie reklam testowych
Pamiętaj, aby zarejestrować urządzenie testowe w AdMob. i-mobile udostępnia testowe identyfikatory Spotu, Media i Publisher. Znajdziesz je tutaj.
Weryfikowanie reklam testowych
Aby sprawdzić, czy otrzymujesz reklamy testowe z i-mobile, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, korzystając z źródeł reklam i-mobile (kaskada).
Kody błędów
Jeśli adapter nie otrzyma reklamy od i-mobile, wydawcy mogą sprawdzić błąd podstawowy w odpowiedzi reklamy, korzystając z elementu ResponseInfo
w ramach tych klas:
Android
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 |
iOS
Format | Nazwa zajęć |
---|---|
Baner | IMobileAdapter |
Pełnoekranowa | IMobileAdapter |
Natywna | GADMediationAdapterIMobile |
Oto kody i dołączone komunikaty z adaptera i-mobile, gdy nie udaje się załadować reklamy:
Android
Kod błędu | Przyczyna |
---|---|
0-99 | Pakiet SDK i-mobile zwrócił błąd. Więcej informacji znajdziesz w kodowaniu. |
101 | Aby załadować 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 | Funkcja wywołania zwrotnego po pomyślnym wczytaniu reklam natywnych w i-mobile zwróciła pustą listę reklam natywnych. |
iOS
Kod błędu | Przyczyna |
---|---|
0-10 | Pakiet SDK i-mobile zwrócił błąd. Więcej informacji znajdziesz w kodowaniu. |
101 | Parametry serwera i-mobile skonfigurowane w interfejsie użytkownika AdMob są nieprawidłowe lub ich brakuje. |
102 | Żądany rozmiar reklamy nie odpowiada obsługiwanemu przez i-mobile rozmiarowi banera. |
103 | i-mobile nie udało się wyświetlić reklamy. |
104 | i-mobile zwrócił pusty tablica reklam natywnych. |
105 | Nie udało się pobrać komponentów reklam natywnych z i-mobile. |
106 | i-mobile nie obsługuje żądań dotyczących wielu reklam przejściowych z użyciem tego samego identyfikatora miejsca docelowego. |
Historia zmian wtyczki i-mobile Unity Mediation
Wersja 1.3.6
- Obsługuje adapter i-mobile na Androida w wersji 2.3.2.0.
- Obsługuje adapter i-mobile na iOS w wersji 2.3.4.1.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.3.0.
Wersja 1.3.5
- Obsługuje adapter i-mobile na Androida w wersji 2.3.2.0.
- Obsługuje adapter i-mobile na iOS w wersji 2.3.4.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.1.0.
Wersja 1.3.4
- Obsługuje adapter i-mobile na Androida w wersji 2.3.1.2.
- Obsługuje adapter i-mobile na iOS w wersji 2.3.4.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.0.0.
Wersja 1.3.3
- Obsługuje adapter i-mobile na Androida w wersji 2.3.1.1.
- Obsługuje adapter i-mobile na iOS w wersji 2.3.3.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.0.0.
Wersja 1.3.2
- Treść adaptera została przeniesiona do
GoogleMobileAds/Mediation/IMobile/
. - Obsługuje adapter i-mobile na Androida w wersji 2.3.1.1.
- Obsługuje adapter i-mobile na iOS w wersji 2.3.2.0.
- Została ona utworzona i przetestowana z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 8.1.0.
Wersja 1.3.1
- Obsługuje adapter i-mobile na Androida w wersji 2.3.0.0.
- Obsługuje adapter i-mobile na iOS w wersji 2.3.0.1.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 7.4.1.
Wersja 1.3.0
- Obsługuje adapter i-mobile na Androida w wersji 2.3.0.0.
- Obsługuje adapter i-mobile na iOS w wersji 2.3.0.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 7.3.1.
Wersja 1.2.2
- Obsługuje adapter i-mobile na Androida w wersji 2.0.23.1.
- Obsługuje adapter i-mobile na iOS w wersji 2.2.0.1.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 7.0.2.
Wersja 1.2.1
- Obsługuje adapter i-mobile na Androida w wersji 2.0.23.0.
- Obsługuje adapter i-mobile na iOS w wersji 2.2.0.1.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 7.0.0.
Wersja 1.2.0
- Obsługuje adapter i-mobile na Androida w wersji 2.0.23.0.
- Obsługuje adapter i-mobile na iOS w wersji 2.2.0.0.
Wersja 1.1.0
- Obsługuje adapter i-mobile na Androida w wersji 2.0.22.
- Obsługuje adapter i-mobile na iOS w wersji 2.1.0.1.
Wersja 1.0.2
- Obsługuje adapter i-mobile na Androida w wersji 2.0.22.0.
- Obsługuje adapter i-mobile na iOS w wersji 2.0.32.0.
Wersja 1.0.1
- Obsługuje adapter i-mobile na Androida w wersji 2.0.21.0.
- Obsługuje adapter i-mobile na iOS w wersji 2.0.31.0.
Wersja 1.0.0
- Pierwsza wersja
- Obsługuje adapter i-mobile na Androida w wersji 2.0.20.1.
- Obsługuje adapter i-mobile na iOS w wersji 2.0.29.0.