Integracja Maio z zapośredniczeniem

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.
  • Skonfiguruj zapośredniczenie.
  • 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

    (Tylko kaskada) 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 interfejsu API. Na stronie interfejsu API do raportowania zapisz identyfikator interfejsu API i klucz interfejsu API.

    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

    Wersja 1.1.7

    Wersja 1.1.6

    Wersja 1.1.5

    Wersja 1.1.4

    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