W tym przewodniku dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z mai. Zapośredniczenie AdMob, integracje kaskadowe. Przewodnik zawiera informacje o dodawaniu pakietu maio do konfiguracji pośrednictwa jednostki reklamowej oraz o integrowaniu pakietu SDK i adaptera maio z aplikacjąAndroid .
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. W opisach i instrukcjach w tym przewodniku etykiety i przyciski są jednak opisane w języku angielskim. Na przykład „URL スキーム” to „URL Scheme”.
Obsługiwane integracje i formaty reklam
Adapter pośrednictwa dla maio ma te możliwości:
Integracja | |
---|---|
Określanie stawek | |
Wodospad | |
Formaty | |
Baner | |
Pełnoekranowa | |
Z nagrodą | |
Natywna |
Wymagania
- Poziom interfejsu API 21 lub nowszy
- pakiet SDK maio w wersji 1.0.7 lub nowszej,
Najnowsza wersja pakietu SDK do reklam mobilnych Google
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.
Z nagrodą
Wpisz nazwę aplikacji, wybierz platformę i podaj adres URL aplikacji. Jako Typ reklamy wybierz Nagrody za filmy, a następnie kliknij Zaktualizuj.
Na stronie Zarządzanie aplikacjami zanotuj identyfikator mediów. W następnym kroku musisz skonfigurować jednostkę reklamową AdMob.
Na stronie Zarządzanie strefami zanotuj identyfikator strefy. Potrzebny będzie też do skonfigurowania jednostki reklamowej AdMob w następnym rozdziale.
Aby skonfigurować identyfikator jednostki reklamowej na potrzeby zapośredniczenia, oprócz identyfikatora multimediów i identyfikatora strefy musisz podać identyfikator API i klucz API. Na stronie interfejsu API do raportowania zanotuj identyfikator API i klucz API.Krok 2. Skonfiguruj zamówienia maio w interfejsie AdMob
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Musisz dodać maio do konfiguracji zapośredniczenia dla danej jednostki reklamowej.
Najpierw zaloguj się na konto AdMob. Następnie otwórz kartę Mediation (Mediacja). Jeśli masz już grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, a potem przejdź do sekcji Dodaj maio jako źródło reklam.
Aby utworzyć nową grupę zapośredniczenia, kliknij Utwórz grupę zapośredniczenia.
Wpisz format reklamy i platformę, a potem kliknij Dalej.
Nadaj grupie zapośredniczenia nazwę i wybierz lokalizacje docelowe. Następnie ustaw stan grupy zapośredniczenia na Włączona, a potem kliknij Dodaj jednostki reklamowe.
Połącz tę grupę zapośredniczenia z co najmniej jedną z Twoich istniejącychAdMob jednostek reklamowych. Następnie kliknij Gotowe.
Karta Jednostki reklamowe powinna być teraz wypełniona wybranymi przez Ciebie jednostkami reklamowymi:
Dodawanie firmy „ maio ” jako źródła reklam
Na karcie Kaskada w sekcji Źródła reklam kliknij Dodaj źródło reklam. Następnie kliknij maio.
Wybierz maio i włącz przełącznik Optymalizuj. Aby skonfigurować optymalizację źródła reklam dla maio, wpisz identyfikator API i klucz API uzyskane w poprzedniej sekcji. Następnie wpisz wartość eCPM dla mai.io i kliknij Dalej.
Jeśli masz już mapowanie dla konta mai., możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.
Następnie wpisz identyfikator multimediów i identyfikator strefy uzyskane w poprzedniej sekcji. Następnie kliknij Gotowe.
Krok 3. Importuj pakiet SDK i adapter maio
Integracja z Android 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")
}
}
}
Następnie w pliku build.gradle.kts
na poziomie aplikacji dodaj te zależności i konfiguracje implementacji. Używaj najnowszych wersji pakietu SDK i adaptera maio:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.5.0")
implementation("com.google.ads.mediation:maio:1.1.16.3")
}
Integracja ręczna
- Pobierz najnowszą wersję pakietu maio Android SDK i dodaj go do projektu.
- Otwórz elementy adaptera maio w repozytorium Maven firmy Google. Wybierz najnowszą wersję, pobierz plik „.aar” z adapterem maio i dodaj go do projektu.
Krok 4. Dodaj wymagany kod
Integracja z maio na Androida nie wymaga dodatkowego kodu.
Krok 5. Przetestuj implementację
Włączanie reklam testowych
Pamiętaj, aby zarejestrować urządzenie testowe w AdMob.
Wydawcy korzystający z wersji 11.6.0 lub nowszej pakietu SDK do reklam mobilnych Google będą automatycznie otrzymywać reklamy testowe z mai-o na telefonach i tabletach zarejestrowanych jako urządzenia testowe podczas przesył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 maia, wydawcy mogą sprawdzić błąd w odpowiedzi reklamy, korzystając z
ResponseInfo.getAdapterResponses()
w ramach tych klas:
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 odpowiednie komunikaty z adaptera maio, które pojawiają się, gdy nie udaje się załadować reklamy:
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”. |
Historia zmian adaptera zapośredniczenia na Androida (maio)
Wersja 1.1.16.3
- Minimalna wymagana wersja pakietu SDK do reklam mobilnych Google została zaktualizowana do 23.0.0.
- Weryfikowana zgodność z pakietem SDK maio w wersji 1.1.16.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 23.0.0.
- Wersja pakietu SDK Maio: 1.1.16.
Wersja 1.1.16.2
- Zaktualizowano adapter, aby używać nowej klasy
VersionInfo
. - Minimalna wymagana wersja pakietu SDK do reklam mobilnych Google została zaktualizowana do 22.0.0.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 22.0.0.
- Wersja pakietu SDK Maio: 1.1.16.
Wersja 1.1.16.1
- Zaktualizowano
compileSdkVersion
itargetSdkVersion
do poziomu API 31. - Minimalna wymagana wersja pakietu SDK do reklam mobilnych Google została zaktualizowana do 21.0.0.
- Zaktualizowaliśmy minimalny wymagany poziom interfejsu API Androida do 19.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 21.0.0.
- Wersja pakietu SDK Maio: 1.1.16.
Wersja 1.1.16.0
- Zaktualizowano kody błędów, aby uwzględnić dodatkowe błędy maio.
- Weryfikowana zgodność z pakietem SDK maio w wersji 1.1.16.
- Minimalna wymagana wersja pakietu SDK do reklam mobilnych Google została zaktualizowana do wersji 20.4.0.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 20.4.0.
- Wersja pakietu SDK Maio: 1.1.16.
Wersja 1.1.15.0
- Weryfikowana 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.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 20.0.0.
- Wersja pakietu SDK Maio: 1.1.15.
Wersja 1.1.14.0
- Dodano standardowe kody błędów i komunikaty dotyczące adaptera.
- Weryfikowana zgodność z pakietem SDK maio w wersji 1.1.14.
- Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do 19.8.0.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 19.8.0.
- Wersja pakietu SDK Maio: 1.1.14.
Wersja 1.1.13.0
- Weryfikowana zgodność z pakietem SDK maio w wersji 1.1.13.
- Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do 19.5.0.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 19.5.0.
- Wersja pakietu SDK Maio: 1.1.13.
Wersja 1.1.12.0
- Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do 19.4.0.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 19.4.0.
- Wersja pakietu SDK Maio: 1.1.12.
Wersja 1.1.11.1
- Aby ograniczyć czas oczekiwania, żądania reklamy będą się teraz natychmiast kończyć niepowodzeniem, jeśli maio nie ma reklamy gotowej do wyświetlenia.
- Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do 19.1.0.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 19.1.0.
- Wersja pakietu SDK Maio: 1.1.11.
Wersja 1.1.11.0
- Wersja zgodna z pakietem SDK maio w wersji 1.1.11.
- Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 18.3.0.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 18.3.0.
- Wersja pakietu SDK Maio: 1.1.11.
Wersja 1.1.10.0
- Wersja zgodna 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
- Weryfikowana zgodność z pakietem SDK maio w wersji 1.1.8.
- Minimalna wymagana wersja pakietu SDK do reklam mobilnych Google została zaktualizowana do 18.1.0.
Wersja 1.1.7.0
- Poprawki błędów.
- Weryfikowana zgodność z pakietem SDK maio w wersji 1.1.7.
Wersja 1.1.6.1
- Zaktualizowano adapter, aby obsługiwał nowy interfejs Rewarded API.
- Minimalna wymagana wersja pakietu SDK do reklam mobilnych Google została zaktualizowana do 17.2.0.
Wersja 1.1.6.0
- Weryfikowana zgodność z pakietem SDK maio w wersji 1.1.6.
Wersja 1.1.5.0
- Weryfikowana zgodność z pakietem SDK maio w wersji 1.1.5.
Wersja 1.1.4.0
- Zweryfikowana zgodność z pakietem SDK maio w wersji 1.1.4.
Wersja 1.1.3.1
- Zaktualizowaliśmy adapter, aby działał z klasą instancji zamiast z klasą singleton.
Wersja 1.1.3.0
- Weryfikowana zgodność z pakietem SDK maio w wersji 1.1.3.
Wersja 1.1.2.1
- Zaktualizowano adapter z aktualnymi funkcjami inicjowania.
Wersja 1.1.2.0
- Weryfikowana zgodność z pakietem SDK maio w wersji 1.1.2.
Wersja 1.1.1.1
- Zaktualizowano adapter, aby wywołać zdarzenie reklamy
onRewardedVideoComplete()
.
Wersja 1.1.1.0
- Zweryfikowana zgodność z pakietem SDK maio w wersji 1.1.1.
Wersja 1.1.0.0
- Weryfikowana zgodność z pakietem SDK maio w wersji 1.1.0.
Wersja 1.0.8.0
- Weryfikowana 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ąpienie wyjątków NullPointerException podczas próby załadowania reklam.
Wersja 1.0.7.0
- Dodano możliwość włączenia trybu testowego przez dodanie identyfikatora urządzenia testowego do
AdRequest
. - Weryfikowana zgodność z pakietem SDK maio w wersji 1.0.7.
Wersja 1.0.6.0
- Pierwsza wersja
- Dodaliśmy obsługę reklam pełnoekranowych i reklam wideo z nagrodą.