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 za pomocą zapośredniczenia obejmującego integrację kaskadową. 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 AdMob do aplikacji 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 AdMob .

Krok 2. Skonfiguruj źródła ofert reklamowych i-mobile w AdMob interfejsie

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-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 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ę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ć błąd w odpowiedzi na reklamę, używając 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 AdMob 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 AdMob 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.