Aby omawiać nasze usługi i przekazywać opinie na ich temat, dołącz do oficjalnego kanału AdMob na Discordzie na serwerze społeczności Google Ads i pomiarów.

Ta strona została przetłumaczona przez Cloud Translation API.

Integracja i-mobile z zapośredniczeniem

Z tego przewodnika dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z i-mobile przy użyciu mediacji AdMob, a także jak przeprowadzać integrację kaskadową. Wyjaśniamy w nim, jak dodać i-mobile do konfiguracji mediacji jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter i-mobile z aplikacją na iOS.

Interfejs panelu i-mobile używa japońskiego tekstu w przypadku etykiet, przycisków i opisów. 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 mediacji i-mobile ma te możliwości:

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

Wymagania

iOS w wersji 12.0 lub nowszej

Najnowszy pakiet SDK do reklam mobilnych Google
Zapoznaj się z przewodnikiem dla początkujących dotyczącym zapośredniczenia.

Krok 1. Skonfiguruj ustawienia w interfejsie i-mobile

Zarejestruj się lub zaloguj na swoje 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ę boksu reklamowego), 広告スポットサイズ (rozmiar boksu reklamowego) i inne szczegóły. Następnie kliknij przycisk 新規登録 (Sign up).

new_ad_spot_form

Nowe miejsce na reklamę jest gotowe. Aby wyświetlić szczegóły integracji, kliknij przycisk アプリ設定取得 (Get App settings).

ad_spot_list

Zanotuj パブリッシャーID (Publisher ID), メディアID (Media ID) i スポットID (Spot ID). Będziesz ich potrzebować później podczas konfigurowania i-mobile na potrzeby zapośredniczenia w interfejsie AdMob.

Aktualizowanie pliku app-ads.txt

Authorized Sellers for Apps (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 utracie przychodów z reklam, musisz wdrożyć plik app-ads.txt. Jeśli nie zostało to jeszcze zrobione, skonfiguruj plik app-ads.txt pod kątem aplikacji.

Aby wdrożyć app-ads.txt na urządzeniach i-mobile, zapoznaj się z odpowiedziami na najczęstsze pytania.

Krok 2. Skonfiguruj popyt i-mobile w interfejsie AdMob

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Musisz dodać i-mobile do konfiguracji mediacji w przypadku jednostki reklamowej.

Najpierw zaloguj się na konto AdMob. Następnie otwórz kartę Mediacja. Jeśli masz już grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, i przejdź do sekcji Dodawanie i-mobile jako źródła reklam.

Aby utworzyć nową grupę zapośredniczenia, kliknij Utwórz grupę zapośredniczenia.

Wpisz format reklamy i platformę, a potem kliknij Dalej.

Nadaj grupie zapośredniczenia nazwę i wybierz lokalizacje, na które chcesz kierować reklamy. Następnie ustaw stan grupy mediacyjnej na Włączona i kliknij Dodaj jednostki reklamowe.

Powiąż tę grupę zapośredniczenia z co najmniej jedną z dotychczasowych jednostek reklamowych AdMob. Następnie kliknij Gotowe.

Powinna wyświetlić się karta jednostek reklamowych z wybranymi jednostkami:

Dodawanie i-mobile jako źródła reklam

Na karcie Kaskadowe w sekcji Źródła reklam kliknij Dodaj źródło reklam.

Wybierz i-mobile i włącz przełącznik Optymalizuj. Wpisz nazwę logowania i hasło do interfejsu API uzyskane w poprzedniej sekcji, aby skonfigurować optymalizację źródła reklam i-mobile. Następnie wpisz wartość eCPM dla i-mobile i kliknij Dalej.

Jeśli masz już mapowanie dla i-mobile, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.

Następnie wpisz identyfikator wydawcy, identyfikator nośnika i identyfikator reklamy uzyskane w poprzedniej sekcji. Następnie kliknij Gotowe.

Uwaga: optymalizacja źródeł reklam potrzebuje kilku dni na zebranie wystarczającej ilości danych, aby dokładnie obliczać eCPM dla sieci zapośredniczenia. W tym czasie stan optymalizacji źródła reklam to PENDING, więc musisz ręcznie ustawić wartość eCPM dla sieci. Gdy tylko będzie można obliczyć eCPM, źródło reklam automatycznie zacznie aktualizować eCPM w Twoim imieniu.

Krok 3. Zaimportuj pakiet SDK i-mobile i adapter

Korzystanie z CocoaPods (zalecane)

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 go z projektem.ImobileSdkAds.framework
Pobierz najnowszą wersję adaptera i-mobile, korzystając z linku w sekcji Changelog, i połącz IMobileAdapter.framework w projekcie.

Krok 4. Dodaj wymagany kod

Integracja 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 AdMob. i-mobile udostępnia testowe identyfikatory Spota, identyfikatory multimedió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 opisy pól w reklamach natywnych w przypadku GADNativeAd:

Pole	Zasoby 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 komponentu 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 reklamę, korzystając z GADResponseInfo.adNetworkInfoArray w tych klasach:

Format	Nazwa zajęć
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 SDK i-mobile zwrócił błąd. Więcej informacji znajdziesz w sekcji kod.
101	Parametry serwera i-mobile skonfigurowane w interfejsie AdMob 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 na urządzeniu i-mobile.
104	i-mobile zwrócił 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 żądań dotyczących wielu reklam pełnoekranowych przy użyciu tego samego identyfikatora miejsca docelowego.

Historia zmian adaptera zapośredniczenia i-mobile na iOS