Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Integracja Maio z zapośredniczeniem

Z tego przewodnika dowiesz się, jak używać pakietu GMA Next-Gen SDK do wczytywania i wyświetlania reklam z maio za pomocą Zapośredniczenia AdMob, w tym integracji kaskadowych. Dowiesz się z niego, jak dodać maio do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter maio z aplikacją na Androida.

Interfejs panelu maio zawiera japońskie etykiety, przyciski i opisy, a zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. W opisach i instrukcjach w tym przewodniku etykiety i przyciski są jednak określane za pomocą ich angielskich odpowiedników. Na przykład „URL スキーム” to „schemat URI adresu URL”.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia maio ma te funkcje:

Integracja
Określanie stawek
Kaskada
Formaty
Baner
Pełnoekranowa
Z nagrodą
Rodzimy użytkownik

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te kwestie:

Android API na poziomie 24 lub wyższym.

pakiet SDK maio w wersji 1.0.7 lub nowszej,

Najnowsza wersja GMA Next-Gen SDK.
Skonfiguruj zapośredniczenie AdMob.

Krok 1. Skonfiguruj ustawienia w interfejsie maio

Najpierw zarejestruj się lub zaloguj się na konto maio. Na pasku bocznym po lewej stronie kliknij przycisk Zarządzanie aplikacjami, a następnie 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 Pełnoekranowa reklama wideo, a następnie kliknij Aktualizuj.

Z nagrodą

Wpisz nazwę aplikacji, wybierz platformę i podaj adres URL aplikacji. Jako Typ reklamy wybierz Reklamy wideo z nagrodą, a następnie kliknij Aktualizuj.

Na stronie Zarządzanie aplikacjami zanotuj identyfikator multimediów. Będzie on potrzebny do skonfigurowania jednostki reklamowej AdMob w następnej sekcji.

Na stronie Zone Management (Zarządzanie strefą) zanotuj Zone ID (Identyfikator strefy). Będzie on też potrzebny do skonfigurowania jednostki reklamowej AdMob w następnej sekcji.

Oprócz identyfikatora multimediów i identyfikatora strefy do skonfigurowania identyfikatora jednostki reklamowej na potrzeby zapośredniczenia potrzebne będą identyfikator interfejsu API i klucz interfejsu API. Na stronie interfejsu API do raportowania zapisz identyfikator interfejsu API i klucz interfejsu API.

Krok 2. Skonfiguruj żądania maio w interfejsie AdMob

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Musisz dodać maio do konfiguracji zapośredniczenia w jednostce reklamowej.

Najpierw zaloguj się na konto AdMob. Następnie otwórz kartę Zapośredniczenie. Jeśli masz już grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, i przejdź do sekcji Dodawanie maio jako źródła reklam.

Aby utworzyć nową grupę zapośredniczenia, kliknij Utwórz grupę zapośredniczenia.

Wpisz format reklamy i platformę, a potem kliknij Dalej.

Nadaj nazwę grupie 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ą z istniejących jednostek reklamowych AdMob. Następnie kliknij Gotowe.

Na karcie jednostek reklamowych powinny być teraz widoczne wybrane przez Ciebie jednostki reklamowe:

Dodawanie maio jako źródła reklam

Na karcie Kaskada w sekcji Źródła reklam kliknij Dodaj źródło reklam.

Wybierz maio i włącz przełącznik Optymalizuj. Aby skonfigurować optymalizację źródła reklam maio, wpisz identyfikator interfejsu API i klucz interfejsu API uzyskane w poprzedniej sekcji. Następnie wpisz wartość eCPM dla maio i kliknij Dalej.

Jeśli masz już mapowanie dla maio, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.

Następnie wpisz identyfikator multimediów i identyfikator strefy uzyskane w poprzedniej sekcji. Następnie kliknij Gotowe.

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

Krok 3. Zaimportuj 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")
    }
  }
}

W pliku gradle na poziomie aplikacji dodaj te zależności i konfiguracje implementacji:

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0")
    implementation("com.google.ads.mediation:maio:2.0.9.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Zakręcony

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0'
    implementation 'com.google.ads.mediation:maio:2.0.9.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Integracja ręczna

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

Krok 4. Dodaj wymagany kod

Integracja maio z Androidem 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 GMA Next-Gen SDK w wersji 11.6.0 lub nowszej będą automatycznie otrzymywać reklamy testowe z sieci maio na telefonach i tabletach zarejestrowanych jako urządzenia testowe podczas wysyłania żądań.

Sprawdzanie reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z maio, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając ze źródeł reklam maio (kaskada).

Kody błędów

Jeśli adapter nie otrzyma reklamy z maio, wydawcy mogą sprawdzić błąd w odpowiedzi na reklamę, korzystając z metody ResponseInfo.getAdSourceResponses() w tych klasach:

Format	Nazwa klasy
Pełnoekranowa	jp.maio.sdk.android.mediation.admob.adapter.Interstitial
Z nagrodą	jp.maio.sdk.android.mediation.admob.adapter.Rewarded

Oto kody i powiązane z nimi komunikaty, które adapter maio wyświetla, 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 kodzie 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`.
104	Żądanie zostało objęte ograniczeniem wiekowym, ale pakiet SDK maio nie może odbierać sygnałów dotyczących ograniczeń wiekowych

Historia zmian adaptera zapośredniczenia maio na Androida