Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z i-mobile przy użyciu zapośredniczenia (w tym do integracji kaskady). Opisano w nim, jak dodać i-mobile do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter i-mobile z aplikacją iOS .
Etykiety, przyciski i opisy w interfejsie panelu i-mobile 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 angielskimi odpowiednikami w nawiasach.
Obsługiwane integracje i formaty reklam
Adapter zapośredniczenia AdMob dla i-mobile ma te możliwości:
Integracja | |
---|---|
Ustalanie stawek | |
Wodospad | |
Formaty | |
Baner | |
Pełnoekranowa | |
Otrzymano | |
Natywna |
Wymagania
- Wartość docelowa wdrożenia iOS w wersji 12.0 lub nowszej
Najnowszy pakiet SDK do reklam mobilnych Google
Skorzystaj z zapośredniczenia Wprowadzenie
Krok 1. Skonfiguruj ustawienia w interfejsie użytkownika i-mobile
Zarejestruj się lub zaloguj na konto i-mobile.
Aby dodać aplikację do panelu i-mobile, kliknij kartę サイシ/アプチ管理 (Site/Application Management) i kliknij przycisk platformy aplikacji.
Wypełnij formularz i kliknij przycisk OPEN規登録 (Zarejestruj się).
Aby utworzyć nowe Spot reklamowy, wybierz swoją aplikację na karcie サイシ/アプチ管理 (Site/Application Management).
Przejdź do karty 広告ブブッシ管理 (Zarządzanie miejscem wyświetlania reklamy) i kliknij przycisk 規広告すッ (Nowe miejsce reklamy).
Następnie wypełnij formularz, podając 広告ブッブシキ (nazwa miejsca reklamy), 広告すッブサイズ (rozmiar reklamy) i inne szczegóły. Następnie kliknij przycisk OPEN規登録 (Zarejestruj się).
Twoje nowe miejsce wyświetlania reklamy jest gotowe. Aby wyświetlić szczegóły jego integracji, kliknij przycisk アプ zespołami엔定取得 (Pobierz ustawienia aplikacji).
Zwróć uwagę na パャキッシャーID (identyfikator wydawcy), 名デすアID (Media ID) i カッブシID (identyfikator Spotu). Będziesz ich potrzebować później podczas konfigurowania i-mobile na potrzeby zapośredniczenia w interfejsie AdMob .
Krok 2. Skonfiguruj oferty reklamowe i-mobile w AdMob interfejsie użytkownika
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Musisz dodać i-mobile do konfiguracji zapośredniczenia jednostki reklamowej.
Najpierw zaloguj się na swoje konto AdMob. Następnie otwórz kartę Zapośredniczenie. Jeśli masz istniejącą grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, i przejdź od razu do sekcji Dodawanie i-mobile jako źródła reklam.
Aby utworzyć nową grupę zapośredniczenia, wybierz Utwórz grupę zapośredniczenia.
Podaj format reklamy i platformę, a następnie kliknij Dalej.
Nazwij grupę zapośredniczenia i wybierz lokalizacje, na które chcesz kierować reklamy. Następnie ustaw stan grupy zapośredniczenia na Włączona i kliknij Dodaj jednostki reklamowe.
Powiąż tę grupę zapośredniczenia z co najmniej jedną istniejącą jednostką reklamowąAdMob . Następnie kliknij Gotowe.
Na karcie jednostek reklamowych powinny się pojawić wybrane przez Ciebie jednostki reklamowe:
Dodaj i-mobile jako źródło reklam
Na karcie Kaskada w sekcji Źródła reklam kliknij Dodaj źródło reklamy. Następnie kliknij i-mobile.
Kliknij i-mobile i włącz przełącznik Optymalizuj. Wpisz Login name and API Passworduzyskane w poprzedniej sekcji, aby skonfigurować optymalizację źródła reklam dla:i-mobile. Następnie wpisz wartość eCPM dlai-mobile i kliknij Dalej.Jeśli masz już mapowanie i-mobile, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.
Następnie wpisz dane Publisher ID, Media ID and Spot IDotrzymane w poprzedniej sekcji. Następnie kliknij Gotowe.
Krok 3. Zaimportuj pakiet SDK i adapter i-mobile
Używanie CocoaPods (zalecane)
Dodaj ten wiersz do pliku Podfile projektu:
pod 'GoogleMobileAdsMediationIMobile'
W wierszu poleceń:
pod install --repo-update
Integracja ręczna
- Pobierz najnowszą wersję pakietu SDK i-mobile i połącz z nim
ImobileSdkAds.framework
w swoim projekcie. - Pobierz najnowszą wersję adaptera i-mobile, korzystając z linku pobierania w Dzienniku zmian, i połącz
IMobileAdapter.framework
w swoim projekcie.
Krok 4. Dodaj wymagany kod
Integracja SKAdNetwork
Postępuj zgodnie z dokumentacją i-mobile, aby dodać identyfikatory SKAdNetwork do pliku Info.plist
projektu.
Krok 5. Przetestuj implementację
Włącz reklamy testowe
Zarejestruj urządzenie testowe na potrzeby AdMob. i-mobile udostępnia testowe identyfikator Spotu, identyfikator mediów i identyfikator wydawcy na potrzeby testów. Znajdziesz je tutaj.
Weryfikacja reklam testowych
Aby sprawdzić, czy otrzymujesz reklamy testowe z witrynyi-mobile, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając z i-mobile (Waterfall) źródeł reklam.
Kroki opcjonalne:
Korzystanie z reklam natywnych
Renderowanie reklam
Adapter i-mobile wypełnia te
opisy pól zaawansowanych reklam natywnych
dla
GADNativeAd
Pole | Zasoby zawsze uwzględnione 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 zawiera komponentu z ikoną 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ć przyczynę błędu w odpowiedzi na żądanie reklamy, korzystając z elementu
GADResponseInfo.adNetworkInfoArray
w tych zajęciach:
Format | Nazwa zajęć |
---|---|
Baner | IMobileAdapter |
Pełnoekranowa | IMobileAdapter |
Natywna | GADMediationAdapterIMobile |
Oto kody i powiązane z nimi komunikaty wysyłane przez adapter i-mobile, gdy reklama się nie wczytuje:
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 w elemencie Activity , by wczytać reklamy. |
102 | Brakuje parametrów serwera i-mobile skonfigurowanych w interfejsie AdMob lub są one nieprawidłowe. |
103 | Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez i-mobile. |
104 | Wywołanie zwrotne wczytania reklamy natywnej i-mobile zwróciło pustą listę reklam natywnych. |
0-10 | Pakiet SDK i-mobile zwrócił błąd. Więcej informacji znajdziesz w kodzie. |
101 | Brakuje parametrów serwera i-mobile skonfigurowanych w interfejsie AdMob lub są one nieprawidłowe. |
102 | Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez i-mobile. |
103 | i-mobile nie udało się wyświetlić reklamy. |
104 | Usługa i-mobile zwróciła pustą tablicę reklam natywnych. |
105 | i-mobile nie udało się pobrać komponentów reklamy natywnej. |
106 | System i-mobile nie obsługuje żądania wielu reklam pełnoekranowych z użyciem tego samego identyfikatora Spota. |
Historia zmian adaptera zapośredniczenia na iOS i-mobile
Wersja 2.3.3.0
- Zweryfikowana zgodność z pakietem SDK i-mobile 2.3.3.
Stworzone i przetestowane w:
- Pakiet SDK do reklam mobilnych Google w wersji 11.1.0.
- i-mobile SDK w wersji 2.3.3.
Wersja 2.3.2.1
- Usunęliśmy wycofaną metodę przekazywania dostępu
willBackgroundApplication
z implementacji banerów, reklam pełnoekranowych i reklam natywnych. - Teraz wymagany jest iOS w wersji co najmniej 12.0.
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 11.0 lub nowszej.
- Uwzględniono
Info.plist
w ramach platformyIMobileAdapter.xcframework
.
Stworzone i przetestowane w:
- Pakiet SDK do reklam mobilnych Google w wersji 11.0.1.
- i-mobile SDK w wersji 2.3.2.
Wersja 2.3.2.0
- Zweryfikowana zgodność z pakietem SDK i-mobile 2.3.2.
- Usunięto obsługę architektury
armv7
. - Teraz wymagany jest iOS w wersji co najmniej 11.0.
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 10.4.0 lub nowszej.
Stworzone i przetestowane w:
- Pakiet SDK do reklam mobilnych Google w wersji 10.4.0.
- i-mobile SDK w wersji 2.3.2.
Wersja 2.3.1.0
- Zweryfikowana zgodność z pakietem SDK i-mobile 2.3.1.
Stworzone i przetestowane w:
- Pakiet SDK do reklam mobilnych Google w wersji 10.3.0.
- i-mobile SDK 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.
Stworzone i przetestowane w:
- Pakiet SDK do reklam mobilnych Google w wersji 10.0.0.
- i-mobile SDK w wersji 2.3.0.
Wersja 2.3.0.0
- Zweryfikowana zgodność z pakietem SDK i-mobile 2.3.0.
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 9.8.0 lub nowszej.
Stworzone i przetestowane w:
- Pakiet SDK do reklam mobilnych Google w wersji 9.13.0.
- i-mobile SDK 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.
Stworzone i przetestowane w:
- Pakiet SDK do reklam mobilnych Google w wersji 9.0.0.
- i-mobile SDK w wersji 2.2.0.
Wersja 2.2.0.0
- Zweryfikowana zgodność z pakietem SDK i-mobile w wersji 2.2.0.
Stworzone i przetestowane
- Pakiet SDK do reklam mobilnych Google w wersji 8.13.0.
- i-mobile SDK w wersji 2.2.0.
Wersja 2.1.0.1
- proste zależności od pakietu SDK do reklam mobilnych Google w wersji 8.0.0 lub nowszej.
Stworzone i przetestowane
- Pakiet SDK do reklam mobilnych Google w wersji 8.4.0.
- i-mobile SDK w wersji 2.1.0.
Wersja 2.1.0.0
- Zweryfikowana 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
.
Stworzone i przetestowane
- Pakiet SDK do reklam mobilnych Google w wersji 8.1.0.
- i-mobile SDK w wersji 2.1.0.
Wersja 2.0.33.1
- Dodaliśmy standardowe kody błędów i komunikaty o błędach adaptera.
- Adapter ogranicza teraz żądanie wielu reklam pełnoekranowych z użyciem tego samego identyfikatora Spota i-mobile.
- Adapter przekierowuje teraz wywołanie zwrotne
-nativeAdWillLeaveApplication:
po kliknięciu reklam natywnych. - Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 7.68.0 lub nowszej.
Stworzone i przetestowane
- Pakiet SDK do reklam mobilnych Google w wersji 7.68.0.
- i-mobile SDK w wersji 2.0.33.
Wersja 2.0.33.0
- Zweryfikowana 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.
- Teraz wymagany jest iOS w wersji co najmniej 9.0.
Stworzone i przetestowane
- Pakiet SDK do reklam mobilnych Google w wersji 7.65.0.
- i-mobile SDK w wersji 2.0.33.
Wersja 2.0.32.0
- Zweryfikowana 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.
- Dodaliśmy obsługę skalowania reklam w rozmiarach 320 x 50 i 320 x 100 w celu lepszego dopasowania reklam do rozmiarów żądań banerów adaptacyjnych.
- Usunięto obsługę architektury i386.
Stworzone i przetestowane
- Pakiet SDK do reklam mobilnych Google w wersji 7.60.0.
- i-mobile SDK w wersji 2.0.32.
Wersja 2.0.31.0
- Zweryfikowana zgodność z pakietem SDK i-mobile w wersji 2.0.31.
Stworzone i przetestowane
- Pakiet SDK do reklam mobilnych Google w wersji 7.53.1.
- i-mobile SDK w wersji 2.0.31.
Wersja 2.0.29.0
- Pierwsza wersja!
- Dodaliśmy obsługę banerów, reklam pełnoekranowych i reklam natywnych.
Stworzone i przetestowane
- Pakiet SDK do reklam mobilnych Google w wersji 7.52.0.
- pakiet SDK dla i-mobile w wersji 2.0.29.