Z tego przewodnika dowiesz się, jak używać pakietu Google Mobile Ads Flutter Plugin do wczytywania i wyświetlania reklam z maio za pomocą zapośredniczenia, co obejmuje integracje kaskadowe. Dowiesz się z niego, jak dodać maio do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter maio z aplikacją Flutter.
Interfejs panelu maio zawiera japońskie etykiety, przyciski i opisy, a zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. Jednak w opisach i instrukcjach etykiety i przyciski są określane za pomocą ich angielskich odpowiedników. Na przykład „URL スキーム” to „schemat URI adresu URL”.
Obsługiwane integracje i formaty reklam
Adapter zapośredniczenia maio ma te możliwości:
| Integracja | |
|---|---|
| Określanie stawek | |
| Kaskada | |
| Formaty | |
| Otwarcie aplikacji | |
| Baner | |
| Pełnoekranowa | |
| Z nagrodą | |
| Reklama pełnoekranowa z nagrodą | |
| Rodzimy użytkownik | |
Wymagania wstępne
Zanim przejdziesz dalej, sprawdź te kwestie:
- Najnowsza wersja Google Mobile Ads Flutter Plugin.
- Flutter w wersji 3.7.0 lub nowszej.
- To deploy on Android
- Android z interfejsem API na poziomie 24 lub wyższym.
- Aby wdrożyć na iOS:
- iOS w wersji 15.0 lub nowszej.
- Działający projekt Flutter skonfigurowany za pomocą Google Mobile Ads Flutter Plugin. Szczegółowe informacje znajdziesz w artykule Konfigurowanie Google Mobile Ads Flutter Plugin.
Krok 1. Skonfiguruj ustawienia w interfejsie maio
Najpierw zarejestruj się lub zaloguj się 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 Pełnoekranowa reklama wideo, a potem kliknij Aktualizuj.
Android

iOS

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

iOS

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

iOS

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

iOS


Krok 2. Skonfiguruj żądania maio w interfejsie Ad Managera
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Android
Instrukcje znajdziesz w kroku 2 w przewodniku dla Android.
iOS
Instrukcje znajdziesz w kroku 2 w przewodniku dla systemu iOS.
Krok 3. Zaimportuj pakiet SDK i adapter maio
Integracja przez pub.dev
(Tylko Android) Dodaj te repozytoria do pliku build.gradle w katalogu android projektu:
repositories {
google()
mavenCentral()
maven {
url = uri("https://imobile-maio.github.io/maven")
}
}
Dodaj do pliku pubspec.yaml pakietu tę zależność z najnowszymi wersjami pakietu SDK i adaptera maio:
dependencies:
gma_mediation_maio: ^1.1.8
Integracja ręczna
Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla maio, rozpakuj pobrany plik i dodaj wyodrębniony folder wtyczki (wraz z zawartością) do projektu Flutter. Następnie dodaj odwołanie do wtyczki w pliku pubspec.yaml, dodając tę zależność:
dependencies:
gma_mediation_maio:
path: path/to/local/package
Krok 4. Dodaj wymagany kod
Android
Integracja z maio nie wymaga dodatkowego kodu.
iOS
Integracja SKAdNetwork
Aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu, postępuj zgodnie z dokumentacją maio.
Krok 5. Przetestuj implementację
Włączanie reklam testowych
Upewnij się, że urządzenie testowe jest zarejestrowane w usłudze Ad Manager.
Wydawcy korzystający z pakietu Google Mobile Ads Flutter Plugin w wersji 7.26.0 lub nowszej będą automatycznie otrzymywać reklamy testowe z sieci maio na telefonach i tabletach zarejestrowanych jako urządzenia testowe podczas wysyłania żądań.
Sprawdzanie reklam testowych
Aby sprawdzić, czy otrzymujesz reklamy testowe z maio, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając ze źródeł reklam maio (kaskada).
Kody błędów
Jeśli adapter nie otrzyma reklamy z maio, wydawcy mogą sprawdzić błąd w odpowiedzi na reklamę, używając metody ResponseInfo w tych klasach:
Android
| Format | Nazwa klasy |
|---|---|
| Pełnoekranowa | jp.maio.sdk.android.mediation.admob.adapter.Interstitial |
| Z nagrodą | jp.maio.sdk.android.mediation.admob.adapter.Rewarded |
iOS
| Format | Nazwa klasy |
|---|---|
| Pełnoekranowa | GADMMaioInterstitialAdapter |
| Z nagrodą | GADMMaioRewardedAdapter |
Oto kody i powiązane z nimi komunikaty, które adapter maio wyświetla, gdy nie uda się wczytać reklamy:
Android
| Kod błędu | Przyczyna |
|---|---|
| 0-10 | maio zwrócił błąd związany z pakietem 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`. |
iOS
| Kod błędu | Przyczyna |
|---|---|
| 0-10 | maio zwrócił błąd związany z pakietem SDK. Więcej informacji znajdziesz w kodzie maio. |
| 101 | maio nie ma jeszcze dostępnej reklamy. |
| 102 | Nieprawidłowe parametry serwera (np. brak identyfikatora miejsca docelowego). |
| 103 | Adapter maio nie obsługuje żądanego formatu reklamy. |
| 104 | Reklama została już wczytana dla tej konfiguracji sieci. |
Historia zmian adaptera zapośredniczenia maio do Fluttera
Wersja 1.1.8
- Obsługuje adapter maio na Androida w wersji 2.0.9.1.
- Dodano obsługę adaptera maio na iOS w wersji 2.2.3.0.
- Zbudowano i przetestowano z użyciem wtyczki reklam mobilnych Google do Fluttera w wersji 9.1.0.
Wersja 1.1.7
- Zaktualizowano, aby obsługiwać wtyczkę reklam mobilnych Google do Fluttera w wersji 9.1.0.
- Dodaliśmy obsługę Swift Package Managera.
- Obsługuje adapter maio na Androida w wersji 2.0.9.0.
- Obsługuje adapter maio na iOS w wersji 2.2.2.0.
- Zbudowano i przetestowano z użyciem wtyczki reklam mobilnych Google do Fluttera w wersji 9.1.0.
Wersja 1.1.6
- Obsługuje adapter maio na Androida w wersji 2.0.9.0.
- Obsługuje adapter maio na iOS w wersji 2.2.1.2.
- Zbudowano i przetestowano z użyciem wtyczki reklam mobilnych Google do Fluttera w wersji 9.0.0.
Wersja 1.1.5
- Obsługuje adapter maio na Androida w wersji 2.0.8.2.
- Obsługuje adapter maio na iOS w wersji 2.2.1.2.
- Zbudowano i przetestowano z użyciem wtyczki reklam mobilnych Google do Fluttera w wersji 8.0.0.
Wersja 1.1.4
- Zaktualizowano minimalną wersję Fluttera do 3.38.1.
- Zaktualizowano, aby obsługiwać wtyczkę reklam mobilnych Google do Fluttera w wersji 8.0.0.
- Obsługuje adapter maio na Androida w wersji 2.0.8.2.
- Dodano obsługę adaptera maio na iOS w wersji 2.2.1.1.
- Zbudowano i przetestowano z użyciem wtyczki reklam mobilnych Google do Fluttera w wersji 8.0.0.
Wersja 1.1.3
- Obsługuje adapter maio na Androida w wersji 2.0.7.0.
- Obsługuje adapter maio na iOS w wersji 2.2.0.3.
- Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.
Wersja 1.1.2
- Zaktualizowano minimalną wersję Fluttera do 3.35.1.
- Zaktualizowano, aby obsługiwać wtyczkę reklam mobilnych Google do Fluttera w wersji 7.0.0.
- Obsługuje adapter maio na Androida w wersji 2.0.8.0.
- Obsługuje adapter maio na iOS w wersji 2.2.0.1.
Wersja 1.1.1
- Obsługuje adapter maio na Androida w wersji 2.0.7.0.
- Obsługuje adapter maio na iOS w wersji 2.2.0.1.
- Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.
Wersja 1.1.0
- Obsługuje adapter maio na Androida w wersji 2.0.6.0.
- Obsługuje adapter maio na iOS w wersji 2.2.0.0.
- Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.
Wersja 1.0.3
- Obsługuje adapter maio na Androida w wersji 2.0.5.0.
- Dodano obsługę adaptera maio na iOS w wersji 2.1.6.1.
- Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.
Wersja 1.0.2
- Obsługuje adapter maio na Androida w wersji 2.0.4.0.
- Dodano obsługę adaptera maio na iOS w wersji 2.1.6.1.
- Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.
Wersja 1.0.1
- Obsługuje adapter maio na Androida w wersji 2.0.3.1.
- Dodano obsługę adaptera maio na iOS w wersji 2.1.6.1.
- Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.
Wersja 1.0.0
- Pierwsza wersja.
- Obsługuje adapter maio na Androida w wersji 2.0.3.0.
- Obsługuje adapter maio na iOS w wersji 2.1.6.0.
- Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 5.3.1.