Z tego przewodnika dowiesz się, jak używać GMA Next-Gen SDK do wczytywania i wyświetlania reklam z maio za pomocą zapośredniczenia AdMob, w tym integracji kaskadowych. Dowiesz się, jak dodać maio do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter maio z aplikacją na Androida.
Interfejs panelu maio używa japońskiego tekstu w etykietach, przyciskach i opisach, a zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. W opisach i instrukcjach w tym przewodniku etykiety i przyciski są jednak przywoływane za pomocą ich angielskich odpowiedników. Na przykład „URL スキーム” to „URL Scheme”.
Obsługiwane integracje i formaty reklam
Adapter zapośredniczenia dla maio ma te możliwości:
| Integracja | |
|---|---|
| Określanie stawek | |
| Wodospad | |
| Formaty | |
| Baner | |
| Pełnoekranowa | |
| Z nagrodą | |
| Natywna | |
Wymagania
- Android API w wersji 24 lub nowszej
- maio SDK w wersji 1.0.7 lub nowszej
Najnowszy GMA Next-Gen SDK.
Postępuj zgodnie z instrukcjami w przewodniku dla początkujących dotyczącym zapośredniczenia .
Krok 1. Skonfiguruj ustawienia w interfejsie maio
Najpierw zarejestruj się lub zaloguj się na konto maio. Po lewej stronie kliknij przycisk Application management (Zarządzanie aplikacjami), a potem New app (Nowa aplikacja).

Wybierz kartę odpowiadającą preferowanemu Ad Type (Typowi reklamy).
Pełnoekranowa
Wpisz Name (Nazwę) aplikacji, wybierz platformę i podaj App URL (URL aplikacji). Jako Ad Type (Typ reklamy) wybierz Video interstitial (Reklama pełnoekranowa wideo), a następnie kliknij Update (Aktualizuj).

Z nagrodą
Wpisz Name (Nazwę) aplikacji, wybierz platformę i podaj App URL (URL aplikacji). Jako Ad Type (Typ reklamy) wybierz Video Rewards (Nagrody wideo), a następnie kliknij Update (Aktualizuj).

Na stronie Application Management (Zarządzanie aplikacjami) zanotuj Media ID (Identyfikator multimediów). Będzie on potrzebny do skonfigurowania jednostki reklamowej AdMob w następnej sekcji.

Na stronie Zone Management (Zarządzanie strefami) zanotuj Zone ID (Identyfikator strefy). Będzie on też potrzebny do skonfigurowania jednostki reklamowej AdMob w następnej sekcji.


Krok 2. Skonfiguruj popyt maio w interfejsie AdMob
Skonfiguruj ustawienia zapośredniczenia dla jednostki reklamowej
Musisz dodać maio do konfiguracji zapośredniczenia jednostki reklamowej.
Najpierw zaloguj się na konto AdMob. Następnie otwórz kartę Zapośredniczenie. Jeśli masz już grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, i przejdź do sekcji Dodawanie maio jako źródła reklam.
Aby utworzyć nową grupę zapośredniczenia, kliknij Utwórz grupę zapośredniczenia.

Wpisz format reklamy i platformę, a następnie kliknij Dalej.

Nadaj grupie zapośredniczenia nazwę i wybierz lokalizacje, na które chcesz kierować reklamy. Następnie ustaw stan grupy zapośredniczenia na Włączona i kliknij Dodaj jednostki reklamowe.

Powiąż tę grupę zapośredniczenia z co najmniej 1 z dotychczasowych jednostek reklamowych AdMob. Następnie kliknij Gotowe.

Powinna się teraz wyświetlić karta jednostek reklamowych z wybranymi jednostkami:

Dodawanie maio jako źródła reklam
Na karcie Wodospad w sekcji Źródła reklam kliknij Dodaj źródło reklam.
Wybierz maio i włącz przełącznik Optymalizuj. Aby skonfigurować optymalizację źródła reklam dla maio, wpisz API ID (Identyfikator interfejsu API) i API KEY (Klucz interfejsu API) uzyskane w poprzedniej sekcji. Następnie wpisz wartość eCPM dla maio i kliknij Dalej.

Jeśli masz już mapowanie dla maio, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.

Następnie wpisz Media ID i Zone ID uzyskane w poprzedniej sekcji. Następnie kliknij Gotowe.

Krok 3. Zaimportuj pakiet SDK i adapter maio
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-maio.github.io/maven")
}
}
}
W pliku Gradle na poziomie aplikacji dodaj te zależności implementacji i konfiguracje:
Kotlin
dependencies { implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01") implementation("com.google.ads.mediation:maio:2.0.8.1") } configurations.configureEach { exclude(group = "com.google.android.gms", module = "play-services-ads") exclude(group = "com.google.android.gms", module = "play-services-ads-lite") }
Groovy
dependencies { implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01' implementation 'com.google.ads.mediation:maio:2.0.8.1' } configurations.configureEach { exclude group: 'com.google.android.gms', module: 'play-services-ads' exclude group: 'com.google.android.gms', module: 'play-services-ads-lite' }
Integracja ręczna
- Pobierz najnowszą wersję pakietu maio Android SDK i dodaj ją do projektu.
- Otwórz artefakty adaptera maio w repozytorium Maven Google. Wybierz najnowszą wersję, pobierz plik `.aar` adaptera maio i dodaj go do projektu.
Krok 4. Dodaj wymagany kod
W przypadku integracji z Androidem nie jest wymagany żaden dodatkowy kod.
Krok 5. Przetestuj implementację
Włącz reklamy testowe
Zarejestruj urządzenie testowe w AdMob.
Sprawdź reklamy testowe
Aby sprawdzić, czy otrzymujesz reklamy testowe z maio, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, używając źródła lub źródeł reklam maio (Wodospad).
Kody błędów
Jeśli adapter nie otrzyma reklamy z maio,
wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi na żądanie reklamy za pomocą
ResponseInfo.getAdSourceResponses()
w tych klasach:
| Format | Nazwa zajęć |
|---|---|
| Pełnoekranowa | jp.maio.sdk.android.mediation.admob.adapter.Interstitial |
| Z nagrodą | jp.maio.sdk.android.mediation.admob.adapter.Rewarded |
Oto kody i towarzyszące im komunikaty zwracane przez adapter maio, gdy nie uda się wczytać reklamy:
| Kod błędu | Przyczyna |
|---|---|
| 0-10 | maio zwrócił błąd specyficzny dla pakietu SDK. Więcej informacji znajdziesz w kodzie i dokumentacji maio. |
| 101 | Maio nie ma dostępnej reklamy. |
| 102 | Nieprawidłowe parametry serwera (np. brak identyfikatora miejsca docelowego). |
| 103 | Kontekst użyty do wczytania reklamy nie był instancją `Activity`. |