Z tego przewodnika dowiesz się, jak korzystać z pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania z Maio za pomocą zapośredniczenia, na temat integracji kaskadowych. Omawiamy, jak dodać maio do konfiguracji zapośredniczenia i integracji pakietu SDK i adaptera maio z Aplikacja Unity.
Interfejs panelu sterowania maio używa japońskich etykiet, przycisków i opisów, a zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. Jednak w opisach i instrukcjach tutaj etykiety i przyciski są które są wskazywane przez ich odpowiedniki w języku angielskim. „URL 토ーム”, np. to „schemat adresów URL”, i tak dalej.
Obsługiwane integracje i formaty reklam
Adapter zapośredniczenia do Maio ma te funkcje:
Integracja | |
---|---|
Określanie stawek | |
Wodospad | |
Formaty | |
Baner | |
Reklamy pełnoekranowe | |
Z nagrodą |
Wymagania
- Unity 4 lub nowsza
- Najnowszy pakiet 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. Zobacz Rozpocznij, aby dowiedzieć się więcej.
- Dokończ zapośredniczenie Przewodnik dla początkujących
Krok 1. Skonfiguruj konfiguracje w interfejsie maio
Najpierw zarejestruj się lub zaloguj się na konto maio. Kliknij Zarządzanie aplikacjami na lewym pasku bocznym i wybierz Nowa aplikacja.
Wybierz kartę odpowiadającą preferowanemu typowi reklamy.
Pełnoekranowa
Wpisz nazwę aplikacji, wybierz platformę i podaj adres URL aplikacji. Jako Typ reklamy wybierz Reklama pełnoekranowa z wideo, a potem kliknij Zaktualizuj.
Android
iOS
Z nagrodą
Wpisz nazwę aplikacji, wybierz platformę i podaj adres URL aplikacji. Jako Typ reklamy wybierz Nagrody wideo, a potem kliknij Aktualizuj.
Android
iOS
Na stronie Zarządzanie aplikacjami zanotuj identyfikator mediów. W następnym kroku musisz skonfigurować jednostkę reklamową AdMob.
Android
iOS
Na stronie Zarządzanie strefami zanotuj identyfikator strefy. Będzie ona też potrzebna do skonfigurowania jednostki reklamowej AdMob w następnym rozdziale.
Android
iOS
Krok 2. Skonfiguruj żądania reklam Maio w AdMob interfejsie użytkownika
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Android
Instrukcje znajdziesz w kroku 2 instrukcji na Androida.
iOS
Instrukcje znajdziesz w kroku 2 przewodnika po iOS.
Krok 3. Importuj pakiet SDK i adapter maio
OpenUPM-CLI
Jeśli masz zainstalowany OpenUPM-CLI, możesz zainstalować wtyczkę reklam mobilnych Google dla środowiska Unity w projekcie, wykonując to polecenie w katalogu głównym projektu:
openupm add com.google.ads.mobile.mediation.maio
OpenUPM
W edytorze projektu Unity wybierz Edytuj > Ustawienia projektu > Menedżer pakietów, aby otworzyć ustawienia menedżera pakietów Unity.
Na karcie Rejestry o zakresie dodaj OpenUPM jako rejestr z zakresem następujące szczegóły:
- 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 Zapośredniczenie reklam mobilnych Google i kliknij Zainstaluj.
Pakiet Unity
Pobierz najnowszą wersję wtyczki Google Mobile Ads do pośrednictwa reklamowego dla maia z linku do pobrania w Historii zmian i rozpakuj plik zip zawierający plik GoogleMobileAdsMaioMediation.unitypackage
.
W edytorze projektu Unity wybierz Zasoby > Importuj pakiet > Pakiet niestandardowy i znajdź pobrany plik GoogleMobileAdsMaioMediation.unitypackage
. Upewnij się, że wszystkie pliki są zaznaczone, i kliknij Importuj.
Następnie kliknij Zasoby > Menedżer zależności zewnętrznych > Rozwiązanie Androida > Wymuś rozwiązanie. Zewnętrzny menedżer zależności
biblioteka rozpozna zależności od zera i skopiuje
zadeklarowano zależności w katalogu Assets/Plugins/Android
Aplikacja Unity.
Krok 4. Dodaj wymagany kod
Android
Integracja maio nie wymaga dodatkowego kodu.
iOS
Integracja z SKAdNetwork
Aby dodać identyfikatory SKAdNetwork do pliku Info.plist
projektu, postępuj zgodnie z dokumentacją maia.
Krok 5. Przetestuj implementację
Włącz reklamy testowe
Zarejestruj urządzenie testowe na potrzeby AdMob.
Wydawcy, którzy korzystają z pakietu SDK do reklam mobilnych Google w wersji 7.26.0 lub nowszej, automatycznie będą otrzymywać w żądaniach reklamy testowe z Maio na telefony i tablety zarejestrowane jako urządzenia testowe.
Weryfikacja reklam testowych
Aby sprawdzić, czy otrzymujesz reklamy testowe z witrynymaio, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając z maio (Waterfall) źródeł reklam.
Kody błędów
Jeśli adapter nie odbierze reklamy z Maio, wydawcy mogą sprawdzić
bazowy błąd w odpowiedzi na żądanie reklamy za pomocą funkcji
ResponseInfo
w
następujące klasy:
Android
Format | Nazwa zajęć |
---|---|
Pełnoekranowa | jp.maio.sdk.android.mediation.admob.adapter.Interstitial |
Z nagrodą | jp.maio.sdk.android.mediation.admob.adapter.Rewarded |
iOS
Format | Nazwa zajęć |
---|---|
Pełnoekranowa | GADMMaioInterstitialAdapter |
Z nagrodą | GADMMaioRewardedAdapter |
Oto kody i odpowiednie komunikaty generowane przez adapter maio, gdy nie udaje się załadować reklamy:
Android
Kod błędu | Przyczyna |
---|---|
0-10 | Aplikacja maio zwróciła błąd pakietu SDK. Aby dowiedzieć się więcej, zapoznaj się z kodem i dokumentacją Maio. |
101 | Maio nie ma dostępnej reklamy. |
102 | Nieprawidłowe parametry serwera (np. brak identyfikatora miejsca docelowego). |
103 | Kontekst użyty do załadowania reklamy nie był wystąpieniem „Activity”. |
iOS
Kod błędu | Przyczyna |
---|---|
0-10 | Aplikacja maio zwróciła błąd pakietu SDK. Więcej informacji znajdziesz w kodach maio. |
101 | maio nie ma jeszcze dostępnej reklamy. |
102 | Nieprawidłowe parametry serwera (np. brak identyfikatora miejsca docelowego). |
103 | Adapter maio nie obsługuje żądanego formatu reklamy. |
104 | Reklama została już wczytana na potrzeby tej konfiguracji sieci. |
Historia zmian wtyczki maio Unity Mediation
Wersja 2.0.3
- Obsługuje adapter maio Androida w wersji 1.1.16.3.
- Obsługuje adapter systemu iOS maio w wersji 2.1.5.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.1.0.
Wersja 2.0.2
- Obsługuje adapter maio Androida w wersji 1.1.16.3.
- Obsługuje adapter maio na iOS w wersji 2.1.4.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.0.0.
Wersja 2.0.1
- Obsługuje adapter maio Androida w wersji 1.1.16.2.
- Obsługuje adapter maio na iOS w wersji 2.1.3.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.0.0.
Wersja 2.0.0
- Obsługuje adapter maio Androida w wersji 1.1.16.2.
- Obsługuje adapter maio na iOS w wersji 2.1.1.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 8.6.0.
Wersja 1.4.3
- Treści adaptera zostały przeniesione do
GoogleMobileAds/Mediation/Maio/
. - Obsługuje adapter maio Androida w wersji 1.1.16.2.
- Obsługuje adapter systemu iOS maio w wersji 1.6.3.1.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 8.1.0.
Wersja 1.4.2
- Obsługuje adapter Androida maio w wersji 1.1.16.1.
- Obsługuje adapter maio na iOS w wersji 1.6.3.0.
- Skompilowana i przetestowana z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 7.4.0.
Wersja 1.4.1
- Obsługuje adapter maio Androida w wersji 1.1.16.1.
- Obsługuje adapter systemu iOS maio w wersji 1.6.2.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 7.1.0.
Wersja 1.4.0
- Obsługuje adapter Androida firmy maio w wersji 1.1.16.0.
- Obsługuje adapter systemu iOS maio w wersji 1.6.0.1.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.0.0.
Wersja 1.3.6
- Obsługuje adapter Androida firmy maio w wersji 1.1.16.0.
- Obsługuje adapter systemu iOS maio w wersji 1.5.8.0.
Wersja 1.3.5
- Obsługuje adapter maio Androida w wersji 1.1.15.0.
- Obsługuje adapter maio na iOS w wersji 1.5.6.1.
Wersja 1.3.4
- Obsługuje adapter maio Androida w wersji 1.1.11.1.
- Obsługuje adapter maio na iOS w wersji 1.5.4.0.
Wersja 1.3.3
- Obsługuje adapter maio Androida w wersji 1.1.11.1.
- Obsługuje adapter maio na iOS w wersji 1.5.3.1.
Wersja 1.3.2
- Obsługuje adapter Androida maio w wersji 1.1.11.0.
- Obsługuje adapter maio na iOS w wersji 1.5.2.1.
Wersja 1.3.1
- Obsługuje adapter maio Androida w wersji 1.1.10.0.
- Obsługuje adapter systemu iOS maio w wersji 1.5.1.0.
Wersja 1.3.0
- Obsługuje adapter maio Androida w wersji 1.1.10.0.
- Obsługuje adapter maio na iOS w wersji 1.5.0.0.
Wersja 1.2.3
- Zaktualizowano wtyczkę, aby obsługiwała nowy interfejs Rewarded API.
- Obsługuje adapter maio Androida w wersji 1.1.7.0.
- Obsługuje adapter maio na iOS w wersji 1.4.6.0.
Wersja 1.2.2
- Obsługuje adapter maio Androida w wersji 1.1.6.0.
- Obsługuje adapter maio iOS w wersji 1.4.2.0.
Wersja 1.2.1
- Obsługuje adapter maio na Androida w wersji 1.1.6.0.
- Obsługuje adapter maio iOS w wersji 1.4.1.0.
Wersja 1.2.0
- Obsługuje adapter maio na Androida w wersji 1.1.4.1.
- Obsługuje adapter maio na iOS w wersji 1.4.0.0.
Wersja 1.1.3
- Obsługuje adapter maio Androida w wersji 1.1.3.1.
- Obsługuje adapter maio na iOS w wersji 1.3.2.0.
Wersja 1.1.2
- Obsługuje adapter maio Androida w wersji 1.1.3.0.
- Obsługuje adapter maio na iOS w wersji 1.3.2.0.
Wersja 1.1.1
- Obsługuje adapter maio na Androida w wersji 1.1.1.0.
- Obsługuje adapter maio iOS w wersji 1.3.1.1.
Wersja 1.1.0
- Obsługuje adapter maio na Androida w wersji 1.1.0.0.
- Obsługuje adapter maio iOS w wersji 1.3.0.0.
Wersja 1.0.2
- Obsługuje pakiet SDK maio na Androida w wersji 1.0.8.
- Obsługuje pakiet SDK maio na iOS w wersji 1.2.19.
Wersja 1.0.1
- Obsługuje pakiet SDK maio na Androida w wersji 1.0.7.
- Obsługuje pakiet SDK maio na iOS w wersji 1.2.19.
Wersja 1.0.0
- Pierwsza wersja
- Obsługuje pakiet SDK maio na Androida w wersji 1.0.6.
- Obsługuje pakiet SDK maio na iOS w wersji 1.2.18.