Integracja i-mobile z zapośredniczeniem

Wybierz platformę: Android iOS Unity Flutter Android (starsza wersja)

Z tego przewodnika dowiesz się, jak za pomocą Google Mobile Ads SDK wczytywać i wyświetlać reklamy z i-mobile przy użyciu mediacji, w tym integracji kaskadowych. Wyjaśniamy w nim, jak dodać i-mobile do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i-mobile i adapter z aplikacją na iOS.

Interfejs panelu i-mobile używa japońskiego tekstu w etykietach, przyciskach i opisach. Zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. W opisach i instrukcjach w tym przewodniku etykiety i przyciski są jednak przetłumaczone, a ich angielskie odpowiedniki podano w nawiasach.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia i-mobile ma te funkcje:

Integracja
Określanie stawek
Kaskada
Formaty
Baner
Pełnoekranowa
Z nagrodą
Natywna

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź, czy:

  • iOS w wersji 13.0 lub nowszej.

Krok 1. Skonfiguruj ustawienia w interfejsie i-mobile

Zarejestruj się lub zaloguj się na 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 新規登録 (Zarejestruj się).

Aby utworzyć nowe miejsce reklamowe, wybierz aplikację na karcie サイト／アプリ管理 (Zarządzanie witryną/aplikacją).

Otwórz kartę 広告スポット管理 (Zarządzanie miejscami wyświetlania reklam) i kliknij przycisk 新規広告スポット (Nowe miejsce wyświetlania reklamy).

create_ad_spot

Następnie wypełnij formularz, podając 広告スポット名 (nazwę miejsca wyświetlania reklamy), 広告スポットサイズ (rozmiar miejsca wyświetlania reklamy) i inne szczegóły. Następnie kliknij przycisk 新規登録 (Sign up).

new_ad_spot_form

Twoje nowe miejsce wyświetlania reklamy jest gotowe. Aby wyświetlić szczegóły integracji, kliknij przycisk アプリ設定取得 (Get App settings).

ad_spot_list

Zanotuj パブリッシャーID (identyfikator wydawcy), メディアID (identyfikator multimediów) i スポットID (Spot ID). Te parametry będą potrzebne później podczas konfigurowania i-mobile na potrzeby zapośredniczenia w interfejsie Ad Managera.

Zaktualizuj plik app-ads.txt

Authorized Sellers for Apps (czyli plik app-ads.txt) to projekt IAB Tech Lab, który ma zagwarantować, że Twoje zasoby reklamowe w aplikacjach będą sprzedawane tylko w tych kanałach, na które wyrażasz zgodę. Aby zapobiec znacznej utracie przychodów z reklam, musisz wdrożyć plik app-ads.txt. Jeśli jeszcze tego nie zrobiono, utwórz plik app-ads.txt na potrzeby Ad Managera.

Aby wdrożyć app-ads.txt w i-mobile, zapoznaj się z najczęstszymi pytaniami.

Krok 2. Skonfiguruj oferty reklamowe i-mobile w interfejsie Ad Managera

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Zaloguj się na konto Ad Managera.

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

Wpisz unikalną nazwę grupy zysku, ustaw Stan na Aktywny, wybierz Format reklamy i ustaw Typ zasobów reklamowych na 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 dla i-mobile, możesz go wybrać. W przeciwnym razie kliknij Utwórz nowego partnera zysku.

Wybierz i-mobile jako sieć reklamową, wpisz unikalną nazwę i włącz zapośredniczenie.

Włącz Automatyczne zbieranie danych i wpisz Nazwę logowania oraz Hasło do interfejsu API.

Po wybraniu Partnera zysku wybierz Zapośredniczenie mobilne SDK jako Typ integracji, iOS jako Platformę i Aktywny jako Stan. Wpisz identyfikator wydawcy, identyfikator multimediów i identyfikator miejsca 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-mobile i adapter

Korzystanie z Swift Package Manager

Zanim przejdziesz dalej, musisz mieć minimalną obsługiwaną wersję adaptera 2.3.4.2.

Aby dodać zależność pakietu do projektu, wykonaj te czynności:

  1. W Xcode kliknij File (Plik) > Add Package Dependencies… (Dodaj zależności pakietów…).

  2. W wyświetlonym wierszu poleceń wyszukaj ten adres URL pakietu:

    https://github.com/googleads/googleads-mobile-ios-mediation-imobile.git

  3. W sekcji Reguła zależności wybierz Gałąź.

  4. W polu tekstowym wpisz main.

Korzystanie z CocoaPods

  • Dodaj do pliku Podfile projektu ten wiersz:

    pod 'GoogleMobileAdsMediationIMobile'

  • W wierszu poleceń uruchom:

    pod install --repo-update

Integracja ręczna

  • Pobierz najnowszą wersję pakietu SDK i-mobile i połącz ImobileSdkAds.framework w projekcie.
  • Pobierz najnowszą wersję adaptera i-mobile z linku pobierania w sekcji Dziennik zmian i połącz IMobileAdapter.framework w projekcie.

Krok 4. Dodaj wymagany kod

Wdrażanie 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 usłudze Ad Manager. i-mobile udostępnia testowe identyfikatory miejsca, identyfikatory mediów i identyfikatory wydawcy. Możesz je znaleźć 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 ze źródeł reklam i-mobile (kaskadowe).

Kroki opcjonalne:

Korzystanie z reklam natywnych

Renderowanie reklam

Adapter i-mobile wypełnia te pola w przypadku GADNativeAd:

Pole Komponenty 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 na żądanie reklamy, używając metody GADResponseInfo.adNetworkInfoArray w tych klasach:

Format Nazwa klasy
Baner IMobileAdapter
Pełnoekranowa IMobileAdapter
Natywna GADMediationAdapterIMobile

Oto kody i powiązane z nimi komunikaty, które adapter i-mobile wyświetla, gdy nie uda się wczytać reklamy:

Kod błędu Przyczyna
0-10 Pakiet SDK i-mobile zwrócił błąd. Więcej informacji znajdziesz w kodzie.
101 Parametry serwera i-mobile skonfigurowane w interfejsie Ad Managera są nieprawidłowe lub ich brakuje.
102 Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez i-mobile.
103 Sieć i-mobile nie wyświetliła reklamy.
104 i-mobile zwróciło pustą tablicę reklam natywnych.
105 Nie udało się pobrać komponentów reklamy natywnej z i-mobile.
106 i-mobile nie obsługuje wysyłania próśb o wiele reklam pełnoekranowych przy użyciu tego samego identyfikatora miejsca.
107 Filtruj żądania z ograniczeniem wiekowym w przypadku pakietu i-mobile SDK, ponieważ nie może on odbierać sygnałów dotyczących ograniczeń wiekowych.

Historia zmian adaptera zapośredniczenia i-mobile na iOS

Wersja 2.3.4.8

  • Zaktualizowano minimalną wersję iOS, aby złagodzić zależność od pakietu SDK do reklam mobilnych Google i umożliwić korzystanie z wersji podrzędnych.

Zaprojektowano i przetestowano z użyciem:

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

Wersja 2.3.4.7

  • Filtruj żądania z ograniczeniami wiekowymi dotyczące pakietu SDK i-mobile, gdy nowy parametr ageRestrictedTreatment ma wartość GADAgeRestrictedTreatmentChild.

Zbudowano i przetestowano z:

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

Wersja 2.3.4.6

  • Filtruj żądania objęte ograniczeniami wiekowymi w przypadku pakietu SDK i-mobile, ponieważ nie może on odbierać sygnałów objętych ograniczeniami wiekowymi.

Zaprojektowano i przetestowano z użyciem:

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

Wersja 2.3.4.5

  • Zaktualizowano zależność pakietu SDK do reklam mobilnych Google do wersji 13.0.0.

Zbudowano i przetestowano z:

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

Wersja 2.3.4.4

  • Zaktualizowano minimalną wersję iOS w CocoaPods do 13.0.

Zbudowano i przetestowano z:

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

Wersja 2.3.4.3

  • Poprawiono nazwy nagłówków frameworka i nagłówka nadrzędnego w pliku IMobileAdapter modulemap.

Zbudowano i przetestowano z:

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

Wersja 2.3.4.2

  • Teraz wymagany jest pakiet SDK do reklam mobilnych Google w wersji 12.0.0 lub nowszej.

Zbudowano i przetestowano z:

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

Wersja 2.3.4.1

  • Zaktualizowano CFBundleShortVersionString, aby zawierał 3 komponenty zamiast 4.

Zbudowano i przetestowano z:

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

Wersja 2.3.4.0

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

Zbudowano i przetestowano z:

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

Wersja 2.3.3.0

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

Zaprojektowano i przetestowano z użyciem:

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

Wersja 2.3.2.1

  • Usunęliśmy wycofaną metodę delegowania willBackgroundApplication z implementacji banerów, reklam pełnoekranowych i reklam natywnych.
  • Teraz wymagany jest system 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 platformach w ramach IMobileAdapter.xcframework.

Zaprojektowano i przetestowano z użyciem:

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

Wersja 2.3.2.0

  • Sprawdzona zgodność z pakietem i-mobile SDK w wersji 2.3.2.
  • Usunięto obsługę architektury armv7.
  • Teraz wymagany jest system iOS w wersji co najmniej 11.0.
  • Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 10.4.0 lub nowszej.

Zbudowano i przetestowano z:

  • 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 i-mobile SDK w wersji 2.3.1.

Zbudowano i przetestowano z:

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

Zbudowano i przetestowano z:

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

Wersja 2.3.0.0

  • Potwierdzona zgodność z pakietem i-mobile SDK w wersji 2.3.0.
  • Teraz wymagany jest pakiet SDK do reklam mobilnych Google w wersji 9.8.0 lub nowszej.

Zbudowano i przetestowano z:

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

Zbudowano i przetestowano z:

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

Wersja 2.2.0.0

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

Zaprojektowano i przetestowano przy użyciu

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

Wersja 2.1.0.1

  • Zmniejszono zależność od pakietu SDK do reklam mobilnych Google w wersji 8.0.0 lub nowszej.

Zaprojektowano i przetestowano przy użyciu

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

Wersja 2.1.0.0

  • thought 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 korzystał z formatu .xcframework.

Zaprojektowano i przetestowano przy użyciu

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

Wersja 2.0.33.1

  • Dodano standardowe kody błędów i komunikaty o błędach dotyczące adapterów.
  • Adapter ogranicza teraz żądania wielu reklam pełnoekranowych z użyciem tego samego identyfikatora i-mobile Spot ID.
  • Adapter przekazuje 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.

Zaprojektowano i przetestowano przy użyciu

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

Wersja 2.0.33.0

  • Sprawdzona 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 wymaga minimalnej wersji iOS 9.0.

Zbudowano i przetestowano z

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

Wersja 2.0.32.0

  • Sprawdzona 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 o wymiarach 320 x 50 i 320 x 100, aby lepiej pasowały do rozmiarów żądań banerów adaptacyjnych.
  • Usunięto obsługę architektury i386.

Zbudowano i przetestowano z

  • 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

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

Zbudowano i przetestowano z

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

Zbudowano i przetestowano z

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