Z tego przewodnika dowiesz się, jak korzystać z pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklamy z maio za pomocą mediacji, 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
Najpierw zarejestruj się lub zaloguj na swoje konto maio. Kliknij przycisk Zarządzanie aplikacjami na lewym pasku bocznym i wybierz Nowa aplikacja.
Wybierz kartę odpowiadającą Twojemu preferowanemu Typowi reklamy.
Pełnoekranowa
Wpisz nazwę swojej aplikacji, wybierz platformę i podaj URL aplikacji. Jako Typ reklamy wybierz Pełnoekranowa reklama wideo i kliknij Zaktualizuj.
Otrzymano
Wpisz nazwę swojej aplikacji, wybierz platformę i podaj URL aplikacji. Jako Typ reklamy wybierz Nagrody wideo i kliknij Zaktualizuj.
Na stronie Zarządzanie aplikacją zanotuj identyfikator mediów. W następnej sekcji musisz skonfigurować Ad Manager jednostkę reklamową.
Na stronie Zone Management (Zarządzanie strefą) zanotuj Identyfikator strefy. W następnej sekcji musisz też skonfigurować Ad Manager jednostkę reklamową.
Krok 2. Skonfiguruj żądania reklam Maio w Ad Manager interfejsie użytkownika
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Zaloguj się na konto Ad Managera.
Kliknij Wyświetlanie > Grupy zysku i kliknij przycisk Nowa grupa zysku.
Wpisz niepowtarzalną nazwę grupy zysku, ustaw Stan na Aktywna, wybierz Format reklamy, a jako Typ zasobów reklamowych wybierz Aplikacja mobilna. W sekcji Kierowanie > Zasoby reklamowe wybierz jednostkę reklamową w sekcjach Zasoby reklamowe i Aplikacja mobilna, do której chcesz dodać zapośredniczenie.
Następnie kliknij przycisk Dodaj partnera zysku.
Jeśli masz już partnera zysku w przypadku usługimaio, możesz go wybrać. W przeciwnym razie kliknij Utwórz nowego partnera zysku.
Jako Sieć reklamowa wybierz maio, wpisz niepowtarzalną nazwę i włącz Zapośredniczenie.
Włącz Automatyczne zbieranie danych i wpiszAPI ID and API KEY uzyskane w poprzedniej sekcji.
Po wybraniu Partnera zysku wybierz Zapośredniczenie mobilne SDK jako typ integracji, Android jako platformę i Aktywne jako stan. WpiszMedia ID and Zone ID uzyskane w poprzedniej sekcji. Następnie wpisz domyślną wartość CPM.
.Gdy skończysz, u dołu strony kliknij Zapisz.
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 Ad Manager.
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
- Naprawiono błąd, 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ą.