Integracja Maio z zapośredniczeniem

Z tego przewodnika dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z maia przy użyciu mediacji, która obejmuje integrację kaskadową. 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 używa japońskich etykiet, przycisków i opisów. 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ć 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 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 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 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ą w usłudze Ad Manager.

Android

iOS

Na stronie Zarządzanie strefami zanotuj identyfikator strefy. Potrzebny będzie też w przypadku konfigurowania jednostki reklamowej Ad Managera 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 zanotuj identyfikator API i klucz API.

Krok 2. Skonfiguruj zamówienia maio w interfejsie Ad Manager

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Android

Instrukcje znajdziesz w kroku 2 w przewodniku dotyczącym Android.

iOS

Instrukcje znajdziesz w kroku 2 w przewodniku dotyczącym iOS.

Krok 3. Importuj pakiet SDK i adapter maio

OpenUPM-CLI

Jeśli masz zainstalowany OpenUPM-CLI, możesz zainstalować w projekcie wtyczkę Google Mobile Ads maio Mediation dla Unity, uruchamiają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 Scoped Registries (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 Google Mobile Ads – maio – Mediacja 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.

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 z 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

Upewnij się, że urządzenie testowe jest zarejestrowane w Ad Managerze.

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 mai, wydawcy mogą sprawdzić błąd podstawowy w odpowiedzi reklamy, używając 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 maio zwrócił błąd związany z pakietem 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 firmy 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 do 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 na 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 na 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 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 na iOS w wersji 1.3.2.0.

Wersja 1.1.1

  • Obsługuje adapter maio Android 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.