Integracja Maio z zapośredniczeniem

Z tego przewodnika dowiesz się, jak korzystać z pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania z Maio za pomocą zapośredniczenia, na temat integracji kaskadowych. Omawiamy, jak dodać maio do konfiguracji zapośredniczenia i integracji pakietu SDK i adaptera maio z Aplikacja Unity.

Interfejs panelu sterowania maio używa japońskich etykiet, przycisków i opisów, a zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. Jednak w opisach i instrukcjach tutaj etykiety i przyciski są które są wskazywane przez ich odpowiedniki w języku angielskim. „URL 토ーム”, np. to „schemat adresów URL”, i tak dalej.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia do Maio ma te funkcje:

Integracja
Określanie stawek
Wodospad
Formaty
Baner
Reklamy pełnoekranowe
Z nagrodą

Wymagania

  • Unity 4 lub nowsza
  • Najnowszy pakiet SDK do reklam mobilnych Google
  • Aby wdrożyć na Androidzie:
    • Poziom interfejsu API 21 lub nowszy
  • Aby wdrożyć aplikację na iOS:
    • docelowa wersja iOS 12.0 lub nowsza,
  • działający projekt Unity skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Zobacz Rozpocznij, aby dowiedzieć się więcej.
  • Dokończ zapośredniczenie Przewodnik dla początkujących

Krok 1. Skonfiguruj konfiguracje w interfejsie maio

Najpierw zarejestruj się lub zaloguj się na konto maio. Kliknij Zarządzanie aplikacjami na lewym pasku bocznym i wybierz 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 Reklama pełnoekranowa z wideo, a potem kliknij Zaktualizuj.

Android

iOS

Z nagrodą

Wpisz nazwę aplikacji, wybierz platformę i podaj adres URL aplikacji. Jako Typ reklamy wybierz Nagrody wideo, a potem kliknij Aktualizuj.

Android

iOS

Na stronie Zarządzanie aplikacjami zanotuj identyfikator mediów. W następnym kroku musisz skonfigurować jednostkę reklamową AdMob.

Android

iOS

Na stronie Zarządzanie strefami zanotuj identyfikator strefy. Będzie ona też potrzebna do skonfigurowania jednostki reklamowej AdMob w następnym rozdziale.

Android

iOS

(tylko wodospad) Oprócz identyfikatora mediów i identyfikatora strefy potrzebujesz identyfikatora interfejsu API oraz API KEY, aby skonfigurować identyfikator jednostki reklamowej na potrzeby zapośredniczenia. Na stronie Reporting API zapisz wartości API ID i API KEY.

Krok 2. Skonfiguruj żądania reklam Maio w AdMob interfejsie użytkownika

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Android

Instrukcje znajdziesz w kroku 2 instrukcji na Androida.

iOS

Instrukcje znajdziesz w kroku 2 przewodnika po iOS.

Krok 3. Importuj pakiet SDK i adapter maio

OpenUPM-CLI

Jeśli masz zainstalowany OpenUPM-CLI, możesz zainstalować wtyczkę reklam mobilnych Google dla środowiska Unity w projekcie, wykonując to polecenie w katalogu głównym projektu:

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

OpenUPM

W edytorze projektu Unity wybierz Edytuj > Ustawienia projektu > Menedżer pakietów, aby otworzyć ustawienia menedżera pakietów Unity.

Na karcie Rejestry o zakresie dodaj OpenUPM jako rejestr z zakresem następujące szczegóły:

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

Szczegóły OpenUPM

Następnie kliknij Okno > Menedżer pakietów, aby otworzyć Menedżera pakietów Unity, a potem w menu kliknij Moje rejestry.

Rejestry Unity

Wybierz pakiet Zapośredniczenie reklam mobilnych Google i kliknij Zainstaluj.

Zainstaluj z OpenUPM

Pakiet Unity

Pobierz najnowszą wersję wtyczki Google Mobile Ads do pośrednictwa reklamowego dla maia z linku do pobrania w Historii zmian i rozpakuj plik zip zawierający plik GoogleMobileAdsMaioMediation.unitypackage.

W edytorze projektu Unity wybierz Zasoby > Importuj pakiet > Pakiet niestandardowy i znajdź pobrany plik GoogleMobileAdsMaioMediation.unitypackage. Upewnij się, że wszystkie pliki są zaznaczone, i kliknij Importuj.

Importuj z Unity

Następnie kliknij Zasoby > Menedżer zależności zewnętrznych > Rozwiązanie Androida > Wymuś rozwiązanie. Zewnętrzny menedżer zależności biblioteka rozpozna zależności od zera i skopiuje zadeklarowano zależności w katalogu Assets/Plugins/Android Aplikacja Unity.

Wymuś rozwiązanie

Krok 4. Dodaj wymagany kod

Android

Integracja maio nie wymaga dodatkowego kodu.

iOS

Integracja z SKAdNetwork

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

Krok 5. Przetestuj implementację

Włącz reklamy testowe

Zarejestruj urządzenie testowe na potrzeby AdMob.

Wydawcy, którzy korzystają z pakietu SDK do reklam mobilnych Google w wersji 7.26.0 lub nowszej, automatycznie będą otrzymywać w żądaniach reklamy testowe z Maio na telefony i tablety zarejestrowane jako urządzenia testowe.

Weryfikacja reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z witrynymaio, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając z maio (Waterfall) źródeł reklam.

Kody błędów

Jeśli adapter nie odbierze reklamy z Maio, wydawcy mogą sprawdzić bazowy błąd w odpowiedzi na żądanie reklamy za pomocą funkcji ResponseInfo w następujące klasy:

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 odpowiednie komunikaty generowane przez adapter maio, gdy nie udaje się załadować reklamy:

Android

Kod błędu Przyczyna
0-10 Aplikacja maio zwróciła błąd pakietu SDK. Aby dowiedzieć się więcej, zapoznaj się z kodem i dokumentacją Maio.
101 Maio nie ma dostępnej reklamy.
102 Nieprawidłowe parametry serwera (np. brak identyfikatora miejsca docelowego).
103 Kontekst użyty do załadowania reklamy nie był wystąpieniem „Activity”.

iOS

Kod błędu Przyczyna
0-10 Aplikacja maio zwróciła błąd pakietu SDK. Więcej informacji znajdziesz w kodach 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 na potrzeby tej konfiguracji sieci.

Historia zmian wtyczki maio Unity Mediation

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

  • Zaktualizowano wtyczkę, aby obsługiwała nowy interfejs Rewarded API.
  • Obsługuje adapter maio 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 maio Androida w wersji 1.1.6.0.
  • Obsługuje adapter maio iOS w wersji 1.4.2.0.

Wersja 1.2.1

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

Wersja 1.2.0

  • Obsługuje adapter 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 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 Androida w wersji 1.1.3.0.
  • Obsługuje adapter maio na 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 iOS w wersji 1.3.1.1.

Wersja 1.1.0

  • Obsługuje adapter maio na Androida w wersji 1.1.0.0.
  • Obsługuje adapter maio iOS w wersji 1.3.0.0.

Wersja 1.0.2

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

Wersja 1.0.1

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

Wersja 1.0.0

  • Pierwsza wersja
  • Obsługuje pakiet SDK maio na Androida w wersji 1.0.6.
  • Obsługuje pakiet SDK maio na iOS w wersji 1.2.18.