Ta strona została przetłumaczona przez Cloud Translation API.

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. Przewodnik zawiera informacje o dodawaniu pakietu SDK maio do konfiguracji pośrednictwa jednostki reklamowej oraz o integrowaniu pakietu SDK i adaptera 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 „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

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 wideo, a potem kliknij Aktualizuj.

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. Będzie ona też potrzebna do skonfigurowania jednostki reklamowej AdMob w następnym rozdziale.

Oprócz identyfikatora mediów i identyfikatora strefy do skonfigurowania identyfikatora jednostki reklamowej na potrzeby zapośredniczenia potrzebne są też identyfikatory interfejsu API i klucz interfejsu 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 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.

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.

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” adaptera 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 pakietu SDK do reklam mobilnych Google w wersji 11.6.0 lub nowszej będą automatycznie otrzymywać reklamy testowe z Maio na telefony i tablety zarejestrowane jako urządzenia testowe podczas wysył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 generowane przez adapter maio, gdy nie udaje się załadować reklamy:

Kod błędu	Przyczyna
0-10	Aplikacja maio zwróciła błąd pakietu 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.

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