Integracja Maio z zapośredniczeniem

Wybierz platformę: Android (beta) Android iOS Unity Flutter

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

Interfejs panelu platformy maio używa japońskiego tekstu w przypadku etykiet, przycisków i opisów, a zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. W opisach i instrukcjach w tym przewodniku etykiety i przyciski są jednak podawane w języku angielskim. „URL スキーム” to na przykład „URL Scheme”.

Obsługiwane integracje i formaty reklam

Adapter mediacji w przypadku maio ma te możliwości:

Integracja
Określanie stawek
Wodospad
Formaty
Baner
Pełnoekranowa
Z nagrodą
Natywna

Wymagania

• Android w wersji 24 lub nowszej

• maio SDK w wersji 1.0.7 lub nowszej.

• Najnowsze GMA Next-Gen SDK.

• Zapoznaj się z przewodnikiem dla początkujących dotyczącym mediacji.

Krok 1. Skonfiguruj ustawienia w interfejsie maio

Najpierw zarejestruj się lub zaloguj 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 Reklama pełnoekranowa wideo, a następnie kliknij Aktualizuj.

Uwaga: reklamy pełnoekranowe z maio można domyślnie pominąć.

Z nagrodą

Wpisz nazwę aplikacji, wybierz platformę i podaj adres URL aplikacji. Jako Typ reklamy wybierz Reklamy z nagrodą w formie filmu, a potem kliknij Aktualizuj.

Uwaga: reklamy wideo z nagrodą od maio NIE są domyślnie możliwe do pominięcia.

Na stronie Application Management (Zarządzanie aplikacjami) zanotuj Media ID (Identyfikator multimediów). Jest to potrzebne do skonfigurowania jednostki reklamowej AdMob w następnej sekcji.

Na stronie Zarządzanie strefami zanotuj Identyfikator strefy. Będzie ona też potrzebna 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 zanotuj identyfikator API i klucz API.

Uwaga: Jeśli konfigurujesz konto maio po raz pierwszy, może być konieczne skontaktowanie się z zespołem pomocy maio, aby uzyskać identyfikator API i klucz API.

Krok 2. Skonfiguruj popyt w maio w interfejsie AdMob

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Musisz dodać maio do konfiguracji mediacji w przypadku jednostki reklamowej.

Najpierw zaloguj się na konto AdMob. Następnie otwórz kartę Mediacja. 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 grupie zapośredniczenia nazwę 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 dotychczasowych jednostek reklamowych AdMob. Następnie kliknij Gotowe.

Na karcie jednostek reklamowych powinny się teraz wyświetlać wybrane przez Ciebie jednostki:

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 w przypadku maio, wpisz identyfikator interfejsu API i klucz interfejsu API uzyskane w poprzedniej sekcji. Następnie wpisz wartość eCPM dla maio i kliknij Dalej.

Uwaga: optymalizację źródła reklam trzeba skonfigurować tylko raz w przypadku każdej sieci.

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.

Ważne: identyfikator multimediów musi być powiązany z aplikacją docelową, tak jak w interfejsie maio.

Uwaga: optymalizacja źródeł 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 tylko 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

Uwaga: brak integracji zgodnych wersji biblioteki MAIO i GMA Next-Gen SDK może prowadzić do problemów z kompilacją.

Integracja z Androidem 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 implementacji i konfiguracje:

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:maio:2.0.8.0")
}

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:0.24.0-beta02'
    implementation 'com.google.ads.mediation:maio:2.0.8.0'
}

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ę maio Android SDK i dodaj ją do projektu.
• Otwórz artefakty 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 z maio na Androidzie nie wymaga dodatkowego kodu.

Krok 5. Przetestuj implementację

Włączanie reklam testowych

Upewnij się, że zarejestrowano urządzenie testowe w AdMob.

Wydawcy korzystający z GMA Next-Gen SDK w wersji 11.6.0 lub nowszej będą automatycznie otrzymywać reklamy testowe z maio na telefonach i tabletach zarejestrowanych jako urządzenia testowe podczas wysyłania żądań.

Ważne: przed opublikowaniem aplikacji wyłącz tryb testowy w przypadku AdMob i maio.

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ódeł reklam maio (kaskadowe).

Kody błędów

Jeśli adapter nie otrzyma reklamy z maio, wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi na żądanie reklamy, korzystając z ResponseInfo.getAdSourceResponses() w tych 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 komunikaty wyświetlane przez adapter maio, gdy nie uda się wczytać reklamy:

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