Integracja i-mobile z zapośredniczeniem

Wybierz platformę: Android iOS Unity Flutter Android (starsza wersja)

Z tego przewodnika dowiesz się, jak używać pakietu Google Mobile Ads Unity Plugin do wczytywania i wyświetlania reklam z i-mobile za pomocą zapośredniczenia, co obejmuje integracje kaskadowe. Wyjaśniamy w nim, jak dodać i-mobile do konfiguracji mediacji jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter i-mobile z aplikacją Unity.

Interfejs panelu i-mobile używa japońskiego tekstu w etykietach, przyciskach i opisach. Zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. W opisach i instrukcjach w tym przewodniku etykiety i przyciski są jednak przetłumaczone, a ich angielskie odpowiedniki podano w nawiasach.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia Ad Managera dla i-mobile ma te możliwości:

Integracja
Określanie stawek
Kaskada
Formaty
Otwarcie aplikacji
Baner
Pełnoekranowa
Z nagrodą
Reklama pełnoekranowa z nagrodą
Natywna

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te kwestie:

  • Najnowsza wersja Google Mobile Ads Unity Plugin.
  • Edytor Unity w wersji 5.6 lub nowszej.
  • Wdrażanie na Androidzie
    • Android w wersji API 24 lub nowszej.
  • Aby wdrożyć na iOS:
    • iOS w wersji 13.0 lub nowszej.
  • Działający projekt Unity skonfigurowany za pomocą Google Mobile Ads Unity Plugin. Szczegółowe informacje znajdziesz w artykule Konfigurowanie Google Mobile Ads Unity Plugin.
  • Skonfiguruj mediację.

    • Krok 1. Skonfiguruj ustawienia w interfejsie i-mobile

    Zarejestruj się lub zaloguj się na 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ć nowe miejsce reklamowe, wybierz aplikację na karcie サイト／アプリ管理 (Site/Application Management).

    Android

    iOS

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

    create_ad_spot

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

    new_ad_spot_form

    Twoje nowe miejsce wyświetlania reklamy jest gotowe. Aby wyświetlić szczegóły integracji, kliknij przycisk アプリ設定取得 (Get App settings).

    ad_spot_list

    Zanotuj パブリッシャーID (identyfikator wydawcy), メディアID (identyfikator multimediów) i スポットID (Spot ID). Te parametry będą potrzebne później podczas konfigurowania i-mobile na potrzeby zapośredniczenia w interfejsie Ad Managera.

    Android

    iOS

    Zaktualizuj plik app-ads.txt

    Plik Authorized Sellers for Apps app-ads.txt to projekt IAB Tech Lab, który ma zagwarantować, że Twoje zasoby reklamowe w aplikacjach będą sprzedawane tylko w tych kanałach, na które wyrażasz zgodę. Aby zapobiec znacznej utracie przychodów z reklam, musisz wdrożyć plik app-ads.txt. Jeśli jeszcze nie masz pliku app-ads.txt, utwórz go na potrzeby Ad Managera.

    Aby wdrożyć app-ads.txt w i-mobile, zapoznaj się z najczęstszymi pytaniami.

    Krok 2. Skonfiguruj popyt i-mobile w interfejsie Ad Managera

    Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

    Android

    Instrukcje znajdziesz w kroku 2 przewodnika dotyczącego Android.

    iOS

    Instrukcje znajdziesz w kroku 2 w przewodniku dla systemu iOS.

    Krok 3. Zaimportuj pakiet SDK i-mobile i adapter

    OpenUPM-CLI

    Jeśli masz zainstalowany interfejs OpenUPM-CLI, możesz zainstalować w projekcie wtyczkę Google Mobile Ads zapośredniczenia i-mobile 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 Edit (Edytuj) > Project Settings (Ustawienia projektu) > Package Manager (Menedżer pakietów), aby otworzyć Unity Package Manager Settings (Ustawienia menedżera pakietów Unity).

    Na karcie Scoped Registries (Rejestry o ograniczonym zakresie) dodaj OpenUPM jako rejestr o ograniczonym zakresie, podając te informacje:

    • Nazwa: OpenUPM
    • URL: https://package.openupm.com
    • Zakresy: com.google

    Szczegóły OpenUPM

    Następnie kliknij Window (Okno) > Package Manager (Menedżer pakietów), aby otworzyć Unity Package Manager (Menedżer pakietów Unity), i wybierz My Registries (Moje rejestry) z menu.

    Rejestry Unity

    Wybierz pakiet Google Mobile Ads IMobile Mediation i kliknij Zainstaluj.

    Instalowanie z OpenUPM

    Pakiet Unity

    Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla i-mobile, korzystając z linku pobierania w liście zmian, i wyodrębnij plik GoogleMobileAdsIMobileMediation.unitypackage z pliku ZIP.

    W edytorze projektu Unity kliknij Assets (Zasoby) > Import Package (Importuj pakiet) > Custom Package (Pakiet niestandardowy) i znajdź pobrany plik GoogleMobileAdsIMobileMediation.unitypackage. Sprawdź, czy wszystkie pliki są zaznaczone, i kliknij Importuj.

    Importowanie z Unity

    Następnie kliknij Assets (Zasoby) > External Dependency Manager (Menedżer zależności zewnętrznych) > Android Resolver (Narzędzie do rozwiązywania problemów z Androidem) > Force Resolve (Wymuś rozwiązanie). Biblioteka External Dependency Manager od początku rozwiąże zależności i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android w aplikacji Unity.

    Wymuś rozwiązanie

    Krok 4. Wymagany dodatkowy kod

    Android

    Integracja z i-mobile nie wymaga dodatkowego kodu.

    iOS

    Integracja 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 usłudze Ad Manager. i-mobile udostępnia testowe wartości Spot ID, Media ID i Publisher ID, które znajdziesz tutaj.

    Sprawdzanie reklam testowych

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

    Kody błędów

    Jeśli adapter nie otrzyma reklamy z i-mobile, wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi na reklamę, korzystając z ResponseInfo w tych klasach:

    Android

    Format Nazwa klasy
    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 klasy
    Baner IMobileAdapter
    Pełnoekranowa IMobileAdapter
    Natywna GADMediationAdapterIMobile

    Oto kody i powiązane z nimi komunikaty, które adapter i-mobile wyświetla, gdy nie uda się wczytać reklamy:

    Android

    Kod błędu Przyczyna
    0-99 Pakiet i-mobile SDK zwrócił błąd. Więcej informacji znajdziesz w kodzie.
    101 i-mobile wymaga Activitykontekstu do wczytywania reklam.
    102 Parametry serwera i-mobile skonfigurowane w interfejsie Ad Managera są nieprawidłowe lub ich brakuje.
    103 Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez i-mobile.
    104 Wywołanie zwrotne i-mobile dotyczące udanego wczytania reklamy natywnej zwróciło 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 Ad Managera są nieprawidłowe lub ich brakuje.
    102 Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez i-mobile.
    103 Sieć i-mobile nie wyświetliła reklamy.
    104 i-mobile zwróciło pustą tablicę reklam natywnych.
    105 Nie udało się pobrać komponentów reklamy natywnej z i-mobile.
    106 i-mobile nie obsługuje żądań wielu reklam pełnoekranowych z tym samym identyfikatorem miejsca.

    Historia zmian w przypadku wtyczki i-mobile Unity Mediation Plugin

    Wersja 1.3.16

    Wersja 1.3.15

    Wersja 1.3.14

    Wersja 1.3.13

    Wersja 1.3.12

    Wersja 1.3.11

    Wersja 1.3.10

    Wersja 1.3.9

    Wersja 1.3.8

    Wersja 1.3.7

    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