Integracja Maio z zapośredniczeniem

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

Z tego przewodnika dowiesz się, jak używać Google Mobile Ads Unity Plugin do wczytywania i wyświetlania reklam z maio za pomocą mediacji, w tym integracji kaskadowych. Wyjaśnia, jak dodać maio do konfiguracji mediacji jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter maio z aplikacją Unity.

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ą
Natywna

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te kwestie:

  • Najnowsza wersja Google Mobile Ads Unity Plugin.
  • Edytor Unity w wersji 4 lub nowszej.
  • To deploy on Android
    • Android w wersji API 24 lub nowszej.
  • Aby wdrożyć na iOS:
    • Wersja docelowa iOS 15.0 lub nowsza.
  • Działający projekt Unity skonfigurowany za pomocą Google Mobile Ads Unity Plugin. Szczegółowe informacje znajdziesz w artykule Konfigurowanie Google Mobile Ads Unity 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 Zarządzanie strefą zanotuj 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 zanotuj identyfikator API i klucz API.

    Krok 2. Skonfiguruj żądania 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 w przewodniku dla systemu iOS.

    Krok 3. Zaimportuj pakiet SDK i adapter maio

    OpenUPM-CLI

    Jeśli masz zainstalowany interfejs OpenUPM-CLI, możesz zainstalować w projekcie wtyczkę zapośredniczenia maio do reklam mobilnych Google w Unity, uruchamiając to polecenie w katalogu głównym projektu:

    openupm add com.google.ads.mobile.mediation.maio

    OpenUPM

    W edytorze projektu Unity wybierz Edit (Edytuj) > Project Settings (Ustawienia projektu) > Package Manager (Menedżer pakietów), aby otworzyć Unity Package Manager Settings (Ustawienia menedżera pakietów Unity).

    Na karcie Scoped Registries (Rejestry o ograniczonym zakresie) dodaj OpenUPM jako rejestr o ograniczonym zakresie, podając te informacje:

    • Nazwa: OpenUPM
    • URL: https://package.openupm.com
    • Zakresy: com.google

    Szczegóły OpenUPM

    Następnie kliknij Window (Okno) > Package Manager (Menedżer pakietów), aby otworzyć Unity Package Manager (Menedżer pakietów Unity), i wybierz My Registries (Moje rejestry) z menu.

    Rejestry Unity

    Wybierz pakiet Google Mobile Ads Maio Mediation i kliknij Install (Zainstaluj).

    Instalowanie z OpenUPM

    Pakiet Unity

    Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla platformy maio, korzystając z linku do pobierania w dzienniku zmian, a następnie wyodrębnij plik GoogleMobileAdsMaioMediation.unitypackage z pliku ZIP.

    W edytorze projektu Unity kliknij Assets (Zasoby) > Import Package (Importuj pakiet) > Custom Package (Pakiet niestandardowy) i znajdź pobrany plik GoogleMobileAdsMaioMediation.unitypackage. Sprawdź, czy wszystkie pliki są zaznaczone, i kliknij Importuj.

    Importowanie z Unity

    Następnie kliknij Assets (Zasoby) > External Dependency Manager (Menedżer zależności zewnętrznych) > Android Resolver (Narzędzie do rozwiązywania problemów z Androidem) > Force Resolve (Wymuś rozwiązanie). Biblioteka External Dependency Manager przeprowadzi od podstaw proces rozwiązywania zależności i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android aplikacji Unity.

    Wymuś rozwiązanie

    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 zarejestrowano urządzenie testowe w Ad Managerze.

    Wydawcy korzystający z Google Mobile Ads Unity Plugin w wersji 7.26.0 lub nowszej będą automatycznie otrzymywać reklamy testowe od 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 żądanie reklamy, korzystając z 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 wtyczki zapośredniczenia Unity dla maio

    Wersja 3.1.11

    Wersja 3.1.10

    Wersja 3.1.9

    Wersja 3.1.8

    Wersja 3.1.7

    Wersja 3.1.6

    Wersja 3.1.5

    Wersja 3.1.4

    Wersja 3.1.3

    Wersja 3.1.2

    Wersja 3.1.1

    Wersja 3.1.0

    Wersja 3.0.2

    Wersja 3.0.1

    Wersja 3.0.0

    Wersja 2.0.4

    Wersja 2.0.3

    Wersja 2.0.2

    Wersja 2.0.1

    Wersja 2.0.0

    Wersja 1.4.3

    Wersja 1.4.2

    Wersja 1.4.1

    Wersja 1.4.0

    Wersja 1.3.6

    Wersja 1.3.5

    Wersja 1.3.4

    Wersja 1.3.3

    Wersja 1.3.2

    Wersja 1.3.1

    Wersja 1.3.0

    Wersja 1.2.3

    • Zaktualizowaliśmy wtyczkę, aby obsługiwała nowy interfejs API reklam z nagrodą.
    • Obsługuje adapter maio na Androida w wersji 1.1.7.0.
    • Obsługuje adapter maio na iOS w wersji 1.4.6.0.

    Wersja 1.2.2

    • Obsługuje adapter Androida MAIO w wersji 1.1.6.0.
    • Obsługuje adapter maio na iOS w wersji 1.4.2.0.

    Wersja 1.2.1

    • Dodaliśmy obsługę adaptera maio na Androida w wersji 1.1.6.0.
    • Obsługuje adapter maio iOS w wersji 1.4.1.0.

    Wersja 1.2.0

    • Dodano obsługę adaptera maio na Androida w wersji 1.1.4.1.
    • Obsługuje adapter maio na iOS w wersji 1.4.0.0.

    Wersja 1.1.3

    • Obsługuje adapter maio na Androida w wersji 1.1.3.1.
    • Obsługuje adapter maio na iOS w wersji 1.3.2.0.

    Wersja 1.1.2

    • Obsługuje adapter maio na Androida w wersji 1.1.3.0.
    • Obsługuje adapter maio iOS w wersji 1.3.2.0.

    Wersja 1.1.1

    • Obsługuje adapter maio na Androida w wersji 1.1.1.0.
    • Obsługuje adapter maio na iOS w wersji 1.3.1.1.

    Wersja 1.1.0

    • Dodano obsługę adaptera maio na Androida w wersji 1.1.0.0.
    • Obsługuje adapter MAIO na iOS w wersji 1.3.0.0.

    Wersja 1.0.2

    • Obsługuje pakiet maio Android SDK w wersji 1.0.8.
    • Obsługuje pakiet maio iOS SDK w wersji 1.2.19.

    Wersja 1.0.1

    • Obsługuje pakiet maio Android SDK w wersji 1.0.7.
    • Obsługuje pakiet maio iOS SDK w wersji 1.2.19.

    Wersja 1.0.0

    • Pierwsza wersja!
    • Obsługuje pakiet maio Android SDK w wersji 1.0.6.
    • Obsługuje pakiet maio iOS SDK w wersji 1.2.18.