Integracja Maio z zapośredniczeniem

Wybierz platformę: Android (beta) Nowość Android iOS Unity Flutter

Z tego przewodnika dowiesz się, jak używać Google Mobile Ads Flutter Plugin, aby wczytywać i wyświetlać reklamy z maio za pomocą zapośredniczenia, 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ą Flutter.

Interfejs panelu maio używa tekstu w języku japońskim w etykietach, przyciskach i opisach, 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 „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
Reklamy pełnoekranowe
Z nagrodą
Natywna

Wymagania

  • Najnowsze Google Mobile Ads Flutter Plugin
  • Flutter 3.7.0 lub nowszy
  • Aby wdrożyć na Androidzie:
    • Android API w wersji 23 lub nowszej
  • Aby wdrożyć na iOS:
    • docelowa wersja wdrożenia iOS 12.0 lub nowsza
  • Działający projekt Flutter skonfigurowany za pomocą Google Mobile Ads Flutter Plugin. Więcej informacji znajdziesz w artykule Konfigurowanie Google Mobile Ads Flutter Plugin.
  • Skonfiguruj zapośredniczenie.

Krok 1. Skonfiguruj ustawienia w interfejsie maio

Najpierw zarejestruj się lub zaloguj się na swoje 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 (Adres URL aplikacji). Jako Ad Type (Typ reklamy) wybierz Video interstitial (Reklama pełnoekranowa wideo), a potem kliknij Update (Aktualizuj).

Android

iOS

Z nagrodą

Wpisz Name (Nazwę) aplikacji, wybierz platformę i podaj App URL (Adres URL aplikacji). Jako Ad Type (Typ reklamy) wybierz Video Rewards (Nagrody wideo), a potem kliknij Update (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 strefami) zanotuj Zone ID (Identyfikator strefy). Będzie on też potrzebny do skonfigurowania jednostki reklamowej Ad Managera w następnej sekcji.

Android

iOS

(Tylko wodospad) 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 (Identyfikator API) i API KEY (Klucz API). Na stronie Reporting API (Interfejs API do raportowania) zanotuj API ID (Identyfikator API) i API KEY (Klucz API).

Krok 2. Skonfiguruj popyt maio w interfejsie Ad Managera

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Android

Instrukcje znajdziesz w kroku 2 przewodnika dotyczącego Android.

iOS

Instrukcje znajdziesz w kroku 2 przewodnika dotyczącego iOS.

Krok 3. Zaimportuj pakiet SDK i adapter maio

Integracja przez pub.dev

Dodaj tę zależność z najnowszymi wersjami pakietu SDK i adaptera maio w pliku pubspec.yaml pakietu:

dependencies:
  gma_mediation_maio: ^1.1.3

Integracja ręczna

Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla maio, rozpakuj pobrany plik i dodaj rozpakowany folder wtyczki (wraz z jego zawartością) do projektu Flutter. Następnie dodaj do pliku pubspec.yaml tę zależność, aby odwoływać się do wtyczki:

dependencies:
  gma_mediation_maio:
    path: path/to/local/package

Krok 4. Dodaj wymagany kod

Android

Do integracji z maio nie jest wymagany żaden dodatkowy kod.

iOS

Integracja SKAdNetwork

Aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu, postępuj zgodnie z dokumentacją maio's.

Krok 5. Przetestuj implementację

Włącz reklamy testowe

Zarejestruj urządzenie testowe w usłudze Ad Manager.

Wydawcy korzystający z wtyczki reklam mobilnych Google do Fluttera w wersji 7.26.0 lub nowszej będą automatycznie otrzymywać reklamy testowe z maio na telefony i tablety zarejestrowane jako urządzenia testowe podczas wysyłania żądań.Google Mobile Ads Flutter Plugin

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 (Waterfall).

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 w tych klasach:

Android

Format Nazwa zajęć
Pełnoekranowa jp.maio.sdk.android.mediation.admob.adapter.Interstitial
Z nagrodą jp.maio.sdk.android.mediation.admob.adapter.Rewarded

iOS

Format Nazwa zajęć
Pełnoekranowa GADMMaioInterstitialAdapter
Z nagrodą GADMMaioRewardedAdapter

Oto kody i towarzyszące im komunikaty zwracane przez adapter maio, gdy nie uda się wczytać reklamy:

Android

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

iOS

Kod błędu Przyczyna
0-10 maio zwrócił błąd specyficzny dla pakietu 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 jest już wczytana w przypadku tej konfiguracji sieci.

Historia zmian adaptera zapośredniczenia maio do Fluttera

Wersja 1.1.4 (w toku)

Wersja 1.1.3

Wersja 1.1.2

Wersja 1.1.1

Wersja 1.1.0

Wersja 1.0.3

Wersja 1.0.2

Wersja 1.0.1

Wersja 1.0.0