Z tego przewodnika dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z i-mobile za pomocą 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ą 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 Ad Managera.
Krok 2. Skonfiguruj zapotrzebowanie i-mobile w interfejsie Ad Managera
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Zaloguj się na konto Ad Managera.
Kliknij Wyświetlanie > Grupy zysku, a potem kliknij przycisk Nowa grupa zysku.
Wpisz unikalną nazwę grupy zysku, ustaw stan na Aktywna, wybierz format reklamy i ustaw Typ zasobów reklamowych na Aplikacja mobilna. W sekcji Kierowanie > Zasoby reklamowe wybierz jednostkę reklamową w sekcji Zasoby reklamowe i Aplikacja mobilna, do której chcesz dodać zapośredniczenie.
Następnie kliknij przycisk Dodaj partnera zysku.
Jeśli masz już partnera zysku dla i-mobile, możesz go wybrać. W przeciwnym razie wybierz Utwórz nowego partnera zysku.
Jako sieć reklamowa wybierz i-mobile, wpisz unikalną nazwę i włącz zapośredniczenie.
Włącz Automatyczne zbieranie danych i wpisz Nazwa logowania oraz Hasło API.
Po wybraniu partnera zysku wybierz Zapośredniczenie mobilne SDK jako Typ integracji, iOS jako Platforma i Aktywny jako Stan. Wpisz identyfikator wydawcy, identyfikator mediów i identyfikator spotu uzyskane w poprzedniej sekcji. Następnie wpisz wartość Domyślny CPM.
Gdy skończysz, u dołu strony kliknij Zapisz.
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
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).
Kroki opcjonalne:
Korzystanie z reklam natywnych
Renderowanie reklam
Adapter i-mobile wypełnia te pola w przypadku 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 Ad Managera 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.