Integracja Maio z zapośredniczeniem

Wybierz platformę: Android iOS Unity Flutter Android (starsza wersja)

Z tego przewodnika dowiesz się, jak za pomocą Google Mobile Ads Flutter Plugin wczytywać i wyświetlać reklamy z maio za pomocą mediacji, w tym integracji kaskadowych. Dowiesz się, jak dodać maio do konfiguracji mediacji 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 przypadku etykiet, przycisków i opisów, 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 mediacji dla maio ma te możliwości:

Integracja
Określanie stawek
Kaskada
Formaty
Otwarcie aplikacji
Baner
Pełnoekranowa
Z nagrodą
Reklama pełnoekranowa z nagrodą
Natywna

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te wymagania:

  • Najnowsza wersja Google Mobile Ads Flutter Plugin.
  • Flutter w wersji 3.7.0 lub nowszej.
  • Aby wdrożyć na Androidzie:
    • Android API w wersji 24 lub nowszej.
  • 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. Więcej informacji znajdziesz w artykule Konfigurowanie Google Mobile Ads Flutter Plugin.
  • Skonfiguruj mediację.

    • 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 (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 za obejrzenie filmu), 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 kaskada) 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 interfejsu API). Na stronie Reporting API (Interfejs API do raportowania) zanotuj API ID (Identyfikator API) i API KEY (klucz interfejsu API).

    Krok 2. Skonfiguruj popyt maio w interfejsie Ad Managera

    Konfigurowanie ustawień mediacji dla jednostki reklamowej

    Android

    Instrukcje znajdziesz w kroku 2 przewodnika dla Android.

    iOS

    Instrukcje znajdziesz w kroku 2 przewodnika dla 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 tę zależność z najnowszymi wersjami pakietu SDK i adaptera maio w pliku pubspec.yaml pakietu:

    dependencies:
  gma_mediation_maio: ^1.1.8

    Integracja ręczna

    Pobierz najnowszą wersję wtyczki mediacji reklam mobilnych Google dla maio, rozpakuj pobrany plik i dodaj rozpakowany folder wtyczki (oraz jego zawartość) 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

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

    iOS

    Integracja z 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 Ad Managerze.

    Wydawcy korzystający z wtyczki reklam mobilnych Google do FlutteraGoogle Mobile Ads Flutter Plugin 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ń.

    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 maio (kaskada) źródła lub źródeł reklam.

    Kody błędów

    Jeśli adapter nie otrzyma reklamy z maio, wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi na reklamę za pomocą 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 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 mediacji 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