Integracja i-mobile z zapośredniczeniem

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 Ad Manager 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ę).

Uwaga: rejestracja w usłudze i-mobile musi zostać zatwierdzona. Po jego zatwierdzeniu możesz utworzyć Spot reklamowy.

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 Ad Manager .

Krok 2. Skonfiguruj oferty reklamowe i-mobile w Ad Manager interfejsie użytkownika

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Zaloguj się na konto Ad Managera.

Kliknij Wyświetlanie > Grupy zysku i kliknij przycisk Nowa grupa zysku.

Wpisz niepowtarzalną nazwę grupy zysku, ustaw Stan na Aktywna, wybierz Format reklamy, a jako Typ zasobów reklamowych wybierz Aplikacja mobilna. W sekcji Kierowanie > Zasoby reklamowe wybierz jednostkę reklamową w sekcjach 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 w przypadku usługii-mobile, możesz go wybrać. W przeciwnym razie kliknij Utwórz nowego partnera zysku.

Jako Sieć reklamowa wybierz i-mobile, wpisz niepowtarzalną nazwę i włącz Zapośredniczenie.

Włącz Automatyczne zbieranie danych i wpiszLogin name and API Password

Po wybraniu Partnera zysku wybierz Zapośredniczenie mobilne SDK jako typ integracji, iOS jako platformę i Aktywne jako stan. WpiszPublisher ID, Media ID and Spot ID uzyskane w poprzedniej sekcji. Następnie wpisz domyślną wartość CPM.

Gdy skończysz, u dołu strony kliknij Zapisz.

Uwaga: automatyczne zbieranie danych potrzebuje kilku dni na zebranie danych, zanim będzie mogło dokładnie obliczyć wartość dynamicznego CPM dla sieci zapośredniczenia. Gdy już obliczysz eCPM, zostanie on automatycznie zaktualizowany w Twoim imieniu.

Krok 3. Zaimportuj pakiet SDK i adapter i-mobile

Uwaga: niezintegrowanie zgodnej wersji pakietu i-mobile oraz pakietu SDK do reklam mobilnych Google może spowodować problemy z kompilacją.

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 Ad Manager. i-mobile udostępnia testowe identyfikator Spotu, identyfikator mediów i identyfikator wydawcy na potrzeby testów. Znajdziesz je tutaj.

Ważne: przed opublikowaniem aplikacji wyłącz tryb testowy Ad Manager ii-mobile .

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 pola 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

¹ 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 Ad Manager 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 Ad Manager 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 platformy IMobileAdapter.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.