Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z i-mobile za pomocą zapośredniczenia obejmującego integrację kaskadową. Dowiesz się z niego, jak dodać i-mobile do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i-mobile z aplikacją na Unity.
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 Ad Manager do aplikacji i-mobile:
Integracja | |
---|---|
Ustalanie stawek | |
Wodospad | |
Formaty | |
Baner | |
Pełnoekranowa | |
Otrzymano |
Wymagania
- Unity w wersji 5.6 lub nowszej
- Najnowszy pakiet SDK do reklam mobilnych Google
- Aby wdrożyć to na Androidzie:
- Interfejs API Androida na poziomie 21 lub wyższym
- Aby wdrożyć w iOS:
- Cel wdrożenia iOS w wersji 12.0 lub nowszej
- Działający projekt w Unity skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w artykule Pierwsze kroki.
- 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.
Android
iOS
Wypełnij formularz i kliknij przycisk OPEN規登録 (Zarejestruj się).
Android
iOS
Aby utworzyć nowe Spot reklamowy, wybierz swoją aplikację na karcie サイシ/アプチ管理 (Site/Application Management).
Android
iOS
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 Ad Manager .
Android
iOS
Krok 2. Skonfiguruj źródła ofert reklamowych i-mobile w Ad Manager interfejsie
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Android
Instrukcje znajdziesz w kroku 2 instrukcji na Android.
iOS
Instrukcje znajdziesz w kroku 2 przewodnika po iOS.
Krok 3. Zaimportuj pakiet SDK do i-mobile i adapter
Pobierz najnowszą wersję wtyczki zapośredniczenia do reklam mobilnych Google na i-mobile, korzystając z linku pobierania w dzienniku zmian, i wyodrębnij 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 wybierz Zasoby > Program do rozpoznawania usług Google Play > Program do rozpoznawania Androida > Wymuś rozwiązanie. Biblioteka programu do rozpoznawania nazw usług Unity Play od zera przeprowadzi analizę zależności i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android
aplikacji w Unity.
Krok 4. Wymagany dodatkowy kod
Android
Integracja z i-mobile nie wymaga dodatkowego kodu.
iOS
Integracja SKAdNetwork
Wykonaj dokumentację i-mobile, by dodać identyfikatory SKAdNetwork do pliku Info.plist
projektu.
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.
Kody błędów
Jeśli adapter nie otrzyma reklamy z i-mobile, wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi na reklamę, używając parametru ResponseInfo
w tych klasach:
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 powiązane z nimi komunikaty wysyłane przez adapter i-mobile, gdy nie uda się wczytać reklamy:
Android
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. |
iOS
Kod błędu | Przyczyna |
---|---|
0-10 | Pakiet SDK i-mobile zwrócił błąd. Więcej szczegółów znajdziesz w kodzie. |
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. |
Historia zmian wtyczki i-mobile Unity Mediation
Wersja 1.3.5
- Obsługuje adapter i-mobile Androida w wersji 2.3.2.0.
- Obsługuje adapter iOS do iOS w wersji 2.3.4.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.1.0.
Wersja 1.3.4
- Obsługuje adapter i-mobile Androida w wersji 2.3.1.2.
- Obsługuje adapter iOS do iOS w wersji 2.3.4.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.0.0.
Wersja 1.3.3
- Obsługuje adapter i-mobile Androida w wersji 2.3.1.1.
- Obsługuje adapter iOS do iOS w wersji 2.3.3.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.0.0.
Wersja 1.3.2
- Przeniesiono treść adaptera do:
GoogleMobileAds/Mediation/IMobile/
. - Obsługuje adapter i-mobile Androida w wersji 2.3.1.1.
- Obsługuje adapter iOS do iOS w wersji 2.3.2.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 8.1.0.
Wersja 1.3.1
- Obsługuje adapter i-mobile Androida w wersji 2.3.0.0.
- Obsługuje adapter iOS do iOS w wersji 2.3.0.1.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.4.1.
Wersja 1.3.0
- Obsługuje adapter i-mobile Androida w wersji 2.3.0.0.
- Obsługuje adapter iOS do iOS w wersji 2.3.0.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.3.1.
Wersja 1.2.2
- Obsługuje adapter Androida do i-mobile w wersji 2.0.23.1.
- Obsługuje adapter iOS do iOS w wersji 2.2.0.1.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.0.2.
Wersja 1.2.1
- Obsługuje adapter i-mobile Androida w wersji 2.0.23.0.
- Obsługuje adapter iOS do iOS w wersji 2.2.0.1.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.0.0.
Wersja 1.2.0
- Obsługuje adapter i-mobile Androida w wersji 2.0.23.0.
- Obsługuje adapter iOS do iOS w wersji 2.2.0.0.
Wersja 1.1.0
- Obsługuje adapter i-mobile Androida w wersji 2.0.22.2.
- Obsługuje adapter iOS do iOS w wersji 2.1.0.1.
Wersja 1.0.2
- Obsługuje adapter Androida do i-mobile w wersji 2.0.22.0.
- Obsługuje adapter iOS do iOS w wersji 2.0.32.0.
Wersja 1.0.1
- Obsługuje adapter Androida do i-mobile w wersji 2.0.21.0.
- Obsługuje adapter iOS do iOS w wersji 2.0.31.0.
Wersja 1.0.0
- Pierwsza wersja!
- Obsługuje adapter Androida do i-mobile w wersji 2.0.20.1.
- Obsługuje adapter iOS do iOS w wersji 2.0.29.0.