Z tego przewodnika dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z maia przy użyciu mediacji, która obejmuje integrację kaskadową. Przewodnik zawiera informacje o dodawaniu pakietu maio do konfiguracji pośrednictwa jednostki reklamowej oraz o integrowaniu pakietu SDK i adaptera maio z aplikacją Unity.
Interfejs panelu sterowania maio używa japońskich etykiet, przycisków i opisów. Zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. W opisach i instrukcjach etykiety i przyciski są jednak określane za pomocą ich angielskich odpowiedników. Na przykład „URL スキーム” to „URL Scheme”, a tak dalej.
Obsługiwane integracje i formaty reklam
Adapter pośrednictwa dla maio ma te możliwości:
Integracja | |
---|---|
Określanie stawek | |
Wodospad | |
Formaty | |
Baner | |
Reklamy pełnoekranowe | |
Z nagrodą |
Wymagania
- Unity 4 lub nowsza
- 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 konfiguracje w interfejsie maio
Najpierw zarejestruj się lub zaloguj się na konto maio. Na pasku bocznym po lewej stronie kliknij kolejno Zarządzanie aplikacjami i 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 za filmy, a następnie kliknij Zaktualizuj.
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. Potrzebny będzie też do skonfigurowania jednostki reklamowej AdMob w następnym rozdziale.
Android
iOS
Krok 2. Skonfiguruj zamówienia maio 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. Importuj pakiet SDK i adapter maio
OpenUPM-CLI
Jeśli masz zainstalowany OpenUPM-CLI, możesz zainstalować w projekcie wtyczkę Google Mobile Ads maio Mediation dla Unity, uruchamiają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 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 – maio – Mediacja i kliknij Zainstaluj.
Pakiet Unity
Pobierz najnowszą wersję wtyczki reklam mobilnych Google do pośrednictwa w maio 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. 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. Dodaj wymagany kod
Android
Integracja z 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łączanie reklam testowych
Pamiętaj, aby zarejestrować urządzenie testowe w AdMob.
Wydawcy korzystający z wersji 7.26.0 lub nowszej pakietu SDK do reklam mobilnych Google będą automatycznie otrzymywać reklamy testowe z maiO na telefonach i tabletach zarejestrowanych jako urządzenia testowe podczas wysyłania żądań.
Weryfikowanie reklam testowych
Aby sprawdzić, czy otrzymujesz reklamy testowe z maio, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, korzystając ze źródła reklam maio (kaskada).
Kody błędów
Jeśli adapter nie otrzyma reklamy z mai, wydawcy mogą sprawdzić błąd podstawowy w odpowiedzi reklamy, używając ResponseInfo
w tych klasach:
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 | maio zwrócił błąd związany z pakietem 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 | maio zwrócił błąd związany z pakietem SDK. Więcej informacji znajdziesz w kodach firmy 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ż załadowana w przypadku tej konfiguracji sieci. |
Historia zmian wtyczki maio Unity Mediation
Wersja 2.0.4
- Obsługuje adapter maio na Androida w wersji 1.1.16.3.
- Obsługuje adapter maio na iOS w wersji 2.1.5.1.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.3.0.
Wersja 2.0.3
- Obsługuje adapter maio na Androida w wersji 1.1.16.3.
- Obsługuje adapter maio na iOS w wersji 2.1.5.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.1.0.
Wersja 2.0.2
- Obsługuje adapter maio na Androida w wersji 1.1.16.3.
- Obsługuje adapter maio na iOS w wersji 2.1.4.0.
- 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 Androida maio w wersji 1.1.16.2.
- Obsługuje adapter maio na iOS w wersji 2.1.3.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.0.0.
Wersja 2.0.0
- Obsługuje adapter Androida maio w wersji 1.1.16.2.
- Obsługuje adapter maio na iOS w wersji 2.1.1.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 8.6.0.
Wersja 1.4.3
- Treść adaptera została przeniesiona do
GoogleMobileAds/Mediation/Maio/
. - Obsługuje adapter Androida maio w wersji 1.1.16.2.
- Obsługuje adapter maio na iOS w wersji 1.6.3.1.
- Została ona utworzona i przetestowana z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 8.1.0.
Wersja 1.4.2
- Obsługuje adapter Androida maigo 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 Androida maigo w wersji 1.1.16.1.
- Obsługuje adapter maio na iOS 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 maiô w wersji 1.1.16.0.
- Obsługuje adapter maio na iOS w wersji 1.6.0.1.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 7.0.0.
Wersja 1.3.6
- Obsługuje adapter Androida maiô w wersji 1.1.16.0.
- Obsługuje adapter maio na iOS w wersji 1.5.8.0.
Wersja 1.3.5
- Obsługuje adapter Androida firmy maio 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 Androida maio w wersji 1.1.11.
- Obsługuje adapter maio na iOS w wersji 1.5.4.0.
Wersja 1.3.3
- Obsługuje adapter Androida maio w wersji 1.1.11.
- 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 Androida maio w wersji 1.1.10.
- Obsługuje adapter maio na iOS w wersji 1.5.1.0.
Wersja 1.3.0
- Obsługuje adapter Androida maio w wersji 1.1.10.
- 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 do 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 na Androida w wersji 1.1.6.0.
- Obsługuje adapter maio na 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 na 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 na 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 na 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 Android w wersji 1.1.1.0.
- Obsługuje adapter maio na 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 na 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.