Integracja i-mobile z zapośredniczeniem

W tym przewodniku dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z i-mobile za pomocą zapośredniczenia, integracji kaskadowych. Znajdziesz w nim informacje o tym, jak dodać i-mobile do konfiguracji pośrednictwa w przypadku danej jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter i-mobile z aplikacją 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,

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

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). Te parametry będą Ci potrzebne później, gdy skonfigurujesz i-mobile do mediacji w interfejsie Ad Managera.

Krok 2. Skonfiguruj popyt i-mobile w interfejsie Ad Manager

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 Targetowanie > Zasoby wybierz jednostkę reklamową w sekcji Zasoby reklamoweAplikacja 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 PlatformaAktywny 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

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 Spot ID, Media ID i Publisher ID. 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 w przypadku GADNativeAd.

Pole Zasoby 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  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 użytkownika Ad Manager 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:

  • 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:

  • 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:

  • 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 IMobileAdapter.xcframework.

Został opracowany i przetestowany z:

  • 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 co najmniej iOS 11.0.
  • Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 10.4.0 lub nowszej.

Został opracowany i przetestowany z:

  • 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:

  • 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:

  • 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:

  • 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:

  • 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.