Integracja Maio z zapośredniczeniem

Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam w Maio za pomocą zapośredniczenia obejmującego integracje kaskadowe. Przewodnik zawiera informacje o dodawaniu pakietu maio do konfiguracji pośrednictwa jednostki reklamowej oraz o integrowaniu pakietu SDK i adaptera maio z aplikacją Unity.

Interfejs panelu sterowania maio zawiera etykiety, przyciski i opisy w języku japońskim. Zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. W opisach i instrukcjach etykiety i przyciski są jednak określane za pomocą ich angielskich odpowiedników. Na przykład „URL スキーム” to „URL Scheme”, a tak dalej.

Obsługiwane integracje i formaty reklam

Adapter pośrednictwa dla maio ma te możliwości:

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

Wymagania

  • Unity 4 lub nowsza
  • Najnowsza wersja pakietu SDK do reklam mobilnych Google
  • Aby wdrożyć to na Androidzie:
    • Poziom interfejsu API 21 lub nowszy
  • Aby wdrożyć w iOS:
    • docelowa wersja iOS 12.0 lub nowsza
  • działający projekt Unity skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w artykule Pierwsze kroki.
  • Przejdź przez proces zapośredniczenia, korzystając z przewodnika dla początkujących.

Krok 1. Skonfiguruj konfiguracje w interfejsie maio

Najpierw zarejestruj się lub zaloguj się na swoje konto maio. Kliknij przycisk 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 Zone Management (Zarządzanie strefą) zanotuj identyfikator strefy. Konieczne będzie też skonfigurowanie jednostki reklamowej AdMob w następnej sekcji.

Android

iOS

(Tylko kaskada) Aby skonfigurować identyfikator jednostki reklamowej na potrzeby zapośredniczenia, oprócz identyfikatora multimediów i identyfikatora strefy musisz podać identyfikator API i klucz API. Na stronie interfejsu API do raportowania zapisz identyfikator interfejsu API i klucz interfejsu API.

Krok 2. Skonfiguruj zamówienia maio w interfejsie AdMob

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. Zaimportuj 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 ograniczone dodaj OpenUPM jako rejestr ograniczony z tymi informacjami:

  • 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 Google Mobile Ads maio Mediation i kliknij Zainstaluj.

Instalowanie z OpenUPM

Pakiet Unity

Pobierz najnowszą wersję wtyczki Google Mobile Ads do pośrednictwa reklamowego dla maia z linku do pobrania w Changelog 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 wybierz Zasoby > Zewnętrzny menedżer zależności > Program do rozpoznawania Androida > Wymuś rozwiązanie. Biblioteka menedżera zależności zewnętrznej wykona rozwiązanie zależności od podstaw i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android Twojej aplikacji Unity.

Wymuś rozwiązanie

Krok 4. Dodaj wymagany kod

Android

Integracja z maio nie wymaga dodatkowego kodu.

iOS

Integracja z SKAdNetwork

Postępuj zgodnie z dokumentacją Maio, aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu.

Krok 5. Przetestuj implementację

Włączanie reklam testowych

Pamiętaj, aby zarejestrować urządzenie testowe w AdMob.

Wydawcy korzystający z wersji 7.26.0 lub nowszej pakietu SDK do reklam mobilnych Google będą automatycznie otrzymywać reklamy testowe z maiO na telefonach i tabletach zarejestrowanych jako urządzenia testowe podczas wysyłania żądań.

Weryfikowanie reklam testowych

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

Kody błędów

Jeśli adapter nie otrzyma reklamy z maiO, wydawcy mogą sprawdzić błąd podstawowy w odpowiedzi reklamy, korzystając z 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 powiązane z nimi komunikaty wysyłane przez adapter Maio, gdy nie udało się wczytać 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 maio zwrócił błąd związany z pakietem 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ż załadowana w przypadku tej konfiguracji sieci.

Historia zmian wtyczki maio Unity Mediation

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

  • 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 iOS w wersji 1.4.6.0.

Wersja 1.2.2

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

Wersja 1.2.1

  • Obsługuje adapter maio do Androida w wersji 1.1.6.0.
  • Obsługuje adapter maio na 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 na 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 Androida w wersji 1.1.1.0.
  • Obsługuje adapter maio na 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 na 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.