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 tłumaczone z odpowiednimi angielskimi odpowiednikami w nawiasach.

Obsługiwane integracje i formaty reklam

Ad Manager 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ć 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) i スポットID (identyfikator miejsca). Te parametry będą Ci potrzebne później, gdy skonfigurujesz i-mobile do mediacji w interfejsie Ad Managera.

Android

iOS

Krok 2. Skonfiguruj zapotrzebowanie na reklamy mobilne 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. Zaimportuj pakiet SDK i adapter i-mobile

OpenUPM-CLI

Jeśli masz zainstalowany interfejs wiersza poleceń OpenUPM-CLI, możesz zainstalować w projekcie wtyczkę Google Mobile Ads i i-mobile Mediation dla Unity, 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 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 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ązywanie 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

Upewnij się, że urządzenie testowe jest zarejestrowane w Ad Managerze. i-mobile udostępnia testowe identyfikatory Spotu, Media i Publisher. 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, korzystając z źródeł reklam i-mobile (kaskada).

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 kodowaniu.
101 Aby załadować reklamy, i-mobile wymaga kontekstu Activity.
102 Parametry serwera i-mobile skonfigurowane w interfejsie użytkownika Ad Manager są nieprawidłowe lub ich brakuje.
103 Żądany rozmiar reklamy nie odpowiada obsługiwanemu przez i-mobile rozmiarowi banera.
104 Funkcja wywołania zwrotnego po pomyślnym załadowaniu reklamy natywnej w i-mobile zwróciła pustą listę reklam natywnych.

iOS

Kod błędu Przyczyna
0-10 Pakiet SDK i-mobile zwrócił błąd. Więcej informacji znajdziesz w kodzie.
101 Parametry serwera i-mobile skonfigurowane w interfejsie użytkownika Ad Manager są nieprawidłowe lub ich brakuje.
102 Żądany rozmiar reklamy nie odpowiada obsługiwanemu przez i-mobile rozmiarowi banera.
103 i-mobile nie może 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 i-mobile nie obsługuje żądań dotyczących wielu reklam przejściowych z użyciem tego samego identyfikatora miejsca docelowego.

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