Integracja i-mobile z zapośredniczeniem

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.

Interfejs panelu w 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 tłumaczone z odpowiednimi odpowiednikami w języku angielskim 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

Krok 1. Skonfiguruj ustawienia 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).

create_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ę).

new_ad_spot_form

Twój nowy miejsce na reklamę jest gotowy. Aby wyświetlić szczegóły integracji, kliknij przycisk アプリ設定取得 (Uzyskaj ustawienia aplikacji).

ad_spot_list

Zanotuj パブリッシャーID (identyfikator wydawcy), メディアID (identyfikator multimediów) i スポットID (identyfikator miejsca docelowego). Parametry te będą Ci potrzebne później, gdy skonfigurujesz i-mobile do mediowania 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 logowaniahasł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

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, MediaPublisher. 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 Komponent i-mobile zawsze zawiera te zasoby:
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 udało się 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 ramowych IMobileAdapter.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.
  • Pakiet SDK i-mobile w wersji 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.