Integracja i-mobile z zapośredniczeniem AdMob

Z tego przewodnika dowiesz się, jak używać pakietu Google Mobile Ads SDK for React Native do wczytywania i wyświetlania reklam z i-mobile za pomocą zapośredniczenia, co obejmuje integracje kaskadowe. Dowiesz się z niego, jak dodać i-mobile do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter i-mobile z aplikacją React Native.

Interfejs panelu i-mobile używa języka japońskiego 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 AdMob do i-mobile ma te funkcje:

Integracja
Określanie stawek
Kaskada
Formaty
Otwarcie aplikacji
Baner
Pełnoekranowa
Z nagrodą
Reklama pełnoekranowa z nagrodą
Rodzimy użytkownik

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te kwestie:

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.

Android

iOS

Wypełnij formularz i kliknij przycisk 新規登録 (Zarejestruj się).

Android

iOS

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

Android

iOS

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

new_ad_spot_form

Nowe miejsce wyświetlania reklamy jest gotowe. Aby wyświetlić szczegóły integracji, kliknij przycisk アプリ設定取得 (Pobierz ustawienia aplikacji).

ad_spot_list

Zanotuj wartości パブリッシャー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 AdMob.

Android

iOS

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 nie masz pliku app-ads.txt, skonfiguruj go pod kątem swojej aplikacji.

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

Krok 2. Skonfiguruj oferty reklamowe i-mobile w interfejsie AdMob

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Android

Instrukcje znajdziesz w kroku 2 w przewodniku dla Android.

iOS

Instrukcje znajdziesz w kroku 2 w przewodniku dla iOS.

Krok 3. Zaimportuj pakiet SDK i adapter i-mobile

W katalogu głównym projektu zainstaluj adapter zapośredniczenia Google Mobile Ads SDK for React Native dla i-mobile. Wykonaj te czynności:

  1. Skopiuj plik tar adaptera Google Mobile Ads SDK for React Native z katalogu gma-sdk-react-native/adapters/imobile/ do katalogu local_packages/ projektu. Jeśli nie masz folderu adapters, zapoznaj się z sekcją Wymagania wstępne.

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/imobile/gma-mediation-imobile-0.1.0.tgz local_packages/

    Zastąp EXTRACT_DIR ścieżką do katalogu, w którym zostało wyodrębnione archiwum.

  2. Zainstaluj pakiet adaptera za pomocą preferowanego systemu zarządzania pakietami:

    npm

    npm install ./local_packages/gma-mediation-imobile-0.1.0.tgz

    włóczka

    yarn add ./local_packages/gma-mediation-imobile-0.1.0.tgz

  3. Jeśli tworzysz aplikację na Androida, dodaj to repozytorium do pliku build.gradle w katalogu android projektu:

    repositories {
    google()
    mavenCentral()
    maven {
        url = uri("https://imobile.github.io/adnw-sdk-android")
    }
}

Krok 4. Wymagany dodatkowy kod

Android

Integracja z i-mobile nie wymaga dodatkowego kodu.

iOS

Integracja 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

Pamiętaj, aby zarejestrować urządzenie testowe w AdMob. i-mobile udostępnia testowe wartości Spot ID, Media ID i Publisher ID, które znajdziesz tutaj.

Sprawdzanie reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z i-mobile, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając ze źródeł reklam i-mobile (kaskada).

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 ResponseInfo w tych klasach:

Android

Format Nazwa klasy
Baner com.google.ads.mediation.imobile.IMobileAdapter
Pełnoekranowa com.google.ads.mediation.imobile.IMobileAdapter
Rodzimy użytkownik com.google.ads.mediation.imobile.IMobileMediationAdapter

iOS

Format Nazwa klasy
Baner IMobileAdapter
Pełnoekranowa IMobileAdapter
Rodzimy użytkownik GADMediationAdapterIMobile

Oto kody i towarzyszące im komunikaty, które adapter i-mobile wyświetla, gdy nie uda się wczytać reklamy:

Android

Kod błędu Przyczyna
0-99 Pakiet i-mobile SDK zwrócił błąd. Więcej informacji znajdziesz w kodzie.
101 i-mobile wymaga kontekstu Activity, aby wczytywać reklamy.
102 Parametry serwera i-mobile skonfigurowane w interfejsie AdMob są nieprawidłowe lub ich brakuje.
103 Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez i-mobile.
104 Wywołanie zwrotne i-mobile dotyczące udanego wczytania reklamy natywnej zwróciło pustą listę reklam natywnych.

iOS

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 AdMob są nieprawidłowe lub ich brakuje.
102 Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez i-mobile.
103 Sieci i-mobile nie udało się wyświetlić reklamy.
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 żądań wielu reklam pełnoekranowych z tym samym identyfikatorem miejsca.

Wersja 0.1.0

  • Pierwsza wersja.