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

Integracja Maio z zapośredniczeniem

Z tego przewodnika dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z maia przy użyciu mediacji AdMob, uwzględniając integracje kaskadowe. Przewodnik zawiera informacje o dodawaniu pakietu maio do konfiguracji pośrednictwa jednostki reklamowej oraz o integrowaniu pakietu SDK i adaptera maio z aplikacją na Androida.

Interfejs panelu sterowania maio używa japońskich etykiet, przycisków i opisów. 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,

pakiet SDK maio w wersji 1.0.7 lub nowszej,

Najnowsza wersja pakietu SDK do reklam mobilnych Google
Przeczytaj Przewodnik 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 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 Zarządzanie strefami zanotuj identyfikator strefy. Potrzebny będzie też do skonfigurowania jednostki reklamowej AdMob w następnym rozdziale.

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 popyt maio w interfejsie AdMob

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Musisz dodać maio do konfiguracji pośrednictwa dla danej jednostki reklamowej.

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

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

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

Nadaj grupie zapośredniczenia nazwę i wybierz lokalizacje docelowe. Następnie ustaw stan grupy zapośredniczenia na Włączona, a potem kliknij Dodaj jednostki reklamowe.

Połącz tę grupę zapośredniczenia z co najmniej jedną z dotychczasowych jednostek reklamowych AdMob. Następnie kliknij Gotowe.

Powinna się teraz wyświetlić karta Jednostki reklamowe z wybranymi przez Ciebie jednostkami reklamowymi:

Dodawanie maio jako źródła reklam

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

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

Jeśli masz już mapowanie dla konta mai., 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. Tymczasem stan optymalizacji źródła reklam to PENDING, więc musisz ręcznie ustawić wartość eCPM dla tej sieci. Gdy można obliczyć eCPM, źródło reklam automatycznie zacznie aktualizować tę wartość w Twoim imieniu.

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.6.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łączanie reklam testowych

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

Wydawcy korzystający z wersji 11.6.0 lub nowszej pakietu SDK do reklam mobilnych Google będą automatycznie otrzymywać reklamy testowe z maia na telefonach i tabletach zarejestrowanych jako urządzenia testowe podczas przesył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 maiO, wydawcy mogą sprawdzić błąd w odpowiedzi na reklamę, korzystając z usługi 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”.