Integracja Maio z zapośredniczeniem

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. Dowiesz się, jak dodać maio do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter maio z aplikacją na Androida.

Interfejs panelu maio używa japońskiego tekstu w etykietach, przyciskach i opisach, a zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. W opisach i instrukcjach w tym przewodniku etykiety i przyciski są jednak przywoływane za pomocą ich angielskich odpowiedników. Na przykład „URL スキーム” to „URL Scheme”.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia dla maio ma te możliwości:

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

Wymagania

  • Android API w wersji 24 lub nowszej
  • maio SDK w wersji 1.0.7 lub nowszej
  • Najnowszy GMA Next-Gen SDK.

  • Postępuj zgodnie z instrukcjami w przewodniku dla początkujących dotyczącym zapośredniczenia .

Krok 1. Skonfiguruj ustawienia w interfejsie maio

Najpierw zarejestruj się lub zaloguj się na konto maio. Po lewej stronie kliknij przycisk Application management (Zarządzanie aplikacjami), a potem New app (Nowa aplikacja).

Wybierz kartę odpowiadającą preferowanemu Ad Type (Typowi reklamy).

Pełnoekranowa

Wpisz Name (Nazwę) aplikacji, wybierz platformę i podaj App URL (URL aplikacji). Jako Ad Type (Typ reklamy) wybierz Video interstitial (Reklama pełnoekranowa wideo), a następnie kliknij Update (Aktualizuj).

Z nagrodą

Wpisz Name (Nazwę) aplikacji, wybierz platformę i podaj App URL (URL aplikacji). Jako Ad Type (Typ reklamy) wybierz Video Rewards (Nagrody wideo), a następnie kliknij Update (Aktualizuj).

Na stronie Application Management (Zarządzanie aplikacjami) zanotuj Media ID (Identyfikator multimediów). Będzie on potrzebny do skonfigurowania jednostki reklamowej AdMob w następnej sekcji.

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

Oprócz Media ID (Identyfikatora multimediów) i Zone ID (Identyfikatora strefy) do skonfigurowania identyfikatora jednostki reklamowej na potrzeby zapośredniczenia potrzebne będą też API ID i API KEY (Klucz interfejsu API). Na stronie Reporting API page ( Strona interfejsu API do raportowania), zanotuj API ID (Identyfikator interfejsu API) i API KEY (Klucz interfejsu API).

Krok 2. Skonfiguruj popyt maio w interfejsie AdMob

Skonfiguruj ustawienia zapośredniczenia dla jednostki reklamowej

Musisz dodać maio do konfiguracji zapośredniczenia jednostki 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 następnie 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 1 z dotychczasowych jednostek reklamowych AdMob. Następnie kliknij Gotowe.

Powinna się teraz wyświetlić karta jednostek reklamowych z wybranymi jednostkami:

Dodawanie maio jako źródła reklam


Na karcie Wodospad 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 dla maio, wpisz API ID (Identyfikator interfejsu API) i API KEY (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 Media ID i Zone ID uzyskane w poprzedniej sekcji. Następnie kliknij Gotowe.


Krok 3. Zaimportuj pakiet SDK i adapter maio

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.25.0-beta01")
    implementation("com.google.ads.mediation:maio:2.0.8.1")
}

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

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:maio:2.0.8.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

Krok 4. Dodaj wymagany kod

W przypadku integracji z Androidem nie jest wymagany żaden dodatkowy kod.

Krok 5. Przetestuj implementację

Włącz reklamy testowe

Zarejestruj 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 maio na telefony i tablety zarejestrowane jako urządzenia testowe podczas wysyłania żądań.GMA Next-Gen SDK

Sprawdź reklamy testowe

Aby sprawdzić, czy otrzymujesz reklamy testowe z maio, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, używając źródła lub źródeł reklam maio (Wodospad).

Kody błędów

Jeśli adapter nie otrzyma reklamy z maio, wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi na żądanie reklamy za pomocą 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 towarzyszące im komunikaty zwracane 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`.