Zintegruj funkcję maio z zapośredniczeniem

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

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

Aby skonfigurować identyfikator jednostki reklamowej na potrzeby zapośredniczenia, oprócz identyfikatora mediów i identyfikatora strefy będziesz potrzebować identyfikatora interfejsu API i klucza interfejsu API. Na stronie interfejsu API do raportowania zanotuj Identyfikator interfejsu API i KLUCZ API.

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

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.2.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”.
0-10 Aplikacja maio zwróciła błąd pakietu SDK. Zobacz kod maio .
101 maio nie ma jeszcze dostępnej reklamy.
102 Nieprawidłowe parametry serwera (np. brak identyfikatora miejsca docelowego).
103 Adapter maio nie obsługuje żądanego formatu reklamy.
104 Reklama została już wczytana na potrzeby tej konfiguracji sieci.

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