Z tego przewodnika dowiesz się, jak korzystać z pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklamy z maio za pomocą Zapośredniczenie AdMob, na temat integracji kaskadowych. Omawiamy, jak dodać maio do konfiguracji zapośredniczenia i integracji pakietu SDK i adaptera maio z Android
Etykiety, przyciski i przyciski w interfejsie panelu maio zapisane w języku japońskim i opisy, a zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. Jednak w opisach i instrukcjach tego przewodnika etykiety i przyciski są z odpowiadającymi im odpowiednikami w języku angielskim. „URL 토ーム”, np. to „Schemat adresów URL”.
Obsługiwane integracje i formaty reklam
Adapter zapośredniczenia do Maio ma te funkcje:
Integracja | |
---|---|
Określanie stawek | |
Wodospad | |
Formaty | |
Baner | |
Pełnoekranowa | |
Z nagrodą | |
Natywna |
Wymagania
- Interfejs API Androida na poziomie 21 lub wyższym
- SDK maio w wersji 1.0.7 lub nowszej
Najnowszy pakiet SDK do reklam mobilnych Google
Dokończ zapośredniczenie Przewodnik dla początkujących
Krok 1. Skonfiguruj konfiguracje w interfejsie maio
Krok 2. Skonfiguruj żądania reklam Maio w AdMob interfejsie użytkownika
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Musisz dodać maio do konfiguracji zapośredniczenia jednostki reklamowej.
Najpierw zaloguj się na swoje konto AdMob. Następnie otwórz kartę Zapośredniczenie. Jeśli masz istniejącą grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, i przejdź od razu do sekcji Dodawanie maio jako źródła reklam.
Aby utworzyć nową grupę zapośredniczenia, wybierz Utwórz grupę zapośredniczenia.
Podaj format reklamy i platformę, a następnie kliknij Dalej.
Nazwij grupę zapośredniczenia 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 jedną istniejącą jednostką reklamowąAdMob . Następnie kliknij Gotowe.
Na karcie jednostek reklamowych powinny się pojawić wybrane przez Ciebie jednostki reklamowe:
Dodaj maio jako źródło reklam
Na karcie Kaskada w sekcji Źródła reklam kliknij Dodaj źródło reklamy. Następnie kliknij maio.
Kliknij maio i włącz przełącznik Optymalizuj. Wpisz API ID and API KEYuzyskane w poprzedniej sekcji, aby skonfigurować optymalizację źródła reklam dla:maio. Następnie wpisz wartość eCPM dlamaio i kliknij Dalej.Jeśli masz już mapowanie maio, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.
Następnie wpisz dane Media ID and Zone IDotrzymane w poprzedniej sekcji. Następnie kliknij Gotowe.
Krok 3. Zaimportuj pakiet SDK i adapter maio
Integracja z Android Studio (zalecana)
W pliku settings.gradle.kts
na poziomie projektu dodaj:
repozytoria:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://imobile-maio.github.io/maven")
}
}
}
Następnie w pliku build.gradle.kts
na poziomie aplikacji dodaj te elementy
zależności i konfiguracje wdrożenia. Użyj najnowszych wersji
SDK maio i adapter:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.3.0")
implementation("com.google.ads.mediation:maio:1.1.16.3")
}
Integracja ręczna
- Pobierz najnowszą wersję aplikacji maio Android SDK i dodaj do swojego projektu.
- Otwórz artefakty adaptera maio w repozytorium Google Maven. Wybierz najnowszą wersję, pobierz plik „.aar” adaptera Maio i dodaj go do projektu.
Krok 4. Dodaj wymagany kod
Do integracji maio z Androidem nie jest wymagany żaden dodatkowy kod.
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 11.6.0 lub nowszej, automatycznie będą otrzymywać reklamy testowe z Maio na telefony i tablety zarejestrowane jako urządzenia testowe w momencie wysyłania żądań.
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 ładowarka nie odbierze reklamy z Maio,
wydawcy mogą sprawdzić przyczynę błędu w odpowiedzi za pomocą polecenia
ResponseInfo.getAdapterResponses()
.
w następujących 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 wysyłane przez adapter Maio, gdy nie uda się wczytać reklamy:
Kod błędu | Przyczyna |
---|---|
0-10 | Aplikacja maio zwróciła błąd pakietu SDK. Zobacz kod oraz dokumentacja 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”. |
Historia zmian adaptera zapośredniczenia Androida maio
Wersja 1.1.16.3
- Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 23.0.0.
- Zweryfikowano zgodność z pakietem SDK Maio w wersji 1.1.16.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 23.0.0.
- Maio SDK w wersji 1.1.16.
Wersja 1.1.16.2
- Zaktualizowano adapter, aby używał nowej klasy
VersionInfo
. - Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 22.0.0.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 22.0.0.
- Maio SDK w wersji 1.1.16.
Wersja 1.1.16.1
- Zaktualizowano
compileSdkVersion
itargetSdkVersion
do interfejsu API 31. - Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 21.0.0.
- Zaktualizowano minimalny wymagany poziom interfejsu API Androida na 19.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 21.0.0.
- Maio SDK w wersji 1.1.16.
Wersja 1.1.16.0
- Zaktualizowano kody błędów, aby wychwytywać dodatkowe błędy maio.
- Zweryfikowano zgodność z pakietem SDK Maio w wersji 1.1.16.
- Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 20.4.0.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 20.4.0.
- Maio SDK w wersji 1.1.16.
Wersja 1.1.15.0
- Zweryfikowano zgodność z pakietem SDK Maio w wersji 1.1.15.
- Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 20.0.0.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 20.0.0.
- Maio SDK w wersji 1.1.15.
Wersja 1.1.14.0
- Dodaliśmy ujednolicone kody błędów i komunikaty o błędach adaptera.
- Zweryfikowano zgodność z pakietem SDK Maio w wersji 1.1.14.
- Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 19.8.0.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 19.8.0.
- Maio SDK w wersji 1.1.14.
Wersja 1.1.13.0
- Zweryfikowano zgodność z pakietem SDK maio w wersji 1.1.13.
- Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 19.5.0.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 19.5.0.
- Maio SDK w wersji 1.1.13.
Wersja 1.1.12.0
- Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 19.4.0.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 19.4.0.
- Maio SDK w wersji 1.1.12.
Wersja 1.1.11.1
- Aby ograniczyć czasy czasowe, żądania reklamy będą teraz natychmiast kończyć się niepowodzeniem, jeśli maio nie ma reklamy gotowej do wyświetlenia.
- Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 19.1.0.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 19.1.0.
- Maio SDK w wersji 1.1.11.
Wersja 1.1.11.0
- Zweryfikowano zgodność z pakietem SDK Maio w wersji 1.1.11.
- Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 18.3.0.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 18.3.0.
- Maio SDK w wersji 1.1.11.
Wersja 1.1.10.0
- Zweryfikowano zgodność z pakietem SDK Maio w wersji 1.1.10.
- Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 18.2.0.
Wersja 1.1.8.0
- Zweryfikowano zgodność z pakietem SDK Maio w wersji 1.1.8.
- Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 18.1.0.
Wersja 1.1.7.0
- Poprawki błędów.
- Zweryfikowano zgodność z pakietem SDK Maio w wersji 1.1.7.
Wersja 1.1.6.1
- Zaktualizowano adapter, aby obsługiwał nowy interfejs API z nagrodą.
- Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 17.2.0.
Wersja 1.1.6.0
- Zweryfikowano zgodność z pakietem SDK Maio w wersji 1.1.6.
Wersja 1.1.5.0
- Zweryfikowano zgodność z pakietem SDK Maio w wersji 1.1.5.
Wersja 1.1.4.0
- Zweryfikowano zgodność z pakietem SDK Maio w wersji 1.1.4.
Wersja 1.1.3.1
- Zaktualizowano adapter, aby pracował z klasą instancji zamiast singleton.
Wersja 1.1.3.0
- Zweryfikowano zgodność z pakietem SDK Maio w wersji 1.1.3.
Wersja 1.1.2.1
- Zaktualizowano adapter o zaktualizowane funkcje inicjowania.
Wersja 1.1.2.0
- Zweryfikowano zgodność z pakietem SDK Maio w wersji 1.1.2.
Wersja 1.1.1.1
- Zaktualizowano adapter, aby wywoływał zdarzenie reklamowe
onRewardedVideoComplete()
.
Wersja 1.1.1.0
- Zweryfikowano zgodność z pakietem SDK Maio w wersji 1.1.1.
Wersja 1.1.0.0
- Zweryfikowano zgodność z pakietem SDK Maio w wersji 1.1.0.
Wersja 1.0.8.0
- Zweryfikowano zgodność z pakietem SDK Maio w wersji 1.0.8.
Wersja 1.0.7.1
- Rozwiązaliśmy problem, który mógł powodować występowanie wyjątków NullPointer w przypadku niepowodzenia wyświetlania reklam .
Wersja 1.0.7.0
- Dodano możliwość włączania trybu testowego przez dodanie identyfikatora urządzenia testowego do
AdRequest
. - Zweryfikowano zgodność z pakietem SDK Maio w wersji 1.0.7.
Wersja 1.0.6.0
- Pierwsza wersja!
- Dodaliśmy obsługę pełnoekranowych reklam wideo z nagrodą.