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. Dowiesz się z niego, jak dodać i-mobile do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter i-mobile z aplikacją Unity.

Interfejs panelu i-mobile zawiera etykiety, przyciski i opisy 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, 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ą
Rodzimy użytkownik

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te kwestie:

  • Najnowsza wersja Google Mobile Ads Unity Plugin.
  • Unity Editor w wersji 5.6 lub nowszej,
  • To deploy on Android
    • Android z interfejsem API na poziomie 24 lub wyższym.
  • 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 zapośredniczenie.

    • 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 新規登録 (Zarejestruj się).

    Android

    iOS

    Aby utworzyć nowe miejsce reklamowe, wybierz aplikację na karcie サイト／アプリ管理 (Zarządzanie witryną/aplikacją).

    Android

    iOS

    Otwórz kartę 広告スポット管理 (Zarządzanie miejscami wyświetlania reklam) i kliknij przycisk 新規広告スポット (Nowe miejsce wyświetlania reklamy).

    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

    Nowe miejsce wyświetlania reklamy jest gotowe. Aby wyświetlić szczegóły integracji, kliknij przycisk アプリ設定取得 (Pobierz ustawienia aplikacji).

    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

    Authorized Sellers for Apps (czyli plik 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 oferty reklamowe i-mobile w interfejsie Ad Managera

    Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

    Android

    Instrukcje znajdziesz w kroku 2 w przewodniku dla Android.

    iOS

    Instrukcje znajdziesz w kroku 2 w przewodniku dla systemu iOS.

    Krok 3. Zaimportuj pakiet SDK i adapter i-mobile

    OpenUPM-CLI

    Jeśli masz zainstalowany interfejs OpenUPM-CLI, możesz zainstalować w projekcie wtyczkę zapośredniczenia i-mobile do reklam mobilnych Google 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 ograniczone) dodaj OpenUPM jako rejestr ograniczony z tymi informacjami:

    • 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 w menu kliknij My Registries (Moje rejestry).

    Rejestry Unity

    Wybierz pakiet Google Mobile Ads IMobile Mediation i kliknij Install (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 przeprowadzi od podstaw rozpoznawanie zależności i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android 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 w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając ze źródeł reklam i-mobile (kaskada).

    Kody błędów

    Jeśli adapter nie otrzyma reklamy z i-mobile, wydawcy mogą sprawdzić 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
    Rodzimy użytkownik com.google.ads.mediation.imobile.IMobileMediationAdapter

    iOS

    Format Nazwa klasy
    Baner IMobileAdapter
    Pełnoekranowa IMobileAdapter
    Rodzimy użytkownik 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 SDK i-mobile zwrócił błąd. Więcej informacji znajdziesz w kodzie.
    101 i-mobile wymaga kontekstu Activity, aby wczytywać reklamy.
    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 Sieci i-mobile nie udało się pobrać komponentów reklamy natywnej.
    106 i-mobile nie obsługuje żądań dotyczących wielu reklam pełnoekranowych z tym samym identyfikatorem miejsca.

    Historia zmian wtyczki do zapośredniczenia i-mobile Unity

    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