Zintegruj funkcję maio z zapośredniczeniem

Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z witryny Maio za pomocą zapośredniczenia w zakresie integracji kaskady. Opisano w nim, 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 w języku japońskim, a zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. W opisach i instrukcjach w tym przewodniku odniesienia do etykiet i przycisków odnoszą się jednak do ich angielskich odpowiedników. np. „URL” („Schemat URL”) i tak dalej.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia Ad Manager dla Maio udostępnia te możliwości:

Integracja
Ustalanie stawek
Wodospad
Formaty
Baner
Pełnoekranowa
Otrzymano
Natywna

Wymagania

• Interfejs API Androida na poziomie 19 lub wyższym

• maio SDK w wersji 1.0.7 lub nowszej

• Najnowszy pakiet SDK do reklam mobilnych Google

• Skorzystaj z zapośredniczenia Wprowadzenie

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.

Uwaga: reklamy pełnoekranowe w Maio są domyślnie możliwe do pominięcia.

Otrzymano

Wpisz nazwę swojej aplikacji, wybierz platformę i podaj URL aplikacji. Jako Typ reklamy wybierz Nagrody wideo i kliknij Zaktualizuj.

Uwaga: reklam wideo z nagrodą w sklepie maio domyślnie NIE można pominąć.

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.

Uwaga: Jeśli konfigurujesz konto maio po raz pierwszy, skontaktuj się z zespołem pomocy maio, aby uzyskać identyfikator API i klucz API.

Krok 2. Skonfiguruj popyt na 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.

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

.

Gdy skończysz, u dołu strony kliknij Zapisz.

Uwaga: automatyczne zbieranie danych potrzebuje kilku dni na zebranie danych, zanim będzie mogło dokładnie obliczyć wartość dynamicznego CPM dla sieci zapośredniczenia. Gdy już obliczysz eCPM, zostanie on automatycznie zaktualizowany w Twoim imieniu.

Krok 3. Zaimportuj pakiet SDK i adapter maio

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

Integracja 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 podane niżej zależności i konfiguracje implementacji. Użyj najnowszych wersji pakietu SDK maio i adaptera:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.0.0")
    implementation("com.google.ads.mediation:maio:1.1.16.2")
}

Integracja ręczna

• Pobierz najnowszą wersję pakietu SDK maio na Androida i dodaj ją do swojego projektu.
• Przejdź do artefaktów adaptera Maio w repozytorium Maven Google. Wybierz najnowszą wersję, pobierz plik „.aar” adaptera maio i dodaj go do swojego projektu.

Krok 4. Dodaj wymagany kod

Integracja maio z Androidem nie wymaga dodatkowego kodu.

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

Ważne: przed opublikowaniem aplikacji wyłącz tryb testowy Ad Manager 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 maio, wydawcy mogą sprawdzić przyczynę błędu w odpowiedzi na żądanie reklamy, korzystając z elementu ResponseInfo.getAdapterResponses() w ramach tych klas:

Format	Nazwa zajęć
Pełnoekranowa	jp.maio.sdk.android.mediation.admob.adapter.Interstitial
Otrzymano	jp.maio.sdk.android.mediation.admob.adapter.Rewarded

Oto kody i powiązane z nimi wiadomości wysyłane przez adapter maio, gdy nie można wczytać reklamy:

Kod błędu	Przyczyna
0-10	maio zwróciło 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 wczytania reklamy nie był instancją „Activity”.
0-10	maio zwróciło błąd związany z pakietem SDK. Więcej informacji znajdziesz w kodzie 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 dla tej konfiguracji sieci została już wczytana.

Historia zmian adaptera zapośredniczenia na Androida Maio

Następna wersja

• Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 22.4.0.

Wersja 1.1.16.2

• Zaktualizowano adapter, aby używać nowej klasy VersionInfo.
• Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 22.0.0.

Stworzone i przetestowane w:

• 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ą wersję pakietu SDK do reklam mobilnych Google do wersji 21.0.0.
• Zaktualizowano minimalny wymagany poziom interfejsu API Androida na 19.

Stworzone i przetestowane w:

• 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 przechwytywać dodatkowe błędy Maio.
• Zweryfikowana zgodność z pakietem maio SDK w wersji 1.1.16.
• Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 20.4.0.

Stworzone i przetestowane w:

• Pakiet SDK do reklam mobilnych Google w wersji 20.4.0.
• Maio SDK w wersji 1.1.16.

Wersja 1.1.15.0

• Zweryfikowana zgodność z pakietem maio SDK w wersji 1.1.15.
• Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 20.0.0.

Stworzone i przetestowane w:

• 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 standardowe kody błędów i komunikaty o błędach adaptera.
• Zweryfikowana zgodność z pakietem maio SDK w wersji 1.1.14.
• Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 19.8.0.

Stworzone i przetestowane w:

• Pakiet SDK do reklam mobilnych Google w wersji 19.8.0.
• Maio SDK w wersji 1.1.14.

Wersja 1.1.13.0

• Zweryfikowana zgodność z pakietem maio SDK w wersji 1.1.13.
• Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 19.5.0.

Stworzone i przetestowane w:

• 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ą wersję pakietu SDK do reklam mobilnych Google do wersji 19.4.0.

Stworzone i przetestowane w:

• 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 oczekiwania, żądania reklamy będą teraz kończyć się niepowodzeniem, jeśli maio nie ma reklamy gotowej do wyświetlenia.
• Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 19.1.0.

Stworzone i przetestowane w:

• Pakiet SDK do reklam mobilnych Google w wersji 19.1.0.
• Maio SDK w wersji 1.1.11.

Wersja 1.1.11.0

• Zweryfikowana zgodność z pakietem maio SDK w wersji 1.1.11.
• Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 18.3.0.

Stworzone i przetestowane w:

• Pakiet SDK do reklam mobilnych Google w wersji 18.3.0.
• Maio SDK w wersji 1.1.11.

Wersja 1.1.10.0

• Zweryfikowana zgodność z pakietem maio SDK w wersji 1.1.10.
• Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 18.2.0.

Wersja 1.1.8.0

• Zweryfikowana zgodność z pakietem maio SDK w wersji 1.1.8.
• Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 18.1.0.

Wersja 1.1.7.0

• Poprawki błędów.
• Zweryfikowana zgodność z pakietem maio SDK w wersji 1.1.7.

Wersja 1.1.6.1

• Zaktualizowano adapter, aby obsługiwać nowy interfejs API z nagrodą.
• Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 17.2.0.

Wersja 1.1.6.0

• Zweryfikowana zgodność z pakietem maio SDK w wersji 1.1.6.

Wersja 1.1.5.0

• Zweryfikowana zgodność z pakietem maio SDK w wersji 1.1.5.

Wersja 1.1.4.0

• Zweryfikowana zgodność z pakietem maio SDK w wersji 1.1.4.

Wersja 1.1.3.1

• Zaktualizowano adapter, aby działał z klasą instancji zamiast typu singleton.

Wersja 1.1.3.0

• Zweryfikowana zgodność z pakietem maio SDK w wersji 1.1.3.

Wersja 1.1.2.1

• Zaktualizowano adapter o zaktualizowane funkcje inicjowania.

Wersja 1.1.2.0

• Zweryfikowana zgodność z pakietem maio SDK 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 maio SDK w wersji 1.1.1.

Wersja 1.1.0.0

• Zweryfikowana zgodność z pakietem maio SDK w wersji 1.1.0.

Wersja 1.0.8.0

• Zweryfikowana zgodność z pakietem maio SDK w wersji 1.0.8.

Wersja 1.0.7.1

• Naprawiono błąd, który mógł powodować występowanie wyjątków NullPointerException w przypadku nieudanego wczytywania reklam.

Wersja 1.0.7.0

• Dodano możliwość włączania trybu testowego przez dodanie identyfikatora urządzenia testowego do: AdRequest.
• Zweryfikowana zgodność z pakietem maio SDK w wersji 1.0.7.

Wersja 1.0.6.0

• Pierwsza wersja!
• Dodaliśmy obsługę pełnoekranowych reklam i reklam wideo z nagrodą.