Z tego przewodnika dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z i-mobile za pomocą pośrednictwa AdMob, w tym integracji kaskadowych. 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ą na iOS.
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
Adapter zapośredniczenia dla i-mobile ma te możliwości:
Integracja | |
---|---|
Określanie stawek | |
Wodospad | |
Formaty | |
Baner | |
Pełnoekranowa | |
Z nagrodą | |
Natywna |
Wymagania
- docelowa wersja iOS 12.0 lub nowsza,
Najnowsza wersja pakietu SDK do reklam mobilnych Google
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.
Wypełnij formularz i kliknij przycisk 新規登録 (Sign up).
Aby utworzyć nowy punkt reklamowy, wybierz swoją aplikację na karcie サイト/アプリ管理 (Zarządzanie witryną/aplikacją).
Otwórz kartę 広告スポット管理 (Ad Spot Management) i kliknij przycisk 新規広告スポット (New 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ę).
Twój nowy miejsce na reklamę jest gotowy. Aby wyświetlić szczegóły integracji, kliknij przycisk アプリ設定取得 (Uzyskaj ustawienia aplikacji).
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 AdMob.
Krok 2. Skonfiguruj zapotrzebowanie i-mobile w interfejsie AdMob
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Musisz dodać i-mobile do konfiguracji pośrednictwa dla danej jednostki reklamowej.
Najpierw zaloguj się na konto AdMob. Następnie otwórz kartę Mediation (Mediacja). Jeśli masz już grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, a potem przejdź do sekcji Dodaj i-mobile jako źródło reklam.
Aby utworzyć nową grupę zapośredniczenia, kliknij Utwórz grupę zapośredniczenia.
Wpisz format reklamy i platformę, a potem kliknij Dalej.
Nadaj grupie zapośredniczenia nazwę i wybierz lokalizacje docelowe. Następnie ustaw stan grupy zapośredniczenia na Włączona, a potem kliknij Dodaj jednostki reklamowe.
Połącz tę grupę zapośredniczenia z co najmniej jedną z dotychczasowych jednostek reklamowych AdMob. Następnie kliknij Gotowe.
Powinna się teraz wyświetlić karta Jednostki reklamowe z wybranymi przez Ciebie jednostkami reklamowymi:
Dodawanie i-mobile jako źródła reklam
Na karcie Kaskada w sekcji Źródła reklam kliknij Dodaj źródło reklam. Następnie wybierz i-mobile.
Wybierz i-mobile i włącz przełącznik Optymalizuj. Aby skonfigurować optymalizację źródeł reklam dla i-mobile, wpisz nazwa logowania i hasło API uzyskane w poprzedniej sekcji. Następnie wpisz wartość eCPM dla i-mobile i kliknij Dalej.
Jeśli masz już mapowanie dla i-mobile, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.
Następnie wpisz Publisher ID (Identyfikator wydawcy), Media ID (Identyfikator materiału) i Spot ID (Identyfikator reklamy) uzyskane w poprzedniej sekcji. Następnie kliknij Gotowe.
Krok 3. Zaimportuj pakiet SDK i adapter i-mobile
Za pomocą CocoaPods (zalecane)
Dodaj ten wiersz do pliku Podfile projektu:
pod 'GoogleMobileAdsMediationIMobile'
W wierszu poleceń uruchom:
pod install --repo-update
Integracja ręczna
- Pobierz najnowszą wersję pakietu SDK i-mobile i połącz go z projektem.
ImobileSdkAds.framework
- Pobierz najnowszą wersję adaptera i-mobile, korzystając z linku do pobrania w Changelog i z linku
IMobileAdapter.framework
w projekcie.
Krok 4. Dodaj wymagany kod
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 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).
Kroki opcjonalne:
Korzystanie z reklam natywnych
Renderowanie reklam
Adapter i-mobile wypełnia te opisy pól zaawansowanych reklam natywnych:
GADNativeAd
.
Pole | Komponenty zawsze uwzględniane przez adapter i-mobile |
---|---|
Nagłówek | |
Obraz | |
Treść | |
Ikona aplikacji | 1 |
Wezwanie do działania | |
Ocena w gwiazdkach | |
Sklep | |
Cena |
1 W przypadku reklam natywnych pakiet SDK i-mobile nie udostępnia zasobu ikony aplikacji. Zamiast tego adapter i-mobile wypełnia ikonę aplikacji przezroczystym obrazem.
Kody błędów
Jeśli adapter nie otrzyma reklamy z i-mobile, wydawcy mogą sprawdzić błąd w odpowiedzi reklamy, korzystając z interfejsu GADResponseInfo.adNetworkInfoArray
w tych klasach:
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:
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 AdMob 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 adaptera zapośredniczenia iOS i-mobile
Wersja 2.3.4.1
- Zaktualizowaliśmy komponent
CFBundleShortVersionString
, tak aby zawierał 3 elementy zamiast 4.
Został opracowany i przetestowany z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 11.10.0.
- Wersja pakietu SDK i-mobile: 2.3.4.
Wersja 2.3.4.0
- Weryfikowana zgodność z pakietem SDK i-mobile w wersji 2.3.4.
- Dodano obsługę zwracania wersji pakietu SDK i-mobile w
adSDKVersion
.
Został opracowany i przetestowany z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 11.2.0.
- Wersja pakietu SDK i-mobile: 2.3.4.
Wersja 2.3.3.0
- Weryfikowana zgodność z pakietem SDK i-mobile w wersji 2.3.3.
Został opracowany i przetestowany z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 11.1.0.
- Wersja pakietu SDK i-mobile: 2.3.3.
Wersja 2.3.2.1
- Usunięto przestarzałą metodę
willBackgroundApplication
z implementacji banerów, reklam pełnoekranowych i reklam natywnych. - Teraz wymagana jest co najmniej wersja 12.0 systemu iOS.
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 11.0 lub nowszej.
- Uwzględnij
Info.plist
w ramach ramowychIMobileAdapter.xcframework
.
Został opracowany i przetestowany z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 11.0.1.
- Pakiet SDK i-mobile w wersji 2.3.2.
Wersja 2.3.2.0
- Weryfikowana zgodność z pakietem SDK i-mobile w wersji 2.3.2.
- Usunięto obsługę architektury
armv7
. - Teraz wymaga minimalnej wersji iOS 11.0.
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 10.4.0 lub nowszej.
Został opracowany i przetestowany z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 10.4.0.
- Pakiet SDK i-mobile w wersji 2.3.2.
Wersja 2.3.1.0
- Weryfikowana zgodność z pakietem SDK i-mobile w wersji 2.3.1.
Został opracowany i przetestowany z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 10.3.0.
- Pakiet SDK i-mobile w wersji 2.3.1.
Wersja 2.3.0.1
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 10.0.0 lub nowszej.
Został opracowany i przetestowany z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 10.0.0.
- Pakiet SDK i-mobile w wersji 2.3.0.
Wersja 2.3.0.0
- Weryfikowana zgodność z pakietem SDK i-mobile w wersji 2.3.0.
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 9.8.0 lub nowszej.
Został opracowany i przetestowany z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 9.13.0.
- Pakiet SDK i-mobile w wersji 2.3.0.
Wersja 2.2.0.1
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 9.0.0 lub nowszej.
Został opracowany i przetestowany z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 9.0.0.
- Wersja pakietu SDK i-mobile: 2.2.0.
Wersja 2.2.0.0
- Weryfikowana zgodność z pakietem SDK i-mobile w wersji 2.2.0.
Został opracowany i przetestowany z użyciem
- Pakiet SDK do reklam mobilnych Google w wersji 8.13.0.
- Wersja pakietu SDK i-mobile: 2.2.0.
Wersja 2.1.0.1
- Zmniejszona zależność od pakietu SDK do reklam mobilnych Google w wersji 8.0.0 lub nowszej.
Został opracowany i przetestowany z użyciem
- Pakiet SDK do reklam mobilnych Google w wersji 8.4.0.
- Wersja pakietu SDK i-mobile: 2.1.0.
Wersja 2.1.0.0
- Weryfikowana zgodność z pakietem SDK i-mobile w wersji 2.1.0.
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 8.1.0 lub nowszej.
- Zaktualizowano adapter, aby używał formatu
.xcframework
.
Został opracowany i przetestowany z użyciem
- Pakiet SDK do reklam mobilnych Google w wersji 8.1.0.
- Wersja pakietu SDK i-mobile: 2.1.0.
Wersja 2.0.33.1
- Dodano standardowe kody błędów i komunikaty dotyczące adaptera.
- Adapter ogranicza teraz żądanie wielu reklam przejściowych z użyciem tego samego identyfikatora miejsca docelowego i-mobile.
- Adapter przekierowuje teraz wywołanie zwrotne
-nativeAdWillLeaveApplication:
, gdy użytkownik kliknie reklamę natywną. - Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 7.68.0 lub nowszej.
Został opracowany i przetestowany z użyciem
- Pakiet SDK do reklam mobilnych Google w wersji 7.68.0.
- Pakiet SDK i-mobile w wersji 2.0.33.
Wersja 2.0.33.0
- Weryfikowana zgodność z pakietem SDK i-mobile w wersji 2.0.33.
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 7.65.0 lub nowszej.
- Wymaga teraz co najmniej iOS 9.0.
Został opracowany i przetestowany z użyciem
- Pakiet SDK do reklam mobilnych Google w wersji 7.65.0.
- Pakiet SDK i-mobile w wersji 2.0.33.
Wersja 2.0.32.0
- Weryfikowana zgodność z pakietem SDK i-mobile w wersji 2.0.32.
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 7.60.0 lub nowszej.
- Dodano obsługę skalowania reklam w rozmiarze 320 x 50 i 320 x 100, aby lepiej dopasowywać rozmiary żądań banerów adaptacyjnych.
- Wycofano obsługę architektury i386.
Został opracowany i przetestowany z użyciem
- Pakiet SDK do reklam mobilnych Google w wersji 7.60.0.
- Wersja pakietu SDK i-mobile: 2.0.32.
Wersja 2.0.31.0
- Weryfikowana zgodność z pakietem SDK i-mobile w wersji 2.0.31.
Został opracowany i przetestowany z użyciem
- Pakiet SDK do reklam mobilnych Google w wersji 7.53.1.
- Pakiet SDK i-mobile w wersji 2.0.31.
Wersja 2.0.29.0
- Pierwsza wersja!
- Dodaliśmy obsługę banerów, reklam pełnoekranowych i reklam natywnych.
Został opracowany i przetestowany z użyciem
- Pakiet SDK do reklam mobilnych Google w wersji 7.52.0.
- Pakiet SDK i-mobile w wersji 2.0.29.