Aby omawiać nasze usługi i przekazywać opinie na ich temat, dołącz do oficjalnego kanału Discord usługi Ad Manager na serwerze społeczności Google Ads i pomiarów.

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 maio przy użyciu mediacji, a także jak przeprowadzać integrację kaskadową. 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 tekstu w języku japońskim 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 do mediacji w przypadku maio ma te możliwości:

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

Wymagania

Android API na poziomie 23 lub wyższym

maio SDK w wersji 1.0.7 lub nowszej.

Najnowszy pakiet SDK do reklam mobilnych Google.
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.

Z nagrodą

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

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

Na stronie Zarządzanie strefami zanotuj Identyfikator strefy. Będzie ona też potrzebna do skonfigurowania jednostki reklamowej Ad Managera 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 API. Na stronie interfejsu API do raportowania zanotuj identyfikator API i klucz API.

Krok 2. Skonfiguruj popyt na platformie maio w interfejsie Ad Managera

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Zaloguj się na konto Ad Managera.

Kliknij kolejno Wyświetlanie > Grupy zysku i przycisk Nowa grupa zysku.

Wpisz unikalną nazwę grupy zysku, ustaw stan na Aktywny, wybierz format reklamy i ustaw typ zasobów reklamowych na Aplikacja mobilna. W sekcji Kierowanie > Zasoby reklamowe wybierz jednostkę reklamową w obszarach Zasoby reklamowe i Aplikacja mobilna, do której chcesz dodać zapośredniczenie.

Następnie kliknij przycisk Dodaj partnera zysku.

Jeśli masz już partnera zysku w przypadku maio, możesz go wybrać. W przeciwnym razie kliknij Utwórz nowego partnera zysku.

Wybierz maio jako sieć reklamową, wpisz unikalną nazwę i włącz zapośredniczanie.

Włącz Automatyczne zbieranie danych i wpisz identyfikator API oraz klucz API uzyskane w poprzedniej sekcji.

Po wybraniu Partnera zysku wybierz Zapośredniczenie mobilne SDK jako Rodzaj integracji, Android jako Platformę i Aktywny jako Stan. Wpisz identyfikator multimediów i identyfikator strefy uzyskane w poprzedniej sekcji. Następnie wpisz wartość Domyślna stawka CPM.

Gdy skończysz, u dołu strony kliknij Zapisz.

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

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

Integracja ręczna

Pobierz najnowszą wersję pakietu SDK maio na Androida i dodaj ją do projektu.
Otwórz artefakty adaptera maio w repozytorium Maven firmy 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 Ad Managerze.

Wydawcy korzystający z pakietu SDK do reklam mobilnych Google w wersji 11.6.0 lub nowszej będą automatycznie otrzymywać od maio reklamy testowe 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 w inspektorze reklam testowanie pojedynczego źródła reklam za pomocą źródła reklam maio (kaskadowe).

Kody błędów

Jeśli adapter nie otrzyma reklamy z maio, wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi na reklamę, korzystając z ResponseInfo.getAdapterResponses() 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, które są 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”.