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 platformy i-mobile przy użyciu zapośredniczenia orazintegracji kaskadowej. Dowiesz się z niego, jak dodać i-mobile do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet i adapter i-mobile z aplikacją iOS z aplikacją.

Etykiety, przyciski i opisy w interfejsie panelu i-mobile są zapisane w języku japońskim. Zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. W opisach i instrukcjach w tym przewodniku jednak etykiety i przyciski są tłumaczone z użyciem anglojęzycznych odpowiedników tych nazw w nawiasach.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia na urządzenia i-mobile:

Integracja
Ustalanie stawek
Wodospad
Formaty
Baner
Pełnoekranowa
Otrzymano
Natywna

Wymagania

  • Cel wdrożenia iOS w wersji 12.0 lub nowszej

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

create_ad_spot

Następnie wypełnij formularz, podając 広告ブッブシキ (nazwa miejsca reklamy), 広告すッブサイズ (rozmiar reklamy) i inne szczegóły. Następnie kliknij przycisk OPEN規登録 (Zarejestruj się).

new_ad_spot_form

Twoje nowe miejsce wyświetlania reklamy jest gotowe. Aby wyświetlić szczegóły jego integracji, kliknij przycisk アプ zespołami엔定取得 (Pobierz ustawienia aplikacji).

ad_spot_list

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 źródła ofert reklamowych i-mobile w Ad Manager interfejsie

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.

Krok 3. Zaimportuj pakiet SDK i-mobile Adapter i-mobile

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 go z usługą ImobileSdkAds.framework w swoim projekcie.
  • Pobierz najnowszą wersję adaptera i-mobile za pomocą linku pobierania w dzienniku zmian i dodaj link IMobileAdapter.framework w swoim projekcie.

Krok 4. Dodaj wymagany kod

Integracja SKAdNetwork

Wykonaj dokumentację i-mobile, by 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.

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ę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 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 za pomocą polecenia GADResponseInfo.adNetworkInfoArray w tych klasach:

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 nie uda się wczytać reklamy:

Kod błędu Przyczyna
0-99 Pakiet SDK i-mobile zwrócił błąd. Więcej informacji znajdziesz w opisie kodu.
101 Aby wczytywać reklamy, i-mobile wymaga kontekstu Activity.
102 Brak parametrów serwera i-mobile skonfigurowanych w Ad Manager interfejsie lub są one nieprawidłowe.
103 Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego na i-mobile.
104 Wywołanie zwrotne udanego wczytywania reklam natywnych i-mobile zwróciło pustą listę reklam natywnych.
0-10 Pakiet SDK i-mobile zwrócił błąd. Więcej informacji znajdziesz w opisie kodu.
101 Brak parametrów serwera i-mobile skonfigurowanych w Ad Manager interfejsie lub są one nieprawidłowe.
102 Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego na i-mobile.
103 i-mobile nie wyświetliła reklamy.
104 Usługa i-mobile zwróciła pustą tablicę reklam natywnych.
105 Usługa i-mobile nie mogła pobrać zasobów reklamy natywnej.
106 Usługa i-mobile nie obsługuje żądania pobrania wielu reklam pełnoekranowych z tym samym identyfikatorem Spota.

i-mobile iOS Mediation Adapter Adapter

Wersja 2.3.4.0

  • Zweryfikowano zgodność z pakietem SDK i-mobile 2.3.4.
  • Dodano obsługę zwracania wersji pakietu SDK i-mobile w komponencie adSDKVersion.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 11.2.0.
  • SDK i-mobile w wersji 2.3.4.

Wersja 2.3.3.0

  • Zweryfikowano zgodność z pakietem SDK i-mobile 2.3.3.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 11.1.0.
  • SDK i-mobile w wersji 2.3.3.

Wersja 2.3.2.1

  • Z implementacji banerów, reklam pełnoekranowych i reklam natywnych usunęliśmy wycofaną metodę przekazywania uprawnień willBackgroundApplication.
  • Teraz wymaga to systemu iOS w wersji co najmniej 12.0.
  • Teraz wymaga pakietu SDK do reklam mobilnych Google w wersji 11.0 lub nowszej.
  • Uwzględniono Info.plist w platformach IMobileAdapter.xcframework.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 11.0.1.
  • SDK i-mobile w wersji 2.3.2.

Wersja 2.3.2.0

  • Zweryfikowano zgodność z pakietem SDK i-mobile 2.3.2.
  • Usunięto obsługę architektury armv7.
  • Teraz wymaga to systemu iOS w wersji co najmniej 11.0.
  • Teraz wymaga pakietu SDK do reklam mobilnych Google w wersji 10.4.0 lub nowszej.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 10.4.0.
  • SDK i-mobile w wersji 2.3.2.

Wersja 2.3.1.0

  • Zweryfikowano zgodność z pakietem SDK i-mobile 2.3.1.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 10.3.0.
  • SDK i-mobile w wersji 2.3.1.

Wersja 2.3.0.1

  • Teraz wymaga pakietu SDK do reklam mobilnych Google w wersji 10.0.0 lub nowszej.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 10.0.0.
  • SDK i-mobile w wersji 2.3.0.

Wersja 2.3.0.0

  • Zweryfikowano zgodność z pakietem SDK i-mobile 2.3.0.
  • Teraz wymaga pakietu SDK do reklam mobilnych Google w wersji 9.8.0 lub nowszej.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 9.13.0.
  • SDK i-mobile w wersji 2.3.0.

Wersja 2.2.0.1

  • Teraz wymaga pakietu SDK do reklam mobilnych Google w wersji 9.0.0 lub nowszej.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 9.0.0.
  • SDK i-mobile w wersji 2.2.0.

Wersja 2.2.0.0

  • Zweryfikowano zgodność z pakietem SDK i-mobile w wersji 2.2.0.

Stworzone i przetestowane przy użyciu

  • Pakiet SDK do reklam mobilnych Google w wersji 8.13.0.
  • SDK i-mobile w wersji 2.2.0.

Wersja 2.1.0.1

  • Łagodzenie uzależnienia od pakietu SDK do reklam mobilnych Google w wersji 8.0.0 lub nowszej.

Stworzone i przetestowane przy użyciu

  • Pakiet SDK do reklam mobilnych Google w wersji 8.4.0.
  • SDK i-mobile w wersji 2.1.0.

Wersja 2.1.0.0

  • Zweryfikowano zgodność z pakietem SDK i-mobile w wersji 2.1.0.
  • Teraz wymaga pakietu SDK do reklam mobilnych Google w wersji 8.1.0 lub nowszej.
  • Zaktualizowano adapter, aby używał formatu .xcframework.

Stworzone i przetestowane przy użyciu

  • Pakiet SDK do reklam mobilnych Google w wersji 8.1.0.
  • SDK i-mobile w wersji 2.1.0.

Wersja 2.0.33.1

  • Dodaliśmy ujednolicone kody błędów i komunikaty o błędach adaptera.
  • Obecnie Adapter ogranicza żądanie wielu reklam pełnoekranowych z tym samym identyfikatorem Spotu i-mobile.
  • Adapter przekierowuje teraz wywołanie zwrotne -nativeAdWillLeaveApplication: po kliknięciu reklamy natywnej.
  • Teraz wymaga pakietu SDK do reklam mobilnych Google w wersji 7.68.0 lub nowszej.

Stworzone i przetestowane przy użyciu

  • Pakiet SDK do reklam mobilnych Google w wersji 7.68.0.
  • SDK i-mobile w wersji 2.0.33.

Wersja 2.0.33.0

  • Zweryfikowano zgodność z pakietem SDK i-mobile w wersji 2.0.33.
  • Teraz wymaga pakietu SDK do reklam mobilnych Google w wersji 7.65.0 lub nowszej.
  • Teraz wymaga to systemu iOS w wersji co najmniej 9.0.

Stworzone i przetestowane przy użyciu

  • Pakiet SDK do reklam mobilnych Google w wersji 7.65.0.
  • SDK i-mobile w wersji 2.0.33.

Wersja 2.0.32.0

  • Zweryfikowano zgodność z pakietem SDK i-mobile w wersji 2.0.32.
  • Teraz wymaga pakietu SDK do reklam mobilnych Google w wersji 7.60.0 lub nowszej.
  • Dodaliśmy obsługę skalowania reklam o wymiarach 320 x 50 i 320 x 100, aby lepiej pasowały do żądań banerów adaptacyjnych.
  • Zakończyliśmy obsługę architektury i386.

Stworzone i przetestowane przy użyciu

  • Pakiet SDK do reklam mobilnych Google w wersji 7.60.0.
  • SDK i-mobile w wersji 2.0.32.

Wersja 2.0.31.0

  • Zweryfikowano zgodność z pakietem SDK i-mobile w wersji 2.0.31.

Stworzone i przetestowane przy użyciu

  • Pakiet SDK do reklam mobilnych Google w wersji 7.53.1.
  • 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 natywnych.

Stworzone i przetestowane przy użyciu

  • Pakiet SDK do reklam mobilnych Google w wersji 7.52.0.
  • SDK i-mobile w wersji 2.0.29.