Integracja i-mobile z zapośredniczeniem

Z tego przewodnika dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z i-mobile przy użyciu mediacji, która obejmuje integrację kaskadową. Znajdziesz w nim informacje o tym, jak dodać i-mobile do konfiguracji pośrednictwa jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter i-mobile z aplikacją Unity.

W interfejsie panelu sterowania i-mobile etykiety, przyciski i opisy są w języku japońskim. Zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. W opisach i instrukcjach w tym przewodniku etykiety i przyciski są jednak przetłumaczone z odpowiednimi angielskimi odpowiednikami w nawiasach.

Obsługiwane integracje i formaty reklam

AdMob Adapter zapośredniczenia dla i-mobile ma te funkcje:

Integracja
Określanie stawek
Wodospad
Formaty
Baner
Pełnoekranowa
Z nagrodą

Wymagania

  • Unity w wersji 5.6 lub nowszej
  • Najnowsza wersja pakietu SDK do reklam mobilnych Google
  • Aby wdrożyć to 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 i-mobile

Zarejestruj się lub zaloguj na swoje konto i-mobile.

Dodaj aplikację do panelu i-mobile, klikając kartę サイト／アプリ管理 (Zarządzanie witryną/aplikacją) i przycisk platformy aplikacji.

Android

iOS

Wypełnij formularz i kliknij przycisk 新規登録 (Sign up).

Android

iOS

Aby utworzyć nowy punkt reklamowy, wybierz swoją aplikację na karcie サイト／アプリ管理 (Zarządzanie witryną/aplikacją).

Android

iOS

Otwórz kartę 広告スポット管理 (Ad Spot Management) i kliknij przycisk 新規広告スポット (New Ad Spot).

create_ad_spot

Następnie wypełnij formularz, podając 広告スポット名 (nazwa miejsca na reklamę), 広告スポットサイズ (rozmiar miejsca na reklamę) i inne szczegóły. Następnie kliknij przycisk 新規登録 (Zarejestruj się).

new_ad_spot_form

Twój nowy miejsce na reklamę jest gotowy. Aby wyświetlić szczegóły integracji, kliknij przycisk アプリ設定取得 (Uzyskaj ustawienia aplikacji).

ad_spot_list

Zanotuj パブリッシャーID (identyfikator wydawcy), メディアID (identyfikator multimediów) oraz スポットID (identyfikator miejsca). Te parametry będą Ci potrzebne później, gdy skonfigurujesz i-mobile do zapośredniczenia w interfejsie AdMob.

Android

iOS

Krok 2. Skonfiguruj źródła ofert reklamowych i-mobile w AdMob interfejsie

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 i-mobile

OpenUPM-CLI

Jeśli masz zainstalowany OpenUPM-CLI, możesz zainstalować wtyczkę Google Mobile Ads i-mobile Mediation dla Unity w projekcie, uruchamiając to polecenie w katalogu głównym projektu:

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

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 ograniczonym dostępem z tymi informacjami:

  • Nazwa: OpenUPM
  • Adres URL: https://package.openupm.com
  • Zakresy: 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 i-mobile Mediation i kliknij Zainstaluj.

Instalowanie z OpenUPM

Pakiet Unity

Pobierz najnowszą wersję wtyczki Google Mobile Ads do pośredniczenia dla i-mobile za pomocą linku do pobrania w Changelog i wyodrębnij plik GoogleMobileAdsIMobileMediation.unitypackage z pliku ZIP.

W edytorze projektu Unity wybierz Zasoby > Importuj pakiet > Pakiet niestandardowy i znajdź pobrany plik GoogleMobileAdsIMobileMediation.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. Wymagany jest dodatkowy kod

Android

Integracja z i-mobile nie wymaga dodatkowego kodu.

iOS

Integracja z SKAdNetwork

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

Krok 5. Przetestuj implementację

Włączanie reklam testowych

Pamiętaj, aby zarejestrować urządzenie testowe w AdMob. i-mobile udostępnia do testów identyfikator miejsca, identyfikator mediów oraz identyfikator wydawcy. Znajdziesz je tutaj.

Weryfikowanie reklam testowych

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

Kody błędów

Jeśli adapter nie otrzyma reklamy od i-mobile, wydawcy mogą sprawdzić błąd podstawowy w odpowiedzi reklamy, korzystając z elementu ResponseInfo w ramach tych klas:

Android

Format Nazwa zajęć
Baner com.google.ads.mediation.imobile.IMobileAdapter
Pełnoekranowa com.google.ads.mediation.imobile.IMobileAdapter
Natywna com.google.ads.mediation.imobile.IMobileMediationAdapter

iOS

Format Nazwa zajęć
Baner IMobileAdapter
Pełnoekranowa IMobileAdapter
Natywna GADMediationAdapterIMobile

Oto kody i dołączone komunikaty z adaptera i-mobile, gdy nie udaje się załadować reklamy:

Android

Kod błędu Przyczyna
0-99 Pakiet SDK i-mobile zwrócił błąd. Więcej informacji znajdziesz w opisie kodu.
101 Aby załadować reklamy, i-mobile wymaga kontekstu Activity.
102 Brak parametrów serwera i-mobile skonfigurowanych w AdMob interfejsie lub są one nieprawidłowe.
103 Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego na i-mobile.
104 Zwrot wywołania obsługiwanej przez i-mobile funkcji native ad load success zwrócił pustą listę reklam natywnych.

iOS

Kod błędu Przyczyna
0-10 Pakiet SDK i-mobile zwrócił błąd. Więcej informacji znajdziesz w kodowaniu.
101 Parametry serwera i-mobile skonfigurowane w interfejsie użytkownika AdMob są nieprawidłowe lub ich brakuje.
102 Żądany rozmiar reklamy nie odpowiada obsługiwanemu przez i-mobile rozmiarowi banera.
103 i-mobile nie udało się wyświetlić reklamy.
104 i-mobile zwrócił pusty tablica reklam natywnych.
105 Nie udało się pobrać komponentów reklam natywnych z i-mobile.
106 Usługa i-mobile nie obsługuje żądania pobrania wielu reklam pełnoekranowych z tym samym identyfikatorem Spota.

Historia zmian wtyczki i-mobile Unity Mediation

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.2

Wersja 1.2.1

Wersja 1.2.0

Wersja 1.1.0

Wersja 1.0.2

Wersja 1.0.1

Wersja 1.0.0