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
  • 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. 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. Na pasku bocznym po lewej stronie kliknij kolejno Zarządzanie aplikacjami i 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 następnie kliknij Aktualizuj.

Android

iOS

Z nagrodą

Wpisz nazwę aplikacji, wybierz platformę i podaj adres URL aplikacji. Jako Typ reklamy wybierz Nagrody za filmy, a następnie kliknij Zaktualizuj.

Android

iOS

Na stronie Zarządzanie aplikacjami zanotuj identyfikator mediów. W następnej sekcji 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 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 żądania reklam Maio w Ad Manager interfejsie użytkownika

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Android

Instrukcje znajdziesz w kroku 2 instrukcji na Android.

iOS

Instrukcje znajdziesz w kroku 2 przewodnika po iOS.

Krok 3. Zaimportuj pakiet SDK i adapter maio

OpenUPM-CLI

Jeśli masz zainstalowany interfejs OpenUPM-CLI, możesz zainstalować w swoim projekcie wtyczkę zapośredniczenia do reklam mobilnych Google dla Unity, uruchamiając to polecenie z katalogu głównego 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 UPM

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średniczenia w reklamach mobilnych Google i kliknij Zainstaluj.

Instalowanie z OpenUPM

Pakiet Unity

Pobierz najnowszą wersję wtyczki zapośredniczenia do reklam mobilnych Google dla Maio z linku pobierania w dzienniku zmian i wyodrębnij GoogleMobileAdsMaioMediation.unitypackage z pliku ZIP.

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.

Importowanie z Unity

Następnie kliknij Zasoby > Menedżer zależności zewnętrznych > Rozwiązanie 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 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łączanie reklam testowych

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

Wydawcy korzystający z pakietu SDK do reklam mobilnych Google 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ń.

Weryfikowanie reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z Maio, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, używając źródeł reklam maio (wodospad).

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 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. Więcej informacji znajdziesz w code 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 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ż wczytana na potrzeby 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 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 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 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.