Integracja Maio z zapośredniczeniem

Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam w Maio za pomocą zapośredniczenia AdMob, obejmujących integracje kaskadowe. Dowiesz się z niego, jak dodać maio do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter maio z aplikacjąAndroid .

Etykiety, przyciski i opisy w interfejsie panelu maio są zapisane w języku japońskim. Zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. W opisach i instrukcjach w tym przewodniku nazwy etykiet i przycisków mają swoje odpowiedniki 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

• Interfejs API Androida na poziomie 21 lub wyższym

• 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 swoje 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.

Uwaga: reklamy pełnoekranowe z Maio można domyślnie pominąć.

Z nagrodą

Wpisz nazwę aplikacji, wybierz platformę i podaj adres URL aplikacji. Jako Typ reklamy wybierz Nagrody wideo, a potem kliknij Aktualizuj.

Uwaga: reklamy wideo z nagrodą z maiości domyślnie NIE są możliwe do pominięcia.

Zanotuj identyfikator multimediów na stronie Zarządzanie aplikacjami. W następnej sekcji musisz skonfigurować jednostkę reklamową AdMob.

Na stronie Zone Management (Zarządzanie strefą) zanotuj identyfikator strefy. Będzie ona też potrzebna 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.

Uwaga: jeśli po raz pierwszy konfigurujesz konto maio, musisz skontaktować się z zespołem pomocy tej usługi, aby uzyskać identyfikator API i klucz API.

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.

Uwaga: optymalizację źródeł reklam musisz skonfigurować tylko raz dla każdej sieci.

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.

Ważne: Media ID musi być powiązany z aplikacją docelową, tak jak wmaio interfejsie.

Uwaga: optymalizacja źródła reklam potrzebuje kilku dni na zebranie wystarczającej ilości danych do dokładnego obliczenia eCPM dla sieci zapośredniczenia. Tymczasem stan optymalizacji źródła reklam to PENDING, więc musisz ręcznie ustawić wartość eCPM w sieci. Gdy można już obliczyć eCPM, źródło reklam zacznie je automatycznie aktualizować w Twoim imieniu.

Krok 3. Importuj pakiet SDK i adapter maio

Uwaga: brak integracji zgodnych wersji pakietu SDK Maio i pakietu SDK do reklam mobilnych Google może spowodować problemy z kompilacją.

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łą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ń.

Ważne: przed opublikowaniem aplikacji wyłącz tryb testowy AdMob imaio .

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 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 towarzyszące im komunikaty wysyłane przez adapter Maio, gdy nie uda się wczytać reklamy:

Kod błędu	Przyczyna
0-10	maio zwrócił błąd związany z pakietem SDK. Więcej informacji znajdziesz w code 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 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.

Zaprojektowane i przetestowane:

• 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.

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 i targetSdkVersion do poziomu API 31.
• Minimalna wymagana wersja pakietu SDK do reklam mobilnych Google została zaktualizowana do 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.
• 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.

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

• 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.

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.
• 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.

Zaprojektowane i przetestowane:

• 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ć 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

• Wersja zgodna z pakietem SDK maio w wersji 1.1.11.
• Zaktualizowano 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.
• 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ą.
• 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

• 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 z uaktualnionymi 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ływał zdarzenie reklamowe 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

• 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, gdy reklamy się nie wczytywały.

Wersja 1.0.7.0

• Dodano możliwość włączenia 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ę reklam pełnoekranowych i reklam wideo z nagrodą.