Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

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 tłumaczone, a w nawiasach podawane są ich angielskie odpowiedniki.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia i-mobile ma te możliwości:

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.

Najnowsza wersja Google Mobile Ads SDK.
Skonfiguruj mediację.

Krok 1. Skonfiguruj ustawienia w interfejsie i-mobile

Zarejestruj się lub zaloguj na konto i-mobile.

Dodaj aplikację do panelu i-mobile, klikając kartę サイト／アプリ管理 (Site/Application Management) i przycisk platformy aplikacji.

Wypełnij formularz i kliknij przycisk 新規登録 (Sign up).

Aby utworzyć nowe miejsce reklamowe, wybierz aplikację na karcie Zarządzanie witrynami/aplikacjami.

Otwórz kartę 広告スポット管理 (Ad Spot Management) i kliknij przycisk 新規広告スポット (New Ad Spot).

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.

Aktualizowanie pliku app-ads.txt

Plik Authorized Sellers for Apps 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 przypadku i-mobile, zapoznaj się z odpowiedziami na najczęstsze pytania.

Krok 2. Skonfiguruj popyt 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 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 nośnika i identyfikator reklamy uzyskane w poprzedniej sekcji. Następnie wpisz wartość domyślnego 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:

W Xcode kliknij kolejno File (Plik) > Add Package Dependencies... (Dodaj zależności pakietu…).

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

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

W sekcji Reguła zależności wybierz Gałąź.
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łączImobileSdkAds.framework go z projektem.
Pobierz najnowszą wersję adaptera i-mobile z linku do pobierania w sekcji Dziennik zmian i połącz IMobileAdapter.framework w projekcie.

Krok 4. Dodaj wymagany kod

Wdrażanie SKAdNetwork

Postępuj zgodnie z dokumentacją i-mobile, aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu.

Krok 5. Przetestuj implementację

Włączanie reklam testowych

Upewnij się, że zarejestrowano urządzenie testowe w Ad Managerze. 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 pojedynczych źródeł 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	¹.
Wezwanie do działania
Ocena w gwiazdkach
Sklep
Cena

¹ W przypadku reklam natywnych pakiet SDK i-mobile nie udostępnia 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ć podstawowy błąd w odpowiedzi na żądanie reklamy, korzystając z GADResponseInfo.adNetworkInfoArray w tych klasach:

Format	Nazwa klasy
Baner	IMobileAdapter
Pełnoekranowa	IMobileAdapter
Natywna	GADMediationAdapterIMobile

Oto kody i komunikaty wyświetlane przez adapter i-mobile, gdy nie uda się wczytać reklamy:

Kod błędu	Przyczyna
0-10	Pakiet i-mobile SDK 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	Rozmiar żądanej reklamy nie pasuje do rozmiaru banera obsługiwanego przez i-mobile.
103	Nie udało się wyświetlić reklamy w i-mobile.
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 objęte ograniczeniami wiekowymi w przypadku pakietu i-mobile SDK, ponieważ nie może on odbierać sygnałów objętych ograniczeniami wiekowymi.