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:

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.

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.

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

Krok 3. Zaimportuj pakiet SDK i adapter maio

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:

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")
}

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

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:

Oto kody i komunikaty wyświetlane przez adapter maio, gdy nie uda się wczytać reklamy: