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

Interfejs panelu sterowania maio zawiera etykiety, przyciski i opisy w języku japońskim. 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 „Schemat URL”.

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,

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 Zone Management (Zarządzanie strefą) zanotuj identyfikator strefy. Konieczne będzie też skonfigurowanie jednostki reklamowej AdMob w następnej sekcji.

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 Ad Manager

Krok 3. Zaimportuj pakiet SDK i adapter maio

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 poniższe zależności i konfiguracje implementacji. Użyj 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

Pamiętaj, by zarejestrować urządzenie testowe w AdMob.

Właściciele witryn, którzy używają pakietu SDK do reklam mobilnych Google w wersji 11.6.0 lub nowszej, będą automatycznie otrzymywać reklamy testowe z maia na telefonach i tabletach zarejestrowanych jako urządzenia testowe podczas przesyłania żądań.

Zweryfikuj reklamy testowe

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 generowane przez adapter maio, 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.

Zaprojektowane i przetestowane:

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

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

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

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

  • Dodaliśmy ujednolicone kody błędów i komunikaty o błędach 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.
  • 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.
  • Maio SDK w wersji 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 wersji 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.
  • 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

  • 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

  • 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 o zaktualizowane funkcje 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

  • Zweryfikowano 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ępowanie wyjątków NullPointer, gdy reklamy się nie wczytywały.

Wersja 1.0.7.0

  • Dodano możliwość włączania 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ą.